

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 et gestion des versions du moteur BYOM pour RDS pour SQL Server
<a name="sqlserver-byom-creating-cev"></a>

La création d'une version du moteur BYOM nécessite une configuration unique (vérification de la mobilité des licences, obtention du contenu multimédia RTM et téléchargement sur S3). Après la configuration, vous pouvez créer des versions du moteur à l'aide de la console Amazon RDS ou de l' AWS interface de ligne de commande.

## Avant de commencer
<a name="sqlserver-byom-creating-cev.before-you-begin"></a>

### Étape 1 : terminer la vérification de la mobilité des licences Microsoft
<a name="sqlserver-byom-creating-cev.step1"></a>

La mobilité des licences via Software Assurance est requise pour le BYOM. Vous devez disposer d'une couverture Software Assurance active sur vos licences SQL Server avant de les déployer AWS.

Pour terminer le processus de vérification :

1. ****Consultez la page [AWS License Mobility ](https://aws.amazon.com/windows/resources/licensemobility/) pour consulter les exigences et les critères d'éligibilité.

1. **Soumettez le formulaire de vérification ** Téléchargez et complétez le formulaire de vérification [ Microsoft License Mobility](https://www.microsoft.com/en-us/licensing/licensing-programs/software-assurance-license-mobility.aspx). Soumettez le formulaire à Microsoft par l'intermédiaire de votre partenaire de licence ou directement.

1. **Attendez l'approbation ** Microsoft vous envoie un e-mail de confirmation lorsque votre vérification est approuvée.

Vous devez envoyer le formulaire à Microsoft directement ou par l'intermédiaire de votre revendeur Microsoft dans les 10 jours suivant la livraison des produits. AWS

**Important**  
AWS ne valide ni n'applique la conformité des licences Microsoft. Vous êtes responsable du maintien de la conformité avec vos contrats de licence Microsoft.

### Étape 2 : obtenir le support d'installation de SQL Server
<a name="sqlserver-byom-creating-cev.step2"></a>

Téléchargez le fichier Release to Manufacturing (RTM) correspondant à la version majeure de SQL Server que vous souhaitez utiliser. Le fichier RTM est le support d'installation de base pour une version et une édition majeures de SQL Server (par exemple, SQL Server 2019 Enterprise Edition).

Vous pouvez obtenir le fichier RTM auprès de l'une des sources Microsoft suivantes :
+ **Abonnement Visual Studio ** Si vous avez un abonnement Visual Studio actif, téléchargez le fichier RTM depuis la page [ de téléchargement des ](https://visualstudio.microsoft.com/subscriptions/) abonnés.
+ **Centre d'administration Microsoft 365 ** Si vous avez acheté des produits par le biais de licences en volume, téléchargez le fichier RTM depuis la page [ Téléchargements du centre d'administration ](https://admin.microsoft.com) Microsoft 365.

**Important**  
Téléchargez uniquement le fichier Core-based ISO en anglais. N'utilisez pas le fichier CAL-based ISO Server\+.

**Important**  
Pour le support d'installation de SQL Server 2019 Release to Manufacturing (RTM) (éditions Standard et Enterprise Core), téléchargez-le uniquement depuis le Microsoft 365 Admin Center. Le média SQL Server 2019 téléchargé à partir de Visual Studio Subscriptions n'est pas pris en charge. Pour SQL Server 2022 et versions ultérieures, vous pouvez télécharger le support d'installation RTM à partir du centre d'administration Microsoft 365 ou des abonnements Visual Studio.

### Étape 3 : Chargez le support d'installation sur Amazon S3
<a name="sqlserver-byom-creating-cev.step3"></a>

Téléchargez le fichier SQL Server RTM vers un compartiment Amazon S3 situé dans la même AWS région et dans le même compte que ceux dans lesquels vous prévoyez de créer la version du moteur BYOM. Pour télécharger le fichier RTM à l'aide de l' AWS interface de ligne de commande :

```
aws s3 cp SQLServer2022-x64-ENU-Enterprise.iso s3://my-sqlserver-media/ISOs/
```

**Note**  
Si vous ne fournissez pas de fichier de mise à jour cumulative (CU) lors de la création du moteur BYOM, Amazon RDS télécharge automatiquement le CU requis depuis Microsoft lorsque vous créez la version du moteur.

## Création d'une version du moteur BYOM
<a name="sqlserver-byom-creating-cev.creating"></a>

`describe-db-engine-versions`À utiliser pour vérifier quelles versions de moteur sont éligibles à la création d'une version de moteur BYOM. Pour les versions prises en charge, consultez[Bring Your Own Media (BYOM) pour RDS pour SQL Server](sqlserver-byom.md).

### Console
<a name="sqlserver-byom-creating-cev.console"></a>

1. Connectez-vous à la console [AWS de gestion ](https://console.aws.amazon.com/rds/) et ouvrez la console Amazon RDS.

1. Dans le panneau de navigation, choisissez **Custom engine versions** (Versions de moteur personnalisées).

1. Dans la liste déroulante, sélectionnez ** RDS pour SQL Server**.

1. Choisissez **Create custom engine version** (Créer une version de moteur personnalisée).

1. Pour Type de ** moteur**, choisissez ** SQL Server**.

1. Pour **Type de gestion de base de données**, choisissez **Amazon RDS**.

1. Pour ** Edition**, choisissez l'une des options suivantes : 
   + SQL Server Enterprise Edition
   + SQL Server Standard Edition

1. Pour la version ** Engine**, choisissez la version de SQL Server qui correspond à vos fichiers d'installation (par exemple, SQL Server 2022 `16.00.4175.1.v1` ou SQL Server 2025`17.00.4045.5.v1`).

1. Pour le support ** d'installation**, entrez l'URI S3 qui contient votre support SQL Server RTM, ou choisissez ** Parcourir S3 ** pour localiser et sélectionner le fichier.

1. Choisissez **Create custom engine version** (Créer une version de moteur personnalisée).

La console affiche la nouvelle version du moteur BYOM avec l'état initial ** En attente de validation**. Le statut progresse automatiquement. Pour de plus amples informations, veuillez consulter [États du cycle de vie des versions du moteur BYOM](#sqlserver-byom-creating-cev.lifecycle).

### INTERFACE DE LIGNE DE COMMANDE (CLI)
<a name="sqlserver-byom-creating-cev.cli"></a>

Utilisez la `create-custom-db-engine-version` commande pour créer une version du moteur BYOM à partir de votre support d'installation. Amazon RDS télécharge automatiquement la mise à jour cumulative requise auprès de Microsoft.

```
aws rds create-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --database-installation-files-s3-bucket-name my-sqlserver-media \
    --database-installation-files-s3-prefix "ISOs/" \
    --database-installation-files "SQLServer2022-x64-ENU-Enterprise.iso"
```

**Réponse**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    "DatabaseInstallationFiles": [
        "SQLServer2022-x64-ENU-Enterprise.iso"
    ],
    "DBEngineDescription": "Microsoft SQL Server Enterprise Edition",
    "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:sqlserver-ee/16.00.4175.1.v1/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    ....
    "Status": "pending-validation",
    .....
}
```

**Paramètres de la CLI **


| Paramètre | Obligatoire | Description | 
| --- | --- | --- | 
| --engine | Oui | Type de moteur de base de données :sqlserver-ee,sqlserver-se. | 
| --engine-version | Oui | La version du moteur cible (par exemple,16.00.4175.1.v1). | 
| --database-installation-files-s3-bucket-name | Oui | Nom du compartiment S3 qui contient votre support d'installation. Le bucket doit se trouver dans la même AWS région que la version du moteur BYOM. | 
| --database-installation-files-s3-prefix | Non | Le préfixe de la clé S3 (chemin du dossier) dans lequel les fichiers du support d'installation sont stockés. | 
| --database-installation-files | Oui | Les noms de fichiers du support d'installation. | 

**Note**  
Lorsque vous utilisez la AWS CLI`--database-installation-files-s3-bucket-name`, les `--database-installation-files` paramètres`--database-installation-files-s3-prefix`, et ne sont requis que pour la première version du moteur BYOM que vous créez pour une version et une édition majeures. Pour les versions mineures suivantes au sein de la même version majeure, uniquement `--engine` et `--engine-version` sont obligatoires.

## Décrire les versions des moteurs BYOM
<a name="sqlserver-byom-creating-cev.describing"></a>

Après avoir créé une version du moteur BYOM, utilisez-la `describe-db-engine-versions` pour vérifier son état et ses détails. La sortie renvoie deux enregistrements pour la même version du moteur : un pour License Included (`DBEngineMediaType: None`) et un pour BYOM (`DBEngineMediaType: Customer Provided`).

**Exemple :**

```
aws rds describe-db-engine-versions \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --include-all \
    --output table \
    --query "DBEngineVersions[].{Engine: Engine, Version: EngineVersion, Status: Status, MediaType: DBEngineMediaType}"
```

**Réponse :**

```
-----------------------------------------------------------------------
|                      DescribeDBEngineVersions                       |
+--------------+---------------------+------------+-------------------+
|    Engine    |      MediaType      |  Status    |      Version      |
+--------------+---------------------+------------+-------------------+
|  sqlserver-ee|  None               |  available |  16.00.4175.1.v1  |
|  sqlserver-ee|  Customer Provided  |  available |  16.00.4175.1.v1  |
+--------------+---------------------+------------+-------------------+
```

## États du cycle de vie des versions du moteur BYOM
<a name="sqlserver-byom-creating-cev.lifecycle"></a>


| State | Description | 
| --- | --- | 
| pending-validation | RDS a accepté la demande et l'a mise en file d'attente pour traitement. | 
| validating | RDS valide le fichier multimédia RTM. | 
| creating | RDS installe SQL Server à partir d'un fichier multimédia RTM. | 
| available | La version du moteur BYOM est prête pour la création d'instances. | 
| incompatible\_installation\_media | Les fichiers d'installation ne sont pas valides ou sont endommagés. Il s’agit d’un statut de terminal. Supprimez la version du moteur BYOM et réessayez avec les bons fichiers. | 

## Modifier la version d'un moteur BYOM
<a name="sqlserver-byom-creating-cev.modifying"></a>

Vous pouvez modifier la version d'un moteur BYOM à l'aide de la console de AWS gestion ou de l' AWS interface de ligne de commande. Vous pouvez modifier la description de la version du moteur BYOM ou son état de disponibilité. La version de votre moteur BYOM possède l'une des valeurs d'état suivantes :
+ **disponible ** : vous pouvez utiliser cette version du moteur BYOM pour créer une nouvelle instance de base de données ou mettre à niveau une instance de base de données. Il s'agit de l'état par défaut d'une nouvelle version du moteur BYOM.
+ **inactive ** : vous ne pouvez pas créer ou mettre à niveau une instance de base de données avec cette version du moteur BYOM. Vous ne pouvez pas restaurer un instantané de base de données pour créer une nouvelle instance de base de données avec cette version du moteur BYOM.

Vous pouvez modifier l'état de la version du moteur BYOM de `available` à `inactive` ou de `inactive` à`available`. Vous pouvez modifier le statut `inactive` pour empêcher l'utilisation accidentelle d'une version du moteur BYOM ou pour qu'une version de moteur BYOM abandonnée puisse être réutilisée.

```
aws rds modify-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --status inactive
```

**Réponse**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    ....
    "Status": "inactive",
    ....
}
```

**Note**  
Les instances existantes exécutées sur une version de moteur BYOM que vous avez définie comme inactive continuent de fonctionner normalement. Seules les opérations de création et de restauration de nouvelles instances sont concernées.

## Supprimer une version d'un moteur BYOM
<a name="sqlserver-byom-creating-cev.deleting"></a>

Permet `delete-custom-db-engine-version` de supprimer définitivement une version du moteur BYOM. Après la suppression, la version du moteur revient à une seule LI-only entrée.

**Conditions préalables à la suppression **

Avant de supprimer une version d'un moteur BYOM, assurez-vous de ce qui suit :
+ Aucune instance de base de données n'utilise la version BYOM.
+ Aucun instantané de base de données ne fait référence à la version BYOM.

Si l'une des ressources RDS existe, l'API échoue à la demande de suppression.

**Supprimer une version d'un moteur BYOM (CLI) **

```
aws rds delete-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1
```

**Réponse**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    .....
    "Status": "deleting",
    ....
}
```

## Considérations
<a name="sqlserver-byom-creating-cev.considerations"></a>
+ Vous fournissez le fichier ISO RTM une fois par version et édition majeures. Toutes les versions mineures d'une même version majeure et d'une même édition réutiliseront le même support d'installation.
+ Lorsque vous fournissez votre SQL Server RTM pour Bring Your Own Media, vous ne devez utiliser que l'ISO Core-based RTM et non le fichier ISO RTM basé sur Server \+ CAL.

## Étapes suivantes
<a name="sqlserver-byom-creating-cev.next-steps"></a>

Une fois que la version de votre moteur BYOM a atteint `available` le statut, vous pouvez lancer une instance RDS pour SQL Server à l'aide de celui-ci. Consultez [Création d'une instance de base de données BYOM pour RDS pour SQL Server](sqlserver-byom-creating-instance.md).