建立 CEV - Amazon Relational Database Service
無法建立 CEV

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

建立 CEV

您可以使用 AWS Management Console 或 AWS CLI 建立 CEV。指定多租戶或非多租戶架構。如需更多詳細資訊，請參閱 多租戶架構考量。

一般而言，建立 CEV 大約需要兩個小時。在建立 CEV 之後，您可以使用它來建立或更新 RDS Custom 資料庫執行個體。如需詳細資訊，請參閱建立 RDS Custom for Oracle 資料庫執行個體及升級 RDS Custom for Oracle 資料庫執行個體。

注意

如果您的資料庫執行個體目前使用 Oracle Linux 7.9，請建立使用最新 AMI 的新 CEV，這會使用 Oracle Linux 8。然後修改執行個體以使用新的 CEV。

請注意建立 CEV 的下列要求和限制：

  • 包含您的安裝檔案的 Amazon S3 儲存貯體必須位於與您的 CEV 相同的 AWS 區域 中。否則，建立程序會失敗。

  • CEV 名稱的格式必須是 major-engine-version.customized_string，如 19.cdb_cev1 中所示。

  • CEV 名稱必須包含 1 到 50 個英數字元、底線、破折號或句點。

  • CEV 名稱不能包含連續的句點，如 19..cdb_cev1 中所示。

若要建立 CEV

  1. 登入 AWS Management Console，開啟位於 https://console.aws.amazon.com/rds/ 的 Amazon RDS 主控台。

  2. 在導覽窗格中，選擇 Custom engine versions (自訂引擎版本)。

    Custom engine versions (自訂引擎版本) 頁面會顯示目前存在的所有 CEV。如果您尚未建立任何 CEV，則頁面為空白。

  3. 選擇 Create custom engine version (建立自訂引擎版本)。

  4. 在引擎選項中，執行下列動作：

    1. 針對 Engine type (引擎類型)，請選擇 Oracle。

    2. 對於架構設定，選擇性地選擇多租用戶架構以建立 Oracle 多租用戶 CEV，這會使用資料庫引擎 custom-oracle-ee-cdb 或 custom-oracle-se2-cdb。您只能使用多租戶 CEV 建立 RDS Custom for Oracle CDB。如果未選擇此選項，您的 CEV 是使用引擎 custom-oracle-ee 或 custom-oracle-se2 的非 CDB。

      注意

      您選擇的架構是 CEV 的永久特性。您無法將 CEV 修改為稍後使用不同的架構。

    3. 請選擇下列其中一個選項：

      • 建立新 CEV - 從頭開始建立 CEV。在此情況下，您必須指定 JSON 清單檔案，其會指定資料庫二進位檔案。

      • 從來源建立 CEV - 在指定要複製的 CEV 中，選擇要用作來源 CEV 的現有 CEV。在此情況下，您可以指定新的 Amazon Machine Image (AMI)，但無法指定不同的資料庫二進位檔案。

    4. 在引擎版本中，選擇主要引擎版本。

  5. 在版本詳細資訊中，執行下列動作：

    1. 在自訂引擎版本名稱中輸入有效名稱。例如，您輸入名稱 19.cdb_cev1。

    2. (選用) 輸入 CEV 的描述。

  6. 在安裝媒體中，執行下列動作：

    1. (選用) 針對 AMI ID，將欄位保留空白以使用最新服務提供的 AMI，或輸入您先前用來建立 CEV 的 AMI。若要取得有效的 AMI ID，請使用下列任一技巧：

      • 在主控台中，選擇左側導覽窗格中的自訂引擎版本，然後選擇 CEV 的名稱。CEV 使用的 AMI ID 會出現在組態索引標籤中。

      • 在 AWS CLI 中，使用 describe-db-engine-versions 命令。搜尋輸出找出 ImageID。

    2. 針對 S3 location of manifest files (資訊清單檔案的 S3 位置)，輸入您在 步驟 3：將您的安裝檔案上傳到 Amazon S3 中指定之 Amazon S3 儲存貯體的位置。例如，​輸入 s3://my-custom-installation-files/123456789012/cev1/。

      注意

      您在其中建立 CEV 的 AWS 區域必須位於與 S3 儲存貯體相同的區域中。

    3. (僅建立新的 CEV) 對於 CEV 清單檔案，輸入您已在 建立 CEV 資訊清單 建立的 JSON 清單檔案。

  7. 在 KMS 金鑰區段中，選取輸入金鑰 ARN 以列出可用的 AWS KMS 金鑰。然後從清單選取 KMS 金鑰。

    RDS Custom 需要 AWS KMS 金鑰。如需更多詳細資訊，請參閱 步驟 1：建立或重複使用對稱加密 AWS KMS 金鑰。

  8. (選用) 選擇新增標籤，為 CEV 建立鍵值組。

  9. 選擇 Create custom engine version (建立自訂引擎版本)。

    如果 JSON 清單檔案的格式無效，主控台會顯示驗證 CEV 清單檔案時發生錯誤。修正問題，然後重試。

Custom engine versions (自訂引擎版本) 頁面隨即出現。您的 CEV 會顯示狀態 Creating (正在建立)。建立 CEV 的程序大約需要兩個小時。

若要使用 AWS CLI 建立 CEV，請執行 create-custom-db-engine-version 命令。

下列選項是必要的：

  • --engine – 指定引擎類型。對於 CDB，指定 custom-oracle-ee-cdb 或 custom-oracle-se2-cdb。對於非 CDB，指定 custom-oracle-ee 或 custom-oracle-se2。您只能從使用 custom-oracle-ee-cdb 或 custom-oracle-se2-cdb 建立的 CEV 建立 CDB。您只能從使用 custom-oracle-ee 或 custom-oracle-se2 建立的 CEV 建立非 CDB。

  • --engine-version - 指定引擎版本。格式是 major-engine-version.customized_string。CEV 名稱必須包含 1 到 50 個英數字元、底線、破折號或句點。CEV 名稱不能包含連續的句點，如 19..cdb_cev1 中所示。

  • --kms-key-id – 指定 AWS KMS key。

  • --manifest – 指定 manifest_json_string 或 --manifest file:file_name。manifest_json_string 中不允許換行字元。請務必轉義 JSON 程式碼中的雙引號 (")，方法是在引號前加上反斜杠 (\)。

    下列範例為 19c 顯示了來自 步驟 5：準備 CEV 清單檔案 的 manifest_json_string。此範例會針對 Oracle 基本目錄、Oracle 主目錄，以及 UNIX/Linux 使用者和群組的識別符和名稱設定新值。如果您複製此字串，請在將其貼到命令之前移除所有換行字元。

    "{\"mediaImportTemplateVersion\": \"2020-08-14\",\"databaseInstallationFileNames\": [\"V982063-01.zip\"],\"opatchFileNames\": [\"p6880880_190000_Linux-x86-64.zip\"],\"psuRuPatchFileNames\": [\"p32126828_190000_Linux-x86-64.zip\"],\"otherPatchFileNames\": [\"p29213893_1910000DBRU_Generic.zip\",\"p29782284_1910000DBRU_Generic.zip\",\"p28730253_190000_Linux-x86-64.zip\",\"p29374604_1910000DBRU_Linux-x86-64.zip\",\"p28852325_190000_Linux-x86-64.zip\",\"p29997937_190000_Linux-x86-64.zip\",\"p31335037_190000_Linux-x86-64.zip\",\"p31335142_190000_Generic.zip\"]\"installationParameters\":{ \"unixGroupName\":\"dba\", \ \"unixUname\":\"oracle\", \ \"oracleHome\":\"/home/oracle/oracle.19.0.0.0.ru-2020-04.rur-2020-04.r1.EE.1\", \ \"oracleBase\":\"/home/oracle/\"}}"

  • --database-installation-files-s3-bucket-name - 指定您已在 步驟 3：將您的安裝檔案上傳到 Amazon S3 中指定的相同儲存貯體名稱。您在其中執行 create-custom-db-engine-version 的 AWS 區域必須是與您的 Amazon S3 儲存貯體相同的區域。

您還可以指定下列選項：

  • --description - 指定 CEV 的描述。

  • --database-installation-files-s3-prefix - 指定您已在 步驟 3：將您的安裝檔案上傳到 Amazon S3 中指定的資料夾名稱。

  • --image-id - 指定要重複使用的 AMI ID。若要尋找有效的 ID，請執行 describe-db-engine-versions 命令，然後搜尋輸出找出 ImageID。根據預設，RDS Custom for Oracle 會使用最新的可用 AMI。

下列範例會建立名為 19.cdb_cev1 的 Oracle 多租戶 CEV。此範例會重複使用現有的 AMI，而不是使用最新的可用 AMI。請確保 CEV 的名稱以主要引擎版本號為開頭。

對於 Linux、macOS 或 Unix：

aws rds create-custom-db-engine-version \
    --engine custom-oracle-se2-cdb \
    --engine-version 19.cdb_cev1 \
    --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files \
    --database-installation-files-s3-prefix 123456789012/cev1 \
    --kms-key-id my-kms-key \
    --description "test cev" \
    --manifest manifest_string \
    --image-id ami-012a345678901bcde

在 Windows 中：

aws rds create-custom-db-engine-version ^
    --engine custom-oracle-se2-cdb ^
    --engine-version 19.cdb_cev1 ^
    --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files ^
    --database-installation-files-s3-prefix 123456789012/cev1 ^
    --kms-key-id my-kms-key ^
    --description "test cev" ^
    --manifest manifest_string ^
    --image-id ami-012a345678901bcde

使用 describe-db-engine-versions 命令取得 CEV 的詳細資訊。

aws rds describe-db-engine-versions \
    --engine custom-oracle-se2-cdb \
    --include-all

下列部分輸出顯示引擎、參數群組、清單檔案，以及其他資訊。

{
    "DBEngineVersions": [
        {
            "Engine": "custom-oracle-se2-cdb",
            "EngineVersion": "19.cdb_cev1",
            "DBParameterGroupFamily": "custom-oracle-se2-cdb-19",
            "DBEngineDescription": "Containerized Database for Oracle Custom SE2",
            "DBEngineVersionDescription": "test cev",
            "Image": {
                "ImageId": "ami-012a345678901bcde",
                "Status": "active"
            },
            "ValidUpgradeTarget": [],
            "SupportsLogExportsToCloudwatchLogs": false,
            "SupportsReadReplica": true,
            "SupportedFeatureNames": [],
            "Status": "available",
            "SupportsParallelQuery": false,
            "SupportsGlobalDatabases": false,
            "MajorEngineVersion": "19",
            "DatabaseInstallationFilesS3BucketName": "us-east-1-123456789012-custom-installation-files",
            "DatabaseInstallationFilesS3Prefix": "123456789012/cev1",
            "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:custom-oracle-se2-cdb/19.cdb_cev1/abcd12e3-4f5g-67h8-i9j0-k1234l56m789",
            "KMSKeyId": "arn:aws:kms:us-east-1:732027699161:key/1ab2345c-6d78-9ef0-1gh2-3456i7j89k01",
            "CreateTime": "2023-03-07T19:47:58.131000+00:00",
            "TagList": [],
            "SupportsBabelfish": false,
...

無法建立 CEV

如果 CEV 建立的程序失敗，會發生 RDS Custom 問題 RDS-EVENT-0198 並且有訊息 Creation failed for custom engine version major-engine-version.cev_name，其中包含失敗的詳細資訊。例如，事件會列印遺失的檔案。

您無法修改失敗的 CEV。您只能刪除它，然後在修正失敗原因之後再試一次建立 CEV。如需有關 CEV 建立失敗原因進行疑難排解的詳細資訊，請參閱 針對 RDS Custom for Oracle 的自訂引擎版本建立進行故障診斷。