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

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

建立 CEV

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

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

請注意下列建立 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 並開啟 Amazon RDS 主控台，網址為 https://console.aws.amazon.com/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 是非 CDB，它使用引擎或. custom-oracle-ee custom-oracle-se2

      注意

      您選擇的架構是 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/。

      注意

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

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

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

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

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

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

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

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

若要使用建立 CEV AWS CLI，請執行 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用或建立的 CEV 建立 CDB。custom-oracle-se2-cdb您只能從使用或建立的 CEV 建立非 CDB。custom-oracle-ee custom-oracle-se2

  • --engine-version - 指定引擎版本。格式為major-engine-version。 自訂字串。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必須與 Amazon S3 儲存貯體所 AWS 區域 在的區域相同。

您還可以指定下列選項：

  • --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 的名稱以主要引擎版本號為開頭。

對於LinuxmacOS、或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 的自訂引擎版本建立進行疑難排解。