Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création d'une version de moteur personnalisée pour RDS pour SQL Server
<a name="sqlserver-dev-edition.creating-cev"></a>

Une version de moteur personnalisée (CEV) pour RDS pour SQL Server se compose de votre support d'installation de SQL Server Developer Edition importé dans Amazon RDS. Il est nécessaire de télécharger le programme d'installation ISO de base et les fichiers de mise à jour cumulative (.exe) dans votre compartiment Amazon S3. Une fois chargé, vous devez fournir l'emplacement Amazon S3 à RDS pour qu'il télécharge, valide et crée ensuite votre CEV.

## Limites de dénomination
<a name="sqlserver-dev-edition.create-cev.naming-limitations"></a>

Lorsque vous créez un CEV, vous devez suivre des conventions de dénomination spécifiques :
+ Le nom CEV doit suivre le modèle. `major-version.minor-version.customized-string`
+ `customized-string`peut contenir de 1 à 50 caractères alphanumériques, des traits de soulignement, des tirets et des points. Par exemple : `17.00.4045.5.my-dev-cev` pour SQL Server 2025.

Pour répertorier toutes les versions de moteur prises en charge pour Developer Edition (fonctionnalités de l'édition Enterprise), utilisez la AWS CLI commande suivante :

```
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"
        }
    ]
}
```

Pour répertorier toutes les versions de moteur prises en charge pour Developer Edition (fonctionnalités de l'édition Standard), utilisez la AWS CLI commande suivante :

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

**Pour créer une version de moteur personnalisée pour Developer Edition (fonctionnalités de l'édition Enterprise)**
+ Utilisez la commande [https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html) create-custom-db-engine-version.

  Les options suivantes sont requises :
  + `--engine`
  + `--engine-version`
  + `--database-installation-files-s3-bucket-name`
  + `--database-installation-files`
  + `--region`

  Vous pouvez également spécifier les options suivantes :
  + `--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"
  ```

**Pour créer une version de moteur personnalisée pour Developer Edition (fonctionnalités de l'édition Standard)**
+ Utilisez la commande [https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html) create-custom-db-engine-version avec. `--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 création d'un CEV prend généralement 15 à 30 minutes. Pour suivre la progression de la création du CEV, utilisez la commande suivante :

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

## Cycle de vie d'un RDS pour SQL Server CEV
<a name="sqlserver-dev-cev-lifecycle"></a>

Lorsque vous utilisez SQL Server Developer Edition sur RDS pour SQL Server, les versions personnalisées de votre moteur passent par différents états de cycle de vie.


| État du cycle de vie | Description | Quand cela se produit | Actions disponibles | 
| --- | --- | --- | --- | 
| en attente de validation | État initial lors de la création du CEV | Il s'agit de l'état initial après la création à l'aide de la `create-custom-db-engine-version` commande. | Surveillez l'état via`describe-db-engine-version`. | 
| validation | État de validation CEV | Amazon RDS valide la version personnalisée de votre moteur (CEV). Ce processus asynchrone peut prendre un certain temps. | Surveillez l'état jusqu'à ce que la validation soit terminée. | 
| available | La validation de la version personnalisée du moteur (CEV) s'est terminée avec succès. | La version personnalisée du moteur (CEV) est désormais disponible. Amazon RDS a validé avec succès vos fichiers ISO et de mises à jour cumulatives de SQL Server. Vous pouvez désormais créer des instances de base de données à l'aide de ce CEV. | Créez des instances de base de données à l'aide de ce CEV | 
| failed | RDS pour SQL Server ne peut pas créer la version personnalisée du moteur (CEV) car le contrôle de validation a échoué. | La validation de l'ISO et des supports cumulatifs a échoué.  | La validation ISO a échoué. Vérifiez la raison de l'échec`describe-db-engine-version`, corrigez les problèmes de fichiers tels que les incohérences de hachage ou le contenu endommagé, puis recréez la version personnalisée de votre moteur (CEV). | 
| deleting | La version personnalisée du moteur (CEV) est en train de supprimer | Après les appels du client `delete-custom-db-engine-version` jusqu'à la fin du flux de travail de suppression. | Surveillez l'état via`describe-db-engine-version`. | 
| support d'installation incompatible | Amazon RDS n'a pas pu valider le support d'installation fourni pour la version personnalisée du moteur (CEV) | La validation de la version personnalisée du moteur (CEV) a échoué. Il s’agit d’un statut de terminal. | Voir FailureReason via `describe-db-engine-versions` pour plus d'informations sur les raisons de l'échec de la validation ; supprimez le CEV. | 

### Décrire le statut CEV
<a name="sqlserver-dev-cev-status-check"></a>

Vous pouvez consulter l'état de vos CEV à l'aide des outils suivants : 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}'
```

Pour Developer Edition (fonctionnalités de l'édition Standard), remplacez `sqlserver-dev-ee` par`sqlserver-dev-se`.

Exemple de sortie.

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

Lorsqu'un CEV affiche `failed` son statut, vous pouvez en déterminer la raison à l'aide de la commande suivante :

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