# RDS Custom for SQL Server のカスタムエンジンバージョンの使用
RDS Custom for SQL Server の*カスタムエンジンバージョン (CEV)* は Microsoft SQL Server を含む Amazon マシンイメージ (AMI) です。
**CEV ワークフローの基本的な手順は次のとおりです。**
1. CEV のベースイメージとして使用する AWS EC2 Windows AMI を選択します。プリインストールされている Microsoft SQL Server を使用するか、Bring Your Own Media (BYOM) を使用して SQL Server を自分でインストールするかを選択できます。
1. オペレーティングシステム (OS) に他のソフトウェアをインストールし、企業のニーズに合わせて OS と SQL Server の構成をカスタマイズします。
1. AMI をゴールデンイメージとして保存します
1. ゴールデンイメージからカスタムエンジンバージョン (CEV) を作成します。
1. CEV を使用して新しい RDS Custom for SQL Server DB インスタンスを作成します。
その後、Amazon RDS はこれらの DB インスタンスをお客様に代わって管理します。
CEV を使用すると、OS とデータベースの任意のベースライン設定を維持できます。CEV を使用すると、サードパーティーエージェントのインストールやその他の OS カスタマイズなどのホスト設定が RDS Custom for SQL Server DB インスタンスで確実に保持されます。CEV を使用すると、同じ設定で RDS Custom for SQL Server DB インスタンスのフリートをすばやくデプロイできます。
**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 を作成する準備
CEV は、ライセンス込み (LI) の Microsoft SQL Server がプリインストールされている Amazon マシンイメージ (AMI) を使用するか、独自の SQL Server インストールメディア (BYOM) をインストールする AMI で作成できます。
## CEV の準備
Bring Your Own Media (BYOM) またはプリインストールされた Microsoft SQL Server (LI) を使用して CEV を作成するには、次の手順に従います。
### Bring Your Own Media (BYOM) を使用した CEV の準備
以下の手順では、例として **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/ja_jp/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. 追加のソフトウェアをインストールするか、要件に合わせて OS とデータベースの設定をカスタマイズします。
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 DB インスタンスを作成します。詳細なステップについては、「[CEV から RDS Custom for SQL Server DB インスタンスを作成する](custom-cev-sqlserver.create.md#custom-cev-sqlserver.create.newdbinstance)」を参照してください。
### プリインストールされている SQL Server (LI) を使用した CEV の準備
プリインストールされている Microsoft SQL Server (LI) を使用して CEV を作成する次のステップでは、例として **SQL Server CU20** リリース番号 `2023.05.10` の AMI を使用します。CEV を作成するときは、最新のリリース番号の AMI を選択してください。これにより、最新の累積更新プログラム (CU) が適用された、サポートされているバージョンの Windows Server と SQL Server を使用していることが保証されます。
**プリインストールされている Microsoft SQL Server (LI) を使用して CEV を作成するには**
1. ライセンス込み (LI) の Microsoft Windows Server と SQL Server を搭載した最新の AWS EC2 Windows Amazon マシンイメージ (AMI) を選択します。
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/ja_jp/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_find_ami_history_li_cu20.png)
1. Amazon EC2 コンソールの [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) を開いてください。
1. Amazon EC2 コンソールのナビゲーションパネルで、**[Images]** (イメージ)、**[AMIs]** (AMI) の順に選択します。
1. 「**パブリックイメージ**」を選択します。
1. 検索ボックスに「`2023.05.10`」と入力します。AMI の一覧が表示されます。
1. 検索ボックスに「`Windows_Server-2019-English-Full-SQL_2019`」と入力し、結果をフィルタリングします。次の結果が表示されます。
![\[SQL Server 2019 CU20 を使用するサポートされている AMI。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_find_ami_li_cu.png)
1. 使用する SQL Server エディションの AMI を選択します。
1. 選択した AMI から EC2 インスタンスを作成または起動します。
1. EC2 インスタンスにログインして追加のソフトウェアをインストールするか、要件に合わせて OS とデータベースの設定をカスタマイズします。
1. EC2 インスタンスで Sysprep を実行します。Sysprep を使用して AMI を準備する方法の詳細については、「[Sysprep を使用して標準化された Amazon マシンイメージ (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 DB インスタンスを作成します。詳細なステップについては、「[CEV から RDS Custom for SQL Server DB インスタンスを作成する](custom-cev-sqlserver.create.md#custom-cev-sqlserver.create.newdbinstance)」を参照してください。
## RDS Custom for SQL Server CEV の利用可能なリージョン
RDS Custom for SQL Server のカスタムエンジンバージョン (CEV) サポートは、次の AWS リージョン で利用できます。
+ 米国東部(オハイオ)
+ 米国東部 (バージニア北部)
+ 米国西部 (オレゴン)
+ 米国西部 (北カリフォルニア)
+ アジアパシフィック (ムンバイ)
+ アジアパシフィック (大阪)
+ アジアパシフィック (ソウル)
+ アジアパシフィック (シンガポール)
+ アジアパシフィック (シドニー)
+ アジアパシフィック (東京)
+ カナダ (中部)
+ 欧州 (フランクフルト)
+ 欧州 (アイルランド)
+ 欧州 (ロンドン)
+ 欧州 (パリ)
+ 欧州 (ストックホルム)
+ 南米 (サンパウロ)
## RDS Custom for SQL Server CEV のバージョンサポート
RDS Custom for SQL Server の CEV 作成は、次の AWS EC2 Windows AMI でサポートされています。
+ プリインストールされたメディアを使用する CEV の場合、ライセンス込み (LI) Microsoft Windows Server 2019 (OS) および SQL Server 2022 または 2019 搭載の AWS EC2 Windows AMI
+ Bring Your Own Media (BYOM) を使用する CEV の場合、Microsoft Windows Server 2019 (OS) 搭載の AWS EC2 Windows AMI
RDS Custom for SQL Server の CEV 作成は、次のオペレーティングシステム (OS) およびデータベースエディションでサポートされています。
+ プリインストールされたメディアを使用する 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)。
+ Bring Your Own Media (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)。
+ プリインストールされたメディアまたは Bring Your Own Media (BYOM) を使用する CEV の場合、サポートされている OS は 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 の一般的な要件
RDS Custom for SQL Server の CEV を作成するには、次の要件が適用されます。
+ CEV の作成に使用される AMI は、RDS Custom for SQL Server でサポートされている OS とデータベースの設定に基づいている必要があります。サポートされている設定の詳細については、「[Amazon RDS Custom for SQL Server の要件と制限](custom-reqs-limits-MS.md)」を参照してください。
+ CEV には一意の名前が必要です。既存の CEV と同じ名前の CEV を作成することはできません。
+ CEV は、SQL Server の*メジャーバージョン \$1 マイナーバージョン \$1 カスタマイズされた文字列*という必須の命名パターンを使用して命名する必要があります。*メジャーバージョン \$1 マイナーバージョン*は、AMI で提供される SQL Server バージョンと一致する必要があります。例えば、SQL Server 2019 CU17 の AMI に **15.00.4249.2.my\$1cevtest** という名前を付けることができます。
+ Sysprep を使用して AMI を準備する必要があります。Sysprep を使用して AMI を準備する方法の詳細については、「[Sysprep を使用して標準化された Amazon マシンイメージ (AMI) を作成する](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-create-win-sysprep.html)」を参照してください。
+ AMI のライフサイクルを維持する責任があります。CEV から作成された RDS Custom for SQL Server DB インスタンスには、AMI のコピーは保存されません。CEV の作成に使用した AMI へのポインタが維持されます。RDS Custom for SQL Server DB インスタンスを操作可能な状態に維持するには、AMI が存在する必要があります。
## RDS Custom for SQL Server CEV の制限
RDS Custom for SQL Server のカスタムエンジンバージョンでは、次の制約事項が適用されます。
+ DB インスタンスや DB スナップショットなどのリソースが関連付けられている場合、CEV を削除することはできません。
+ RDS Custom for SQL Server DB インスタンスを作成するには、CEV のステータスが`pending-validation`、`available`、`failed`、または `validating` のいずれかである必要があります。CEV ステータスが `incompatible-image-configuration` の場合、CEV を使用して RDS Custom for SQL Server DB インスタンスを作成することはできません。
+ 新しい CEV を使用するように RDS Custom for SQL Server DB インスタンスを変更するには、CEV のステータスが `available` である必要があります。
+ 既存の RDS Custom for SQL Server DB インスタンスから AMI または CEV は作成できません。
+ 別の AMI を使用するように既存の CEV を変更することはできません。ただし、RDS Custom for SQL Server DB インスタンスを変更して別の CEV を使用するようにすることはできます。詳細については、「[RDS Custom for SQL Server DB インスタンスの変更](custom-managing.modify-sqlserver.md)」を参照してください。
+ DB インスタンスの作成時に提供される KMS キーとは異なるカスタマー管理の KMS キーを使用した AMI または CEV の暗号化はサポートされていません。
+ CEV のクロスリージョンコピーはサポートされていません。
+ CEV のクロスアカウントコピーはサポートされていません。
+ 削除した CEV を復元または回復することはできません。ただし、同じ AMI から新しい CEV を作成することはできます。
+ RDS Custom for SQL Server DB インスタンスは、*D:\$1* ドライブに SQL Server データベースファイルを保存します。CEV に関連付けられた AMI は、Microsoft SQL Server システムデータベースファイルを *C:\$1* ドライブに保存する必要があります。
+ RDS Custom for SQL Server DB インスタンスでは、SQL Server に加えられた設定変更が保持されます。CEV から作成された、実行中の RDS Custom for SQL Server DB インスタンスでの OS の設定変更は保持されません。OS の設定を恒久的に変更し、それを新しいベースライン設定として保持する必要がある場合は、新しい CEV を作成し、新しい CEV を使用するように DB インスタンスを変更します。
**重要**
新しい CEV を使用するために RDS Custom for SQL Server DB インスタンスを変更するのは、オフライン操作です。変更はすぐに実行することも、毎週のメンテナンスウィンドウに行われるようにスケジュールすることもできます。
+ CEV を変更しても、Amazon RDS はそれらの変更を関連する RDS Custom for SQL Server DB インスタンスにプッシュしません。新しいまたは更新された CEV を使用するには、それぞれの RDS Custom for SQL Server DB インスタンスを変更する必要があります。詳細については、「[RDS Custom for SQL Server DB インスタンスの変更](custom-managing.modify-sqlserver.md)」を参照してください。
+
**重要**
CEV が使用する AMI が削除されると、例えば、スケールコンピューティングなど、ホストの交換が必要になる可能性のある変更はすべて失敗します。RDS Custom for SQL Server DB インスタンスが RDS サポートペリメーターの外側に配置されます。CEV に関連付けられている AMI は削除しないことをお勧めします。
# RDS Custom for SQL Server の CEV の作成
AWS マネジメントコンソール または AWS CLI を使用してカスタムエンジンバージョン (CEV) を作成できます。その後、CEV を使用して RDS Custom for SQL Server DB インスタンスを作成できます。
Amazon マシンイメージ (AMI) が CEV と同じ AWS アカウントとリージョンに存在することを確認してください。そうではない場合、CEV の作成プロセスが失敗します。
詳細については、「[Amazon RDS Custom SQL Server の DB インスタンスの作成と接続](custom-creating-sqlserver.md)」を参照してください。
**重要**
CEV を作成する手順は、プリインストールされた SQL Server で作成された AMI と、Bring Your Own Media (BYOM) を使用して作成された AMI と同じです。
## コンソール
**CEV を作成するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) を開きます。
1. ナビゲーションペインで、[**カスタムエンジンバージョン**] を選択します。
**カスタムエンジンバージョン**ページには、現在存在するすべての CEV が表示されます。CEV をまだ作成していない場合、テーブルは空です。
1. **[カスタムエンジンバージョンの作成]** を選択します。
1. **[Engine type]** (エンジンの種類) に **[Microsoft SQL Server]** を選択します。
1. **[エディション]** で、使用する DB エンジンエディションを選択します。
1. **[Major version]** (メジャーバージョン) で、AMI にインストールされているメジャーエンジンバージョンを選択します。
1. 「**バージョンの詳細**」で、有効な名前を「**カスタムエンジンのバージョン名**」に入力します。
名前の形式は`major-engine-version.minor-engine-version.customized_string`です。ユーザーネームに使用できるのは、1 ～ 50 個の英数字、アンダースコア、ダッシュ、ピリオド(\$1 - .) のみです。例えば、 名前を**15.00.4249.2.my\$1cevtest**と入力します。
必要に応じて、新しい CEV の説明を入力します。
1. **[Installation Media]** (インストールメディア) には、CEV の作成元となる AMI ID を参照または入力します。
1. **[Tags]** (タグ) セクションに、CEV を識別するタグを追加します。
1. **[カスタムエンジンバージョンの作成]** を選択します。
**[カスタムエンジンバージョン]** ページが表示されます。CEV が **[pending-validation]** (検証保留中) ステータスで表示されます。
## AWS CLI
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::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 DB インスタンスを作成する
CEV が正常に作成されると、**CEV ステータス**に `pending-validation` が表示されます。これで、CEV を使用して新しい RDS Custom for SQL Server DB インスタンスを作成できるようになりました。CEV から新しい RDS Custom for SQL Server DB インスタンスを作成するには、[RDS Custom for SQL Server DB インスタンスの作成](custom-creating-sqlserver.md#custom-creating-sqlserver.create) を参照してください。
## CEV のライフサイクル
CEV ライフサイクルには、以下のステータスが含まれます。
****
| CEV ステータス | 説明 | トラブルシューティングの推奨事項 |
| --- | --- | --- |
| `pending-validation` | CEV が作成され、関連する AMI の検証を保留しています。CEV は、そこから RDS Custom for SQL Server DB インスタンスが作成されるまで `pending-validation` に留まります。 | 既存のタスクがない場合は、CEV から新しい RDS Custom for SQL Server DB インスタンスを作成します。RDS Custom for SQL Server DB インスタンスを作成する際、システムは CEV の関連する AMI の検証を試みます。 |
| `validating` | 新しい CEV に基づく RDS Custom for SQL Server DB インスタンスを作成するタスクが進行中です。RDS Custom for SQL Server DB インスタンスを作成する際、システムは CEV の関連する AMI の検証を試みます。 | 既存の RDS Custom for SQL Server DB インスタンスの作成タスクが完了するまで待ちます。RDS EVENTS コンソールを使用して、トラブルシューティングのための詳細なイベントメッセージを確認できます。 |
| `available` | CEV は正常に検証されました。CEV は、そこから RDS Custom for SQL Server DB インスタンスが正常に作成されると、`available` ステータスに入ります。 | CEV は追加の検証を必要としません。追加の RDS Custom for SQL Server DB インスタンスを作成する際、または既存のインスタンスを変更するために使用できます。 |
| `inactive` | CEV は非アクティブ状態に変更されました。 | この CEV で RDS Custom DB インスタンスを作成、またはアップグレードすることはできません。また、この CEV を使用して新しい RDS Custom DB インスタンスを作成するために、DB スナップショットを復元することはできません。状態を `ACTIVE` に変更する方法については、[RDS Custom for SQL Server の CEV の変更](custom-cev-sqlserver-modifying.md) を参照してください。 |
| `failed` | この CEV の DB インスタンスの作成ステップは AMI を検証する前に失敗しました。あるいは、CEV が使用している基盤となる AMI が利用可能な状態にありません。 | システムが DB インスタンスを作成できなかった根本原因をトラブルシューティングします。詳細なエラーメッセージを表示して、新しい DB インスタンスをもう一度作成してみてください。CEV が使用する基盤となる AMI が使用可能な状態であることを確認します。 |
| `incompatible-image-configuration` | AMI の検証中にエラーが発生しました。 | エラーの技術的な詳細を表示します。この CEV で AMI を再度検証することはできません。次の内容を確認します。推奨事項: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-cev-sqlserver.create.html) 正しい情報を使用して新しい CEV を作成します。 必要に応じて、サポートされている AMI を使用して新しい EC2 インスタンスを作成し、そのインスタンスで Sysprep プロセスを実行します。 |
# RDS Custom for SQL Server の CEV の変更
AWS マネジメントコンソールまたはAWS CLIを使用して CEV を変更できます。CEV の説明またはそのアベイラビリティーステータスを変更できます。CEV には、次のいずれかのステータス値があります。
+ `available` - この CEV を使用して、新しい RDS Custom DB インスタンスを作成するか、DB インスタンスをアップグレードできます。これは、新規作成された CEV のデフォルトステータスです。
+ `inactive` – この CEV で RDS Custom DB インスタンスを作成、またはアップグレードすることはできません。この CEV を使用して新しい RDS Custom DB インスタンスを作成するために、DB スナップショットを復元することはできません。
CEV ステータスは、`available` から `inactive` または `inactive` から `available` に変更できます。ステータスを `INACTIVE` に変更することで、CEV の誤用を防ぎ、また中止された CEV を再び使用できるようになります。
## コンソール
**CEV を変更するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) を開きます。
1. ナビゲーションペインで、「**カスタムエンジンバージョン**」 を選択します。
1. 説明またはステータスを変更する CEV を選択します。
1. **[アクション]** で、**[変更]** を選択します。
1. 次の変更のいずれか、あるいはすべてを実行します。
+ **CEV ステータス設定**で、新しいアベイラビリティーステータスを選択します。
+ **Version description** (バージョンの説明) ページで、新しい説明を入力します。
1. **[Modify State]** (状態の変更) を選択します。
CEV が使用中の場合は、コンソールに「**CEV ステータスを変更することはできません**」と表示されます。問題を修正してから、再試行してください。
**[カスタムエンジンバージョン]** ページが表示されます。
## AWS CLI
AWS CLIを使用して CEV を変更するには、[modify-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-custom-db-engine-version.html)コマンドを実行します。[db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html)コマンドを実行して、変更するCEVを検索できます。
以下のオプションは必須です。
+ `--engine`
+ *`cev`*が変更するカスタムエンジンバージョンの名前である`--engine-version cev`です。
+ *`status`*がCEV に割り当てるアベイラビリティーステータスを示す`--status`` status`です。
次の例では、`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
```
新しい CEV を使用するための RDS Custom for SQL Server DB インスタンスの変更する方法については、「[新しい CEV を使用するための RDS Custom for SQL Server DB インスタンスの変更](custom-cev-sqlserver-modifying-dbinstance.md)」を参照してください。
# 新しい CEV を使用するための RDS Custom for SQL Server DB インスタンスの変更
既存の RDS Custom for SQL Server DB インスタンスを変更して別の CEV を使用できます。加えることができる変更には次のものがあります。
+ CEV の変更
+ DB インスタンスタイプを変更する
+ バックアップ保持期間およびバックアップウィンドウを変更する
+ メンテナンスウィンドウを変更する
## コンソール
**RDS Custom for SQL Server DB インスタンスを変更するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。
1. ナビゲーションペインで、[**データベース**] を選択します。
1. 変更する DB インスタンスを選択します。
1. [**Modify**] を選択します。
1. 必要に応じて、以下の変更を加えます。
1. **DB エンジンバージョン**の場合は、別の CEV を選択してください。
1. **[DB インスタンスクラス]** の値を変更します。サポートされているクラスについては、[RDS Custom for SQL Server の DB インスタンスクラスでのサポート](custom-reqs-limits.instancesMS.md)を参照してください。
1. **バックアップ保持期間**の値を変更します。
1. **バックアップウィンドウ**では、**[Start time]** (スタート時間)および **[Duration]** (期間)の値を設定します。
1. **DB インスタンスのメンテナンスウィンドウ**では、**[Start day]** (スタート日)、**[Start time]** (スタート時間)、**[Duration]** (期間)の値を設定します。
1. [**Continue**] を選択します。
1. **すぐに適用**または**次の定期メンテナンスウィンドウ中に適用**を選択します。
1. **[DB インスタンスを変更]** を選択します。
**注記**
例えば、マイナーバージョンをアップグレードする場合など、DB インスタンスをある CEV から別の CEV に変更する場合、SQL Server システムデータベースは、そのデータや設定を含め、現在の RDS Custom for SQL Server DB インスタンスから保持されます。
## AWS CLI
AWS CLI を使用して異なる CEV を使用するように DB インスタンスを変更するには、[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`* は DB インスタンスを変更するカスタムエンジンバージョンの名前です。
次の例では、`my-cev-db-instance` という名前の DB インスタンスを `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 詳細を表示する
CEV の詳細は、AWS マネジメントコンソール または AWS CLI を使用して表示できます。
## コンソール
**CEV の詳細を表示するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) を開きます。
1. ナビゲーションペインで、[**カスタムエンジンバージョン**] を選択します。
**カスタムエンジンバージョン**ページには、現在存在するすべての CEV が表示されます。CEV をまだ作成していない場合、ページは空です。
1. 表示する CEV の名前を選択します。
1. **[Configuration]** (設定) を選択して、詳細を表示します。
![\[CEV 設定の詳細が表示されます。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_viewdetails.PNG)
## AWS CLI
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 の削除
AWS マネジメントコンソール またはAWS CLIを使用して、CEVを削除できます。通常、このタスクには数分かかります。
CEV を削除する前に、CEV が次のいずれかで使用中ではないことを確認してください。
+ RDS Custom DB インスタンスを停止します。
+ RDS Custom DB インスタンスのスナップショット
+ RDS Custom DB インスタンスの自動バックアップ
## コンソール
**CEV を削除するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) を開きます。
1. ナビゲーションペインで、[**カスタムエンジンバージョン**] を選択します。
1. 説明またはステータスを削除する CEV を選択します。
1. **[アクション]** で、**[削除]** を選択します。
**[Delete *cev\$1name*?]** (cev\$1name を削除しますか?) ダイアログボックスが表示されます。
1. 「**delete me**」と入力し、**[削除]** を選択します。
**カスタムエンジンバージョン**ページで、バナーに CEV が削除中であることが示されます。
## AWS CLI
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`
+ *CEV*が削除するカスタムエンジンバージョンの名前である`--engine-version 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
```