

# RDS Custom for SQL Server の CEV の作成
<a name="custom-cev-sqlserver.create"></a>

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 と同じです。

## コンソール
<a name="custom-cev-sqlserver.create.console"></a>

**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
<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 DB インスタンスを作成する
<a name="custom-cev-sqlserver.create.newdbinstance"></a>

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 のライフサイクル
<a name="custom-cev-sqlserver.create.lifecycle"></a>

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 プロセスを実行します。  | 