

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

# 建立 RDS Custom for SQL Server 的 CEV
<a name="custom-cev-sqlserver.create"></a>

您可以使用 AWS 管理主控台 或 AWS CLI 建立自訂引擎版本 (CEV)。然後，您可以使用 CEV 建立 RDS Custom for SQL Server 資料庫執行個體。

請確定 Amazon Machine Image (AMI) 位於與 CEV 相同的 AWS 帳戶和區域中。否則，建立 CEV 的程序會失敗。

如需更多詳細資訊，請參閱 [建立並連線至 Amazon RDS Custom for SQL Server 的資料庫執行個體](custom-creating-sqlserver.md)。

**重要**  
對於使用預先安裝型 SQL Server 建立的 AMI 與使用自有媒體 (BYOM) 建立的 AMI，兩者建立 CEV 的步驟皆為相同。

## 主控台
<a name="custom-cev-sqlserver.create.console"></a>

**若要建立 CEV**

1. 登入 AWS 管理主控台，開啟位於 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) 的 Amazon RDS 主控台。

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

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

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

1. 針對 **Engine type** (引擎類型) 中，選擇 **Microsoft SQL Server**。

1. 針對**版本**，選擇您想要使用的資料庫引擎版本。

1. 針對 **Major version** (主要版本)，選擇您 AMI 上安裝的主要引擎版本。

1. 在 **Version details** (版本詳細資訊) 的 **Custom engine version name** (自訂引擎版本名稱) 中輸入有效名稱。

   名稱格式為 `major-engine-version.minor-engine-version.customized_string`。您可以使用 1–50 個英數字元、字元、底線、破折號和句點。例如，您輸入名稱 **15.00.4249.2.my\$1cevtest**。

   選擇性輸入 CEV 的描述。

1. 針對 **Installation Media** (安裝媒體)，瀏覽或輸入您要從中建立 CEV 的 AMI ID。

1. 在 **Tags** (標籤) 區段中，新增任何標籤以識別 CEV。

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

**Custom engine versions** (自訂引擎版本) 頁面隨即出現。即會顯示您的 CEV，狀態為 **pending-validation**

## AWS CLI
<a name="custom-cev-sqlserver.create.CEV"></a>

若要使用 AWS CLI 建立 CEV，請執行 [create-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html) 命令。

下列選項是必要的：
+ `--engine`
+ `--engine-version`
+ `--image-id`

您還可以指定下列選項：
+ `--description`
+ `--region`
+ `--tags`

以下範例會建立名為 `15.00.4249.2.my_cevtest` 的 CEV。請確保 CEV 的名稱以主要引擎版本號碼為開頭。

**Example**  
對於 Linux、macOS 或 Unix：  

```
1. aws rds create-custom-db-engine-version \
2.     --engine custom-sqlserver-ee \
3.     --engine-version 15.00.4249.2.my_cevtest \
4.     --image-id ami-0r93cx31t5r596482 \                    
5.     --description "Custom SQL Server EE 15.00.4249.2 cev test"
```
下列部分輸出顯示引擎、參數群組及其他資訊。  

```
 1. "DBEngineVersions": [
 2.     {
 3.     "Engine": "custom-sqlserver-ee",
 4.     "MajorEngineVersion": "15.00",
 5.     "EngineVersion": "15.00.4249.2.my_cevtest",
 6.     "DBEngineDescription": "Microsoft SQL Server Enterprise Edition for RDS Custom for SQL Server",
 7.     "DBEngineVersionArn": "arn:aws:rds:us-east-1:<my-account-id>:cev:custom-sqlserver-ee/15.00.4249.2.my_cevtest/a1234a1-123c-12rd-bre1-1234567890",
 8.     "DBEngineVersionDescription": "Custom SQL Server EE 15.00.4249.2 cev test",
 9.                                                       
10.     "Image": [
11.         "ImageId": "ami-0r93cx31t5r596482",
12.         "Status": "pending-validation"
13.      ],
14.     "CreateTime": "2022-11-20T19:30:01.831000+00:00",
15.     "SupportsLogExportsToCloudwatchLogs": false,
16.     "SupportsReadReplica": false,
17.     "Status": "pending-validation",
18.     "SupportsParallelQuery": false,
19.     "SupportsGlobalDatabases": false,
20.     "TagList": []
21.     }
22. ]
```

如果建立 CEV 的程序失敗，RDS Custom for SQL Server 會發出 `RDS-EVENT-0198`，訊息為 `Creation failed for custom engine version major-engine-version.cev_name`。該訊息包含有關故障的詳細資訊，例如事件列印遺失的檔案。若要尋找 CEV 建立問題的疑難排解想法，請參閱 [針對 RDS Custom for SQL Server 的 CEV 錯誤進行疑難排解](custom-troubleshooting-sqlserver.md#custom-troubleshooting-sqlserver.cev)。

## 從 CEV 建立 RDS Custom for SQL Server 資料庫執行個體
<a name="custom-cev-sqlserver.create.newdbinstance"></a>

成功建立 CEV 後，**CEV status** (CEV 狀態) 會顯示 `pending-validation`。您現在可以使用 CEV 建立新的 RDS Custom for SQL Server 資料庫執行個體。若要從 CEV 建立新的 RDS Custom for SQL Server 資料庫執行個體，請參閱 [建立 RDS Custom for SQL Server 資料庫執行個體](custom-creating-sqlserver.md#custom-creating-sqlserver.create)。

## CEV 的生命週期
<a name="custom-cev-sqlserver.create.lifecycle"></a>

CEV 生命週期包含下列狀態。


****  

| CEV 狀態 | 描述 | 故障診斷建議 | 
| --- | --- | --- | 
| `pending-validation` | 已建立 CEV，且其正在等待相關聯 AMI 的驗證。CEV 會保留在 `pending-validation` 中，直到從中建立了 RDS Custom for SQL Server 資料庫執行個體為止。 | 如果沒有現有的任務，請從 CEV 建立新的 RDS Custom for SQL Server 資料庫執行個體。建立 RDS Custom for SQL Server 資料庫執行個體時，系統會嘗試驗證 CEV 的相關聯 AMI。  | 
| `validating` | 基於新 CEV 的 RDS Custom for SQL Server 資料庫執行個體的建立任務正在進行中。建立 RDS Custom for SQL Server 資料庫執行個體時，系統會嘗試驗證 CEV 的相關聯 AMI。 | 等待現有 RDS Custom for SQL Server 資料庫執行個體的建立任務完成。您可以使用 RDS EVENTS 主控台，檢閱詳細的事件訊息以進行疑難排解。  | 
| `available` | 已成功驗證 CEV。一旦成功從 CEV 建立了 RDS Custom for SQL Server 資料庫執行個體，該 CEV 就會進入 `available` 狀態。 | CEV 不需要任何額外的驗證。它可以用來建立其他 RDS Custom for SQL Server 資料庫執行個體，或修改現有的執行個體。 | 
| `inactive` | CEV 已修改為非作用中狀態。 | 您無法使用此 CEV 建立或升級 RDS Custom 資料庫執行個體。您也無法還原資料庫快照，以使用此 CEV 建立新的 RDS Custom 資料庫執行個體。若要取得如何將狀態變更為 `ACTIVE` 的資訊，請參閱 [修改 RDS Custom for SQL Server 的 CEV](custom-cev-sqlserver-modifying.md)。 | 
| `failed` | 在此 CEV 可以驗證 AMI 之前，無法對其進行建立資料庫執行個體步驟。或者，CEV 使用的基礎 AMI 未處於可用狀態。 | 針對根本原因進行疑難排解，找出系統為何無法建立資料庫執行個體。檢視詳細的錯誤訊息，然後嘗試再次建立新的資料庫執行個體。確保 CEV 使用的基礎 AMI 處於可用狀態。 | 
| `incompatible-image-configuration` | 驗證 AMI 時發生錯誤。 | 檢視錯誤的技術詳細資訊。您無法再次嘗試使用此 CEV 驗證 AMI。請檢閱下列建議： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/UserGuide/custom-cev-sqlserver.create.html) 使用正確的資訊建立新的 CEV。 如有需要，請使用支援的 AMI 建立新的 EC2 執行個體，並在其上執行 Sysprep 程序。  | 