

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 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, divalidasi, dan selanjutnya 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 pola`major-version.minor-version.customized-string`.
+ `customized-string`dapat berisi 1-50 karakter alfanumerik, garis bawah, tanda hubung, dan titik. Misalnya: `17.00.4045.5.my-dev-cev` untuk SQL Server 2025.

Untuk mencantumkan semua versi engine yang didukung untuk Edisi Pengembang (kemampuan Edisi Perusahaan), gunakan AWS CLI 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, DBEngineDescription: DBEngineDescription, DBEngineVersionDescription: DBEngineVersionDescription}}"

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

Untuk mencantumkan semua versi engine yang didukung untuk Edisi Pengembang (kemampuan Edisi Standar), gunakan AWS CLI perintah berikut:

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

{
    "DBEngineVersions": [
        {
            "Engine": "sqlserver-dev-se",
            "EngineVersion": "{{17.00.4045.5.v1}}",
            "Status": "requires-custom-engine-version",
            "DBEngineDescription": "Microsoft SQL Server Standard Developer Edition",
            "DBEngineVersionDescription": "SQL Server 2025 17.00.4045.5.v1"
        }
    ]
}
```

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

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

  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 {{17.00.4045.5.cev-dev-ss2025-cu5}} \
  --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 "SQLServer2025-x64-ENU-EntDev.iso" "SQLServer2025-KB5084896-x64.exe"
  ```

**Untuk membuat versi mesin khusus untuk Edisi Pengembang (kemampuan Edisi Standar)**
+ Gunakan perintah [ create-custom-d ](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html) b-engine-version dengan. `--engine sqlserver-dev-se`

  ```
  aws rds create-custom-db-engine-version \
  --engine sqlserver-dev-se \
  --engine-version {{17.00.4045.5.cev-dev-se-ss2025-cu5}} \
  --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 "SQLServer2025-x64-ENU-StdDev.iso" "SQLServer2025-KB5084896-x64.exe"
  ```

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

```
# For Developer Edition (Enterprise Edition capabilities)
aws rds describe-db-engine-versions \
--engine sqlserver-dev-ee \
--engine-version {{17.00.4045.5.my-dev-cev}} \
--region us-west-2

# For Developer Edition (Standard Edition capabilities)
aws rds describe-db-engine-versions \
--engine sqlserver-dev-se \
--engine-version {{17.00.4045.5.my-dev-se-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 di RDS untuk SQL Server, versi mesin khusus Anda bertransisi melalui berbagai status siklus hidup.


| Status Siklus Hidup | Deskripsi | Ketika Itu Terjadi | Tindakan yang Tersedia | 
| --- | --- | --- | --- | 
| validasi gantung | Status 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 khusus (CEV) Anda. Proses asinkron ini mungkin membutuhkan waktu untuk diselesaikan. | Pantau status sampai validasi selesai. | 
| tersedia | Validasi versi mesin khusus (CEV) berhasil diselesaikan. | Versi Mesin Kustom (CEV) sekarang tersedia. Amazon RDS berhasil memvalidasi ISO SQL Server dan file pembaruan 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 khusus (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 rusak, lalu buat ulang versi mesin khusus (CEV) Anda. | 
| menghapus | Versi mesin khusus (CEV) dihapus | Setelah pelanggan menelepon `delete-custom-db-engine-version` hingga alur kerja penghapusan selesai. | Pantau status melalui`describe-db-engine-version`. | 
| media instalasi yang tidak kompatibel | Amazon RDS tidak dapat memvalidasi media instalasi yang disediakan untuk versi mesin khusus (CEV) | Validasi versi mesin khusus (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 keadaan CEV Anda menggunakan: AWS CLI

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

Untuk Edisi Pengembang (kemampuan Edisi Standar), ganti `sqlserver-dev-ee` dengan`sqlserver-dev-se`.

Output sampel

```
| DescribeDBEngineVersions                          |
+------------+--------------------------------------+
| Status | Version                                  |
+------------+--------------------------------------+
| available | 17.00.4045.5.cev-dev-ss2025-cu5         |
+------------+--------------------------------------+
```

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 {{17.00.4045.5.my-dev-cev}} \
4. --region us-west-2 \
5. --query 'DBEngineVersions[0].{Version:EngineVersion,Status:Status,FailureReason:FailureReason}'
```