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

# 使用 RDS Custom for SQL Server 的自訂引擎版本
<a name="custom-cev-sqlserver"></a>

RDS Custom for SQL Server 的*自訂引擎版本 (AMI)* 是包含 Microsoft SQL Server 的 Amazon Machine Image (AMI)。

**CEV 工作流程的基本步驟如下：**

1. 選擇要用作 CEV 基礎映像的 an AWS EC2 Windows AMI。您可以選擇使用預先安裝型 Microsoft SQL Server 或使用自有媒體來安裝 SQL Server。

1. 在作業系統 (OS) 上安裝其他軟體，並自訂作業系統和 SQL Server 的組態，以符合您的企業需求。

1. 將 AMI 儲存為黃金映像

1. 從您的黃金映像建立自訂引擎版本 (CEV)。

1. 使用 CEV 建立新的 RDS Custom for SQL Server 資料庫執行個體。

然後，Amazon RDS 會為您管理這些資料庫執行個體。

CEV 可讓您維護作業系統和資料庫的偏好基準組態。使用 CEV 可確保主機組態 (例如任何第三方代理程式安裝或其他作業系統自訂) 會保存在 RDS Custom for SQL Server 資料庫執行個體上。有了 CEV，您可以使用相同組態快速部署 RDS Custom for SQL Server 資料庫執行個體的機群。

**Topics**
+ [準備建立 RDS Custom for SQL Server 的 CEV](custom-cev-sqlserver.preparing.md)
+ [建立 RDS Custom for SQL Server 的 CEV](custom-cev-sqlserver.create.md)
+ [修改 RDS Custom for SQL Server 的 CEV](custom-cev-sqlserver-modifying.md)
+ [檢視 Amazon RDS Custom for SQL Server 的 CEV 詳細資訊](custom-viewing-sqlserver.md)
+ [刪除 RDS Custom for SQL Server 的 CEV](custom-cev-sqlserver-deleting.md)

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

您可以使用 Amazon Machine Image (AMI)建立 CEV，該映像含有預先安裝的已包含授權 (LI) Microsoft SQL Server，或者使用安裝了自有 SQL Server 安裝媒體 (BYOM) 的 AMI。

## 準備 CEV
<a name="custom-cev-sqlserver.preparing.types"></a>

使用下列程序，使用自有媒體 (BYOM) 或預先安裝的 Microsoft SQL Server (LI) 來建立 CEV。

### 使用自有媒體 (BYOM) 準備 CEV
<a name="custom-cev-sqlserver.preparing.byom"></a>

下列步驟使用具有 **Windows Server 2019 Base** 的 AMI 做為範例。

**若要使用 BYOM 建立 CEV**

1. 在 Amazon EC2 主控台上，選擇**啟動執行個體**。

1. 在**名稱**中，輸入執行個體的名稱。

1. 在 [快速入門] 下，選擇 **Windows**。

1. 選擇 **Microsoft Windows Server 2019 Base**。

1. 選擇適當的執行個體類型、金鑰對、網路和儲存體設定，然後啟動執行個體。

1. 啟動或建立 EC2 執行個體之後，請確定從步驟 4 中選取正確的 Windows AMI：

   1. 在 Amazon EC2 主控台中選取 EC2 執行個體。

   1. 在**詳細資訊**區段中，檢查**使用操作**，確認其設定為 **RunInstances:0002**。  
![\[針對 BYOM 使用 RunInstances:0002 的 Windows AMI。\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/UserGuide/images/cev-sqlserver-byom-ec2runinstances.png)

1. 登入 EC2 執行個體，然後將 SQL Server 安裝媒體複製到該執行個體。
**注意**  
如果您使用 SQL Server Developer 版本建置 CEV，您可能需要使用 [Microsoft Visual Studio 訂閱](https://my.visualstudio.com/Downloads?q=sqlserver%20developer)取得安裝媒體。

1. 安裝 SQL Server。請確定執行下列操作：

   1. 檢閱 [RDS Custom for SQL Server 的 BYOM 要求](custom-sqlserver.byom.md#custom-sqlserver.byom.requirements) 和 [RDS Custom for SQL Server CEV 的版本支援](#custom-cev-sqlserver.preparing.VersionSupport)。

   1. 將執行個體根目錄設定為預設值 `C:\Program Files\Microsoft SQL Server\`。請勿變更此目錄。

   1. 將 SQL Server 資料庫引擎帳戶名稱設定為 `NT Service\MSSQLSERVER` 或 `NT AUTHORITY\NETWORK SERVICE`。

   1. 將 SQL Server 啟動模式設定為**手動**。

   1. 將 SQL Server 驗證模式選擇為**混合**。

   1. 保留預設資料目錄和 TempDB 位置的現有設定。

1. 將 SQL Server系統管理員 (SA) 伺服器角色權限授予 `NT AUTHORITY\SYSTEM`：

   ```
   1. USE [master]
   2. GO
   3. EXEC master..sp_addsrvrolemember @loginame = N'NT AUTHORITY\SYSTEM' , @rolename = N'sysadmin'
   4. GO
   ```

1. 安裝其他軟體或自訂作業系統和資料庫組態以符合您的需求。

1. 在 EC2 執行個體上執行 Sysprep。如需詳細資訊，請參閱[使用 Windows Sysprep 建立 Amazon EC2 AMI](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-create-win-sysprep.html)。

1. 儲存含有已安裝 SQL Server 版本、其他軟體和自訂項目的 AMI。這將是你的黃金映像。

1. 透過提供您所建立映像的 AMI ID 來建立新的 CEV。如需詳細步驟，請參閱[建立 RDS Custom for SQL Server 的 CEV](custom-cev-sqlserver.create.md)。

1. 使用 CEV 建立新的 RDS Custom for SQL Server 資料庫執行個體。如需詳細步驟，請參閱[從 CEV 建立 RDS Custom for SQL Server 資料庫執行個體](custom-cev-sqlserver.create.md#custom-cev-sqlserver.create.newdbinstance)。

### 使用預先安裝型 SQL Server (LI) 準備 CEV
<a name="custom-cev-sqlserver.preparing.licenseincluded"></a>

下列步驟使用預先安裝了 Microsoft SQL Server（LI）的 AMI 建立 CEV，並以使用 **SQL Server CU20** (版本號碼 `2023.05.10`) 的 AMI 作為範例。建立 CEV 時，請選擇具有最新版本號碼的 AMI。如此可確保您使用受支援的 Windows Server 和 SQL Server 版本，以及最新的累積更新 (CU)。

**使用預先安裝型 Microsoft SQL Server (LI) 建立 CEV 的方法如下**

1. 選擇最新的可用 AWS EC2 Windows Amazon Machine Image (AMI)，其中包含授權 (LI) Microsoft Windows Server 和 SQL Server。

   1. 在 [Windows AMI 版本歷史記錄](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-windows-ami-version-history.html)內搜尋 **CU20**。

   1. 請記下版本編號。對於 SQL Server 2019 CU20，版本編號為 `2023.05.10`。  
![\[SQL Server 2019 CU20 的 AMI 版本歷史記錄結果。\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_find_ami_history_li_cu20.png)

   1. 前往 [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) 開啟 Amazon EC2 主控台。

   1. 在 Amazon EC2 主控台的左導覽窗格中，選擇 **Images** (映像)，然後選擇 **AMIs**。

   1. 選擇**公有映像**。

   1. 將 `2023.05.10` 輸入搜尋方塊中。會出現 AMI 清單。

   1. 將 `Windows_Server-2019-English-Full-SQL_2019` 輸入搜尋方塊中以篩選結果。下列結果應該出現。  
![\[使用 SQL Server 2019 CU20 的受支援 AMI。\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_find_ami_li_cu.png)

   1. 選擇具有您要使用之 SQL Server 版本的 AMI。

1. 從您選擇的 AMI 建立或啟動 EC2 執行個體。

1. 登入 EC2 執行個體並安裝其他軟體，或自訂作業系統和資料庫組態以符合您的需求。

1. 在 EC2 執行個體上執行 Sysprep。如需使用 Sysprep 準備 AMI 的詳細資訊，請參閱[使用 Sysprep 建立標準化 Amazon Machine Image (AMI)](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html#sysprep-using-ec2launchv2)。

1. 儲存含有已安裝 SQL Server 版本、其他軟體和自訂項目的 AMI。這將是你的黃金映像。

1. 透過提供您所建立映像的 AMI ID 來建立新的 CEV。如需建立 CEV 的詳細步驟，請參閱 [建立 RDS Custom for SQL Server 的 CEV](custom-cev-sqlserver.create.md)。

1. 使用 CEV 建立新的 RDS Custom for SQL Server 資料庫執行個體。如需詳細步驟，請參閱[從 CEV 建立 RDS Custom for SQL Server 資料庫執行個體](custom-cev-sqlserver.create.md#custom-cev-sqlserver.create.newdbinstance)。

## RDS Custom for SQL Server CEV 的區域可用性
<a name="custom-cev-sqlserver.preparing.RegionVersionAvailability"></a>

下列提供 RDS Custom for SQL Server 的自訂引擎版本 (CEV) 支援 AWS 區域：
+ 美國東部 (俄亥俄)
+ 美國東部 (維吉尼亞北部)
+ 美國西部 (奧勒岡)
+ 美國西部 (加利佛尼亞北部)
+ 亞太地區 (孟買)
+ 亞太區域 (大阪)
+ 亞太區域 (首爾)
+ 亞太區域 (新加坡)
+ 亞太地區 (雪梨)
+ 亞太區域 (東京)
+ 加拿大 (中部)
+ 歐洲 (法蘭克福)
+ 歐洲 (愛爾蘭)
+ 歐洲 (倫敦)
+ 歐洲 (巴黎)
+ 歐洲 (斯德哥爾摩)
+ 南美洲 (聖保羅)

## RDS Custom for SQL Server CEV 的版本支援
<a name="custom-cev-sqlserver.preparing.VersionSupport"></a>

下列 AWS EC2 Windows AMIs 支援建立 RDS Custom for SQL Server 的 CEV：
+ 對於使用預先安裝媒體CEVs， AWS EC2 Windows AMIs 包含授權 (LI) Microsoft Windows Server 2019 (OS) 和 SQL Server 2022 或 2019
+ 對於使用自帶媒體 (BYOM) 的 CEVs， AWS EC2 Windows AMIs搭配 Microsoft Windows Server 2019 (OS)

下列作業系統和資料庫版本支援 RDS Custom for SQL Server 的 CEV 建立程序：
+ 對於使用預先安裝媒體的 CEV：
  + SQL Server 2022 Enterprise、Standard 或 Web，搭配 CU9, CU13, CU14-GDR, CU15-GDR, CU16, CU17, CU18, CU19, CU19-GDR, CU20-GDR, CU21-GDR, CU22和 CU22-GDR。
  + SQL Server 2019 Enterprise、Standard 或 Web，搭配 CU8、CU17、CU18、CU20、CU24、CU26、CU28-GDR、CU29-GDR、CU30、CU32 和 CU32-GDR。
+ 對於使用自有媒體 (BYOM) 的 CEV：
  + SQL Server 2022 Enterprise、Standard 或 Developer，搭配 CU9, CU13, CU14-GDR, CU15-GDR, CU16, CU17, CU18, CU19, CU19-GDR, CU20-GDR, CU21-GDR, CU22和 CU22-GDR。
  + SQL Server 2019 Enterprise、Standard 或 Developer，搭配 CU8, CU17, CU18, CU20, CU24, CU26, CU28-GDR, CU29-GDR, CU30, CU32和 CU32-GDR。
+ 對於使用預先安裝媒體或自有媒體 (BYOM) 的 CEV，Windows Server 2019 是唯一支援的作業系統

如需詳細資訊，請參閱 [AWS Windows AMI 版本歷史記錄](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ec2-windows-ami-version-history.html)。

## RDS Custom for SQL Server CEV 的要求
<a name="custom-cev-sqlserver.preparing.Requirements"></a>

下列需求適用於建立 RDS for RDS Custom for SQL 的 CEV：
+ 用來建立 CEV 的 AMI 必須以 RDS Custom for SQL Server 所支援的作業系統和資料庫組態為基礎。如需所支援組態的詳細資訊，請參閱 [Amazon RDS Custom for SQL Server 的需求和限制](custom-reqs-limits-MS.md)。
+ CEV 必須具有唯一名稱。您無法建立與現有 CEV 同名的 CEV。
+ 您必須使用 SQL Server *主要版本 \$1 次要版本 \$1 自訂字串*的命名模式來命名 CEV。*主要版本 \$1 次要版本*必須符合 AMI 隨附的 SQL Server 版本。例如，您可以將具有 SQL Server 2019 CU17 的 AMI 命名為 **15.00.4249.2.my\$1cevtest**。
+ 您必須使用 Sysprep 準備 AMI。如需使用 Sysprep 準備 AMI 的詳細資訊，請參閱[使用 Sysprep 建立標準化 Amazon Machine Image (AMI)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-create-win-sysprep.html)。
+ 您負責維護 AMI 的生命週期。從 CEV 建立的 RDS Custom for SQL Server 資料庫執行個體不會存放 AMI 的複本。它會維護一個指標，指向您用來建立 CEV 的 AMI。AMI 必須存在，RDS Custom for SQL Server 資料庫執行個體才能保持可操作狀態。

## RDS Custom for SQL Server CEV 的限制
<a name="custom-cev-sqlserver.preparing.Limitations"></a>

下列限制適用於具有 RDS Custom for SQL Server 的自訂引擎版本：
+ 若有資源 (例如資料庫執行個體或資料庫快照) 與 CEV 相關聯，則無法刪除該 CEV。
+ 若要建立 RDS Custom for SQL Server 資料庫執行個體，CEV 必須具有 `pending-validation`、`available`、`failed` 或 `validating` 的狀態。如果 CEV 狀態為 `incompatible-image-configuration`，則無法使用 CEV 建立 RDS Custom for SQL Server 資料庫執行個體。
+ 若要修改 RDS Custom for SQL Server 資料庫執行個體，以使用新的 CEV，CEV 必須具有 `available` 的狀態。
+ 無法從現有 RDS Custom for SQL Server 資料庫執行個體建立 AMI 或 CEV。
+ 您無法修改現有 CEV 以使用不同的 AMI。不過，您可以修改 RDS Custom for SQL Server 資料庫執行個體，以使用不同的 CEV。如需詳細資訊，請參閱[修改 RDS Custom for SQL Server 資料庫執行個體](custom-managing.modify-sqlserver.md)。
+ 不支援使用與資料庫執行個體建立期間提供的 KMS 金鑰不同的客戶受管 KMS 金鑰來加密 AMI 或 CEV。
+ 不支援 CEV 的跨區域複本。
+ 不支援 CEV 的跨帳戶複本。
+ CEV 刪除後就無法還原或復原。不過，您可以從相同 AMI 建立新的 CEV。
+ RDS Custom for SQL Server 資料庫執行個體會將您的 SQL Server 資料庫檔案存放在 *D:\$1* 磁碟機中。與 CEV 相關聯的 AMI 應該將 Microsoft SQL Server 系統資料庫檔案儲存放在 *C:\$1* 磁碟機中。
+ RDS Custom for SQL Server 資料庫執行個體會保留您對 SQL Server 所做的組態變更。不會保留對執行中 RDS Custom for SQL Server 資料庫執行個體 (從 CEV 建立) 上作業系統所做的任何組態變更。如果您需要對作業系統進行永久組態變更，並將其保留為新的基準組態，請建立新 CEV 並修改資料庫執行個體以使用新的 CEV。
**重要**  
修改 RDS Custom for SQL Server 資料庫執行個體以使用新的 CEV，這是離線操作。您可以立即執行修改，或排程在每週維護時段期間進行修改。
+ 修改 CEV 後，Amazon RDS 不會將這些修改推送到任何相關聯的 RDS Custom for SQL Server 資料庫執行個體。您必須修改每個 RDS Custom for SQL Server 資料庫執行個體，才能使用新的或更新的 CEV。如需詳細資訊，請參閱[修改 RDS Custom for SQL Server 資料庫執行個體](custom-managing.modify-sqlserver.md)。
+ 
**重要**  
如果刪除 CEV 使用的 AMI，則可能需要進行主機取代的任何修改 (例如擴展運算) 都將失敗。然後，RDS Custom for SQL Server 資料庫執行個體會放置在 RDS 支援周邊之外。我們建議您避免刪除與 CEV 相關聯的任何 AMI。

# 建立 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 程序。  | 

# 修改 RDS Custom for SQL Server 的 CEV
<a name="custom-cev-sqlserver-modifying"></a>

您可以使用 AWS 管理主控台 或 AWS CLI 修改 CEV。您可以修改 CEV 描述或其可用狀態。您的 CEV 有下列其中一個狀態值：
+ `available` – 您可以使用此 CEV 建立新的 RDS Custom 資料庫執行個體或升級資料庫執行個體。這是新建立的 CEV 的預設狀態。
+ `inactive` – 您無法使用此 CEV 建立或升級 RDS Custom 資料庫執行個體。您無法還原資料庫快照以使用此 CEV 建立新的 RDS Custom 資料庫執行個體。

您可以將 CEV 狀態從 `available` 變更為 `inactive` 或從 `inactive` 變更為 `available`。您可以將狀態變更為 `INACTIVE`，以防止意外使用 CEV，或讓已中止的 CEV 符合再次使用的資格。

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

**若要修改 CEV**

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

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

1. 選擇您想要修改其描述或狀態的 CEV。

1. 在 **Actions** (動作) 中，選擇 **Modify** (修改)。

1. 進行下列任何變更：
   + 針對 **CEV status settings (CEV 狀態設定)**，選擇新的可用性狀態。
   + 針對 **Version description (版本描述)**，輸入新的描述。

1. 選擇 **Modify CEV (修改 CEV)**。

   如果 CEV 正在使用中，主控台會顯示**您無法修改 CEV 狀態**。修正問題，然後再試一次。

**Custom engine versions** (自訂引擎版本) 頁面隨即出現。

## AWS CLI
<a name="custom-cev-sqlserver-modifying.cli"></a>

若要使用 AWS CLI 修改 CEV，請執行 [modify-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-custom-db-engine-version.html) 命令。您可以藉由執行 [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) 命令來尋找要修改的 CEV。

下列選項是必要的：
+ `--engine`
+ `--engine-version cev`，其中 *`cev`* 是您要修改的自訂引擎版本的名稱。
+ `--status`` status`，其中 *`status`* 是您要指派給 CEV 的可用性狀態。

下列範例會將名為 `15.00.4249.2.my_cevtest` 的 CEV 從目前的狀態變更為 `inactive`。

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

```
1. aws rds modify-custom-db-engine-version \
2.     --engine custom-sqlserver-ee \ 
3.     --engine-version 15.00.4249.2.my_cevtest \
4.     --status inactive
```
在 Windows 中：  

```
1. aws rds modify-custom-db-engine-version ^
2.     --engine custom-sqlserver-ee ^
3.     --engine-version 15.00.4249.2.my_cevtest ^
4.     --status inactive
```

若要修改 RDS Custom for SQL Server 資料庫執行個體以使用新的 CEV，請參閱 [修改 RDS Custom for SQL Server 資料庫執行個體以使用新的 CEV](custom-cev-sqlserver-modifying-dbinstance.md)。

# 修改 RDS Custom for SQL Server 資料庫執行個體以使用新的 CEV
<a name="custom-cev-sqlserver-modifying-dbinstance"></a>

您可以修改現有的 RDS Custom for SQL Server 資料庫執行個體，以使用不同的 CEV。您可以進行的變更包括：
+ 變更 CEV
+ 變更資料庫執行個體類別
+ 變更備份保留期和備份時段
+ 變更維護時段

## 主控台
<a name="custom-cev-sqlserver-modifying-dbinstance.CON"></a>

**若要修改 RDS Custom for SQL Server 資料庫執行個體**

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

1. 在導覽窗格中，選擇 **Databases** (資料庫)。

1. 選擇想要修改的資料庫執行個體。

1. 選擇 **Modify (修改)**。

1. 視需要進行下列變更：

   1. 對於 **DB engine version** (資料庫引擎版本)，選擇不同的 CEV。

   1. 變更 **DB instance class (資料庫執行個體類別)** 的值。如需支援的類別，請參閱 [RDS Custom for SQL Server 的資料庫執行個體類別支援](custom-reqs-limits.instancesMS.md)。

   1. 變更 **Backup retention period (備份保留期)** 的值。

   1. 針對 **Backup window (備份時段)**，設定 **Start time (開始時間)** 和 **Duration (持續時間)** 的值。

   1. 針對 **DB instance maintenance window (資料庫執行個體維護時段)**，設定 **Start day (開始日期)**、**Start time (開始時間)** 和 **Duration (持續時間)** 的值。

1. 選擇 **Continue (繼續)**。

1. 選擇 **Apply immediately (立即套用)** 或 **Apply during the next scheduled maintenance window (在下次排定的維護時段套用)**。

1. 選擇 **Modify DB instance (修改資料庫執行個體)**。
**注意**  
將資料庫執行個體從一個 CEV 修改為另一個 CEV (例如，升級次要版本時) 時，SQL Server 系統資料庫 (包括其資料和組態) 會從目前的 RDS Custom for SQL Server 資料庫執行個體保存下來。

## AWS CLI
<a name="custom-cev-sqlserver-modifying-dbinstance.CLI"></a>

若要使用 AWS CLI 修改資料庫執行個體，以使用不同的 CEV，請執行 [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-custom-db-engine-version.html) 命令。

下列選項是必要的：
+ `--db-instance-identifier`
+ `--engine-version cev`，其中 *`cev`* 是自訂引擎版本的名稱，您想要資料庫執行個體變更為該版本。

下列範例會修改名為 `my-cev-db-instance` 的資料庫執行個體，以使用名為 `15.00.4249.2.my_cevtest_new` 的 CEV，並立即套用變更。

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

```
1. aws rds modify-db-instance \
2.     --db-instance-identifier my-cev-db-instance \ 
3.     --engine-version 15.00.4249.2.my_cevtest_new \
4.     --apply-immediately
```
在 Windows 中：  

```
1. aws rds modify-db-instance ^
2.     --db-instance-identifier my-cev-db-instance ^
3.     --engine-version 15.00.4249.2.my_cevtest_new ^
4.     --apply-immediately
```

# 檢視 Amazon RDS Custom for SQL Server 的 CEV 詳細資訊
<a name="custom-viewing-sqlserver"></a>

您可以使用 AWS 管理主控台 或 AWS CLI 來檢視 CEV 的詳細資訊。

## 主控台
<a name="custom-viewing-sqlserver.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. 選擇要檢視的 CEV 名稱。

1. 選擇 **Configuration** (組態) 來檢視詳細資訊。  
![\[檢視 CEV 的組態詳細資訊。\]](http://docs.aws.amazon.com/zh_tw/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_viewdetails.PNG)

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

若要使用 AWS CLI 檢視 CEV 的詳細資訊，請執行 [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) 命令。

您還可以指定下列選項：
+ `--include-all`，檢視具有任何生命週期狀態的所有 CEV。若沒有 `--include-all` 選項，只會傳回處於 `available` 生命週期狀態的 CEV。

```
aws rds describe-db-engine-versions --engine custom-sqlserver-ee --engine-version 15.00.4249.2.my_cevtest --include-all
{
    "DBEngineVersions": [
        {
            "Engine": "custom-sqlserver-ee",
            "MajorEngineVersion": "15.00",
            "EngineVersion": "15.00.4249.2.my_cevtest",
            "DBParameterGroupFamily": "custom-sqlserver-ee-15.0",
            "DBEngineDescription": "Microsoft SQL Server Enterprise Edition for custom RDS",
            "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",
            "DBEngineVersionDescription": "Custom SQL Server EE 15.00.4249.2 cev test",
            "Image": {
                "ImageId": "ami-0r93cx31t5r596482",
                "Status": "pending-validation"
            },
            "DBEngineMediaType": "AWS Provided",
            "CreateTime": "2022-11-20T19:30:01.831000+00:00",
            "ValidUpgradeTarget": [],
            "SupportsLogExportsToCloudwatchLogs": false,
            "SupportsReadReplica": false,
            "SupportedFeatureNames": [],
            "Status": "pending-validation",
            "SupportsParallelQuery": false,
            "SupportsGlobalDatabases": false,
            "TagList": [],
            "SupportsBabelfish": false
        }
    ]
}
```

您可以使用篩選條件，檢視具有特定生命週期狀態的 CEV。例如，若要檢視生命週期狀態為 `pending-validation`、`available` 或 `failed` 的 CEV：

```
aws rds describe-db-engine-versions engine custom-sqlserver-ee
                region us-west-2 include-all query 'DBEngineVersions[?Status == pending-validation || 
                Status == available || Status == failed]'
```

# 刪除 RDS Custom for SQL Server 的 CEV
<a name="custom-cev-sqlserver-deleting"></a>

您可以使用 AWS 管理主控台 或 AWS CLI 刪除 CEV。通常，此任務需要幾分鐘的時間。

刪除 CEV 前，請確定下列任何一項未使用該 CEV：
+ RDS Custom 資料庫執行個體
+ RDS Custom 資料庫執行個體的快照
+ RDS Custom 資料庫執行個體的自動備份

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

**若要刪除 CEV**

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

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

1. 選擇您想要刪除其描述或狀態的 CEV。

1. 對於 **Actions** (動作)，請選擇 **Delete** (刪除)。

   **Delete *cev\$1name*? (是否刪除 cev\$1name？)** 對話方塊隨即顯示。

1. 輸入 **delete me**，然後選擇 **Delete (刪除)**。

   在 **Custom engine versions** (自訂引擎版本) 頁面上，橫幅會顯示您的 CEV 即將刪除。

## AWS CLI
<a name="custom-cev-sqlserver-deleting.console.cli"></a>

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

下列選項是必要的：
+ `--engine custom-sqlserver-ee`
+ `--engine-version cev`，其中 *CEV* 是要刪除之自訂引擎版本的名稱

以下範例會刪除名為 `15.00.4249.2.my_cevtest` 的 CEV。

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

```
1. aws rds delete-custom-db-engine-version \
2.     --engine custom-sqlserver-ee \
3.     --engine-version 15.00.4249.2.my_cevtest
```
在 Windows 中：  

```
1. aws rds delete-custom-db-engine-version ^
2.     --engine custom-sqlserver-ee ^
3.     --engine-version 15.00.4249.2.my_cevtest
```