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

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

建立CEV

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

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

注意

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

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

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

  • 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 (自訂引擎版本)。

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

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

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

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

    2. 對於架構設定，選擇性地選擇多租戶架構來建立 Oracle 多租戶 CEV，其使用資料庫引擎custom-oracle-ee-cdb或 custom-oracle-se2-cdb。CEV 您只能CDB使用多租戶建立 RDS Custom for Oracle。如果您未選擇此選項，您的 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，或輸入您先前用來建立 AMI的 CEV。若要取得有效的 AMI IDs，請使用下列任一技術：

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

      • 在 中 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資訊清單，輸入您在 中建立的資訊JSON清單創建清CEV單。

  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 會顯示 狀態建立。建立 的程序大約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。CDBs 您只能從使用 custom-oracle-ee-cdb或 CEV建立的 建立custom-oracle-se2-cdb。您只能從使用 custom-oracle-ee或 CEV建立的 建立非CDBs custom-oracle-se2。

  • --engine-version - 指定引擎版本。格式為 major-engine-versioncustomized_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 使用者和群組的 ID 和名稱的新值。如果您複製此字串，請先移除所有新行字元，再將其貼到您的命令中。

    "{\"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 中指定的相同儲存貯體名稱。您執行 AWS 區域 的 create-custom-db-engine-version必須與 Amazon S3 儲存貯體所在的區域相同。

您還可以指定下列選項：

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

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

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

下列範例會建立CEV名為 的 Oracle 多租戶19.cdb_cev1。此範例會重複使用現有的 ，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

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

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自訂訊息 RDS-EVENT-0198的問題Creation failed for custom engine version major-engine-version.cev_name，並包含失敗的詳細資訊。例如，事件會列印遺失的檔案。

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