Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Membuat versi mesin khusus untuk RDS untuk SQL Server
<a name="sqlserver-dev-edition.creating-cev"></a>

Versi mesin khusus (CEV) untuk RDS untuk SQL Server terdiri dari media instalasi SQL Server Developer Edition Anda yang diimpor ke Amazon RDS. Anda perlu mengunggah penginstal ISO dasar dan file pembaruan kumulatif (.exe) ke bucket Amazon S3 Anda. Setelah diunggah, Anda harus memberikan lokasi Amazon S3 ke RDS agar dapat diunduh, memvalidasi, dan kemudian membuat CEV Anda.

## Batasan penamaan
<a name="sqlserver-dev-edition.create-cev.naming-limitations"></a>

Saat membuat CEV, Anda harus mengikuti konvensi penamaan tertentu:
+ Nama CEV harus mengikuti `major-version.minor-version.customized-string` polanya.
+ `customized-string`dapat berisi 1-50 karakter alfanumerik, garis bawah, tanda hubung, dan titik. Misalnya: `16.00.4215.2.my-dev-cev` untuk SQL Server 2022.

Untuk mencantumkan semua versi mesin yang didukung, gunakan perintah berikut:

```
aws rds describe-db-engine-versions --engine sqlserver-dev-ee --output json --query "{DBEngineVersions: DBEngineVersions[?Status=='requires-custom-engine-version'].{Engine: Engine, EngineVersion: EngineVersion, Status: Status, DBEngineVersionDescription: DBEngineVersionDescription}}" 

{
    "DBEngineVersions": [
        {
            "Engine": "sqlserver-dev-ee",
            "EngineVersion": "16.00.4215.2.v1",
            "Status": "requires-custom-engine-version",
            "DBEngineDescription": "Microsoft SQL Server Enterprise Developer Edition",
            "DBEngineVersionDescription": "SQL Server 2022 16.00.4215.2.v1"
        }
    ]
}
```

## AWS CLI
<a name="sqlserver-dev-edition.create-cev.CLI"></a>

**Untuk membuat versi mesin khusus**
+ Gunakan perintah [create-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html).

  Opsi berikut diperlukan:
  + `--engine`
  + `--engine-version`
  + `--database-installation-files-s3-bucket-name`
  + `--database-installation-files`
  + `--region`

  Anda juga dapat menentukan parameter berikut:
  + `--database-installation-files-s3-prefix`
  + `--description`
  + `--tags`

  ```
  aws rds create-custom-db-engine-version \
  --engine sqlserver-dev-ee \
  --engine-version 16.00.4215.2.cev-dev-ss2022-cu21 \
  --region us-west-2 \
  --database-installation-files-s3-bucket-name my-s3-installation-media-bucket \
  --database-installation-files-s3-prefix sqlserver-dev-media \
  --database-installation-files "SQLServer2022-x64-ENU-Dev.iso" "SQLServer2022-KB5065865-x64.exe"
  ```

Pembuatan CEV biasanya memakan waktu 15-30 menit. Untuk memantau kemajuan pembuatan CEV, gunakan perintah berikut:

```
# Check CEV status
aws rds describe-db-engine-versions \
--engine sqlserver-dev-ee \
--engine-version 16.00.4215.2.my-dev-cev \
--region us-west-2
```

## Siklus hidup RDS untuk SQL Server CEV
<a name="sqlserver-dev-cev-lifecycle"></a>

Saat bekerja dengan SQL Server Developer Edition pada RDS untuk SQL Server, versi mesin kustom Anda bertransisi melalui berbagai status siklus hidup.


| Status Siklus Hidup | Deskripsi | Ketika Itu Terjadi | Tindakan yang Tersedia | 
| --- | --- | --- | --- | 
|  penundan-validasi  |  Keadaan awal saat CEV dibuat  |  Ini adalah keadaan awal setelah pembuatan dengan `create-custom-db-engine-version` perintah.  |  Pantau status melalui`describe-db-engine-version`.  | 
|  memvalidasi  |  Status Validasi CEV  |  Amazon RDS memvalidasi versi mesin kustom Anda (CEV). Proses asinkron ini mungkin membutuhkan waktu untuk diselesaikan.  |  Pantau status hingga validasi selesai.  | 
|  tersedia  |  Validasi versi mesin kustom (CEV) berhasil diselesaikan.  |  Versi Mesin Kustom (CEV) sekarang tersedia. Amazon RDS berhasil memvalidasi SQL Server ISO dan file pemutakhiran kumulatif Anda. Anda sekarang dapat membuat instance DB menggunakan CEV ini.  |  Buat instance DB menggunakan CEV ini  | 
|  gagal  |  RDS untuk SQL Server tidak dapat membuat versi mesin kustom (CEV) karena pemeriksaan validasi gagal.  |  ISO dan validasi media kumulatif gagal.   |  Validasi ISO gagal. Periksa alasan kegagalan`describe-db-engine-version`, perbaiki masalah file apa pun seperti ketidakcocokan hash atau konten yang rusak, lalu buat ulang versi mesin kustom (CEV) Anda.  | 
|  menghapus  |  Versi mesin khusus (CEV) sedang dihapus  |  Setelah panggilan pelanggan `delete-custom-db-engine-version` hingga alur kerja penghapusan selesai.  |  Pantau status melalui`describe-db-engine-version`.  | 
|  incompatible-installation-media  |  Amazon RDS tidak dapat memvalidasi media instalasi yang disediakan untuk versi mesin khusus (CEV)  |  Validasi versi mesin kustom (CEV) gagal. Ini adalah status terakhir.  |  Lihat FailureReason via `describe-db-engine-versions` untuk info tentang mengapa validasi gagal; hapus CEV.  | 

### Jelaskan Status CEV
<a name="sqlserver-dev-cev-status-check"></a>

Anda dapat melihat status Anda CEVs menggunakanAWS CLI:

```
1. aws rds describe-db-engine-versions \
2. --engine sqlserver-dev-ee \
3. --engine-version 16.00.4215.2.my-dev-cev \
4. --region us-west-2 \
5. --query 'DBEngineVersions[0].{Version:EngineVersion,Status:Status}'
```

Output sampel

```
| DescribeDBEngineVersions                     |
+------------+---------------------------------+
| Status | Version                             |
+------------+---------------------------------+
| available | 16.00.4215.2.cev-dev-ss2022-cu21    |
+------------+---------------------------------+
```

Ketika CEV menunjukkan `failed` status, Anda dapat menentukan alasannya menggunakan perintah berikut:

```
1. aws rds describe-db-engine-versions \
2. --engine sqlserver-dev-ee \
3. --engine-version 16.00.4215.2.my-dev-cev \
4. --region us-west-2 \
5. --query 'DBEngineVersions[0].{Version:EngineVersion,Status:Status,FailureReason:FailureReason}'
```