Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Creazione di una versione del motore personalizzata per RDS per SQL Server
Una versione del motore personalizzata (CEV) per RDS per SQL Server è costituita dai supporti di installazione di SQL Server Developer Edition importati in Amazon RDS. È necessario caricare il programma di installazione ISO di base e i file di aggiornamento cumulativo (.exe) nel bucket Amazon S3. Una volta caricato, devi fornire la posizione Amazon S3 a RDS affinché possa scaricare, convalidare e successivamente creare il tuo CEV.
## Limitazioni di denominazione
Quando si crea un CEV, è necessario seguire convenzioni di denominazione specifiche:
+ Il nome CEV deve seguire lo schema. `major-version.minor-version.customized-string`
+ `customized-string`può contenere da 1 a 50 caratteri alfanumerici, trattini bassi e punti. Ad esempio: per SQL Server 2022`16.00.4215.2.my-dev-cev`.
Per elencare tutte le versioni del motore supportate, utilizzare il seguente comando:
```
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
**Per creare la versione personalizzata del motore**
+ Utilizzate il comando [create-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html).
Sono richieste le seguenti opzioni:
+ `--engine`
+ `--engine-version`
+ `--database-installation-files-s3-bucket-name`
+ `--database-installation-files`
+ `--region`
È anche possibile specificare le seguenti opzioni:
+ `--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"
```
La creazione di CEV richiede in genere 15-30 minuti. Per monitorare l'avanzamento della creazione del CEV, utilizzate il seguente comando:
```
# 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
```
## Ciclo di vita di un RDS per SQL Server CEV
Quando si utilizza SQL Server Developer Edition su RDS per SQL Server, le versioni personalizzate del motore passano attraverso diversi stati del ciclo di vita.
| Stato del ciclo di vita | Description | Quando si verifica | Operazioni disponibili |
| --- | --- | --- | --- |
| convalida in sospeso | Stato iniziale al momento della creazione del CEV | Questo è lo stato iniziale dopo la creazione con il `create-custom-db-engine-version` comando. | Monitora lo stato tramite`describe-db-engine-version`. |
| convalida | Stato di convalida CEV | Amazon RDS sta convalidando la versione del motore personalizzata (CEV). Il completamento di questo processo asincrono potrebbe richiedere del tempo. | Monitora lo stato fino al completamento della convalida. |
| disponibile | La convalida della versione personalizzata del motore (CEV) è stata completata correttamente. | La versione Custom Engine (CEV) è ora disponibile. Amazon RDS ha convalidato con successo i file ISO e di aggiornamento cumulativo di SQL Server. Ora puoi creare istanze DB utilizzando questo CEV. | Crea istanze DB usando questo CEV |
| Non riuscito | RDS per SQL Server non è in grado di creare la versione personalizzata del motore (CEV) perché il controllo di convalida non è riuscito. | La convalida ISO e cumulativa dei supporti non è riuscita. | La convalida ISO non è riuscita. Controlla il motivo dell'errore`describe-db-engine-version`, correggi eventuali problemi relativi ai file, ad esempio mancate corrispondenze di hash o contenuti danneggiati, quindi ricrea la versione del motore personalizzata (CEV). |
| deleting (eliminazione in corso) | La versione personalizzata del motore (CEV) è in corso di eliminazione | Dopo le chiamate del cliente `delete-custom-db-engine-version` fino al completamento del flusso di lavoro di eliminazione. | Monitora lo stato tramite`describe-db-engine-version`. |
| incompatible-installation-media | Amazon RDS non è riuscito a convalidare i supporti di installazione forniti per la versione personalizzata del motore (CEV) | La convalida della versione personalizzata del motore (CEV) non è riuscita. Si tratta di uno stato terminale. | Vedi FailureReason via `describe-db-engine-versions` per informazioni sul motivo per cui la convalida non è riuscita; elimina CEV. |
### Descrivi lo stato del CEV
Puoi vedere lo stato del tuo CEVs utilizzo diAWS 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 di esempio
```
| DescribeDBEngineVersions |
+------------+---------------------------------+
| Status | Version |
+------------+---------------------------------+
| available | 16.00.4215.2.cev-dev-ss2022-cu21 |
+------------+---------------------------------+
```
Quando un CEV mostra `failed` lo stato, è possibile determinarne il motivo utilizzando il seguente comando:
```
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}'
```