建立CEV

焦點模式

建立CEV - Amazon Relational Database Service

您可以使用 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

登入 AWS Management Console 並在開啟 Amazon RDS主控台https://console.aws.amazon.com/rds/。
在導覽窗格中，選擇 Custom engine versions (自訂引擎版本)。

自訂引擎版本頁面會顯示目前存在的所有CEVs項目。如果您尚未建立任何 CEVs，則頁面為空白。
選擇 Create custom engine version (建立自訂引擎版本)。
在引擎選項中，執行下列動作：
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. 在引擎版本中，選擇主要引擎版本。
在版本詳細資訊中，執行下列動作：
1. 在自訂引擎版本名稱中輸入有效名稱。例如，您輸入名稱 19.cdb_cev1。
2. （選用）輸入的描述CEV。
在安裝媒體中，執行下列動作：
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單。
在KMS金鑰區段中，選取輸入金鑰ARN以列出可用的 AWS KMS 金鑰。然後從清單中選取您的KMS金鑰。

RDS 自訂需要 AWS KMS 金鑰。如需詳細資訊，請參閱步驟 1：建立或重複使用對稱加密 AWS KMS 金鑰。
（選用）選擇新增標籤，為您的建立鍵/值對CEV。
選擇 Create custom engine version (建立自訂引擎版本)。

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

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

主控台

建立 CEV

登入 AWS Management Console 並在開啟 Amazon RDS主控台https://console.aws.amazon.com/rds/。
在導覽窗格中，選擇 Custom engine versions (自訂引擎版本)。

自訂引擎版本頁面會顯示目前存在的所有CEVs項目。如果您尚未建立任何 CEVs，則頁面為空白。
選擇 Create custom engine version (建立自訂引擎版本)。
在引擎選項中，執行下列動作：
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. 在引擎版本中，選擇主要引擎版本。
在版本詳細資訊中，執行下列動作：
1. 在自訂引擎版本名稱中輸入有效名稱。例如，您輸入名稱 19.cdb_cev1。
2. （選用）輸入的描述CEV。
在安裝媒體中，執行下列動作：
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單。
在KMS金鑰區段中，選取輸入金鑰ARN以列出可用的 AWS KMS 金鑰。然後從清單中選取您的KMS金鑰。

RDS 自訂需要 AWS KMS 金鑰。如需詳細資訊，請參閱步驟 1：建立或重複使用對稱加密 AWS KMS 金鑰。
（選用）選擇新增標籤，為您的建立鍵/值對CEV。
選擇 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,
...

AWS CLI

若要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自訂引擎版本建立進行故障診斷。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

準備建立 CEV

修改 CEV 狀態

在本頁面

選取您的 Cookie 偏好設定

自訂 Cookie 偏好設定

必要

效能

功能

廣告

無法儲存 Cookie 偏好設定

建立CEV

注意

建立 CEV

注意

注意

主控台

建立 CEV

注意

注意

AWS CLI

無法建立 CEV

在本頁面

Related resources

此頁面是否有幫助？

Related resources

下一個主題：

上一個主題：

需要協助？