

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
<a name="sqlserver-dev-edition.creating-cev"></a>

Una versione del motore personalizzata (CEV) per RDS for 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 di Amazon S3 a RDS affinché possa scaricare, convalidare e successivamente creare il tuo CEV.

## Limitazioni di denominazione
<a name="sqlserver-dev-edition.create-cev.naming-limitations"></a>

Quando si crea un CEV, è necessario seguire specifiche convenzioni di denominazione:
+ 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, trattini e punti. Ad esempio: per SQL Server 2025`17.00.4045.5.my-dev-cev`.

Per elencare tutte le versioni del motore supportate per Developer Edition (funzionalità Enterprise Edition), utilizzare il seguente AWS CLI 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, 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"
        }
    ]
}
```

Per elencare tutte le versioni del motore supportate per Developer Edition (funzionalità Standard Edition), usa il seguente AWS CLI comando:

```
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>

**Per creare una versione del motore personalizzata per Developer Edition (funzionalità Enterprise Edition)**
+ Usa 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 {{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"
  ```

**Per creare una versione del motore personalizzata per Developer Edition (funzionalità della Standard Edition)**
+ Usa il comando [ create-custom-db-engine-version ](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html) con. `--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"
  ```

La creazione di un CEV richiede in genere 15-30 minuti. Per monitorare l'avanzamento della creazione del CEV, utilizzate il seguente comando:

```
# 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
```

## Ciclo di vita di un RDS per SQL Server CEV
<a name="sqlserver-dev-cev-lifecycle"></a>

Quando si utilizza SQL Server Developer Edition su RDS per SQL Server, le versioni personalizzate del motore passano attraverso vari stati del ciclo di vita.


| Stato del ciclo di vita | Description | Quando si verifica | Operazioni disponibili | 
| --- | --- | --- | --- | 
| in attesa di convalida | 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 tua versione personalizzata del motore (CEV). Il completamento di questo processo asincrono può richiedere del tempo. | Monitora lo stato fino al completamento della convalida. | 
| disponibile | La convalida della versione del motore personalizzato (CEV) è stata completata con successo. | 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 utilizzando 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.  | Convalida ISO non riuscita. Controlla il motivo dell'errore`describe-db-engine-version`, correggi eventuali problemi relativi ai file, ad esempio errori di hash o contenuti danneggiati, quindi ricrea la versione personalizzata del motore (CEV). | 
| deleting (eliminazione in corso) | La versione del motore personalizzato (CEV) è in fase 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` | 
| supporto di installazione incompatibile | Amazon RDS non è stato in grado di convalidare il supporto di installazione fornito per la versione personalizzata del motore (CEV) | La convalida della versione del motore personalizzato (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
<a name="sqlserver-dev-cev-status-check"></a>

Puoi vedere lo stato dei tuoi CEV usando: 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}'
```

Per la Developer Edition (funzionalità della Standard Edition), sostituisci `sqlserver-dev-ee` con. `sqlserver-dev-se`

Output di esempio

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

Quando un CEV mostra `failed` lo stato, puoi determinarne il motivo utilizzando il seguente comando:

```
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}'
```