

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 support RTM et téléchargement sur S3). Après l'installation, vous pouvez créer des versions du moteur à l'aide de la console Amazon RDS ou de la AWS CLI.

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

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

La mobilité des licences par le biais de l'assurance logicielle est requise pour le BYOM. Vous devez bénéficier d'une couverture Software Assurance active sur vos licences SQL Server avant de les déployer AWS.

Pour terminer le processus de vérification, procédez comme suit :

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. **Soumettre 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. **Attendre 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'impose la conformité des licences Microsoft. Vous êtes responsable du respect de 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 abonnés](https://visualstudio.microsoft.com/subscriptions/).
+ **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 Microsoft 365](https://admin.microsoft.com).

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

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

Téléchargez le fichier SQL Server RTM dans un compartiment Amazon S3 de la même AWS région et du même compte où vous prévoyez de créer la version du moteur BYOM. Pour télécharger le fichier RTM à l'aide de la AWS CLI :

```
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 auprès de 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 pour créer 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 le menu déroulant, sélectionnez **RDS pour SQL Server**.

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

1. Pour **le 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 du moteur**, choisissez la version de SQL Server qui correspond à vos fichiers d'installation (par exemple, SQL Server 2022`16.00.4175.1.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 un statut 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 | Le 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 clé S3 (chemin du dossier) dans lequel les fichiers multimédia 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` obligatoires.

## Décrire les versions du moteur 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 statut 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 une version du moteur BYOM
<a name="sqlserver-byom-creating-cev.modifying"></a>

Vous pouvez modifier une version du moteur BYOM à l'aide de la console AWS de gestion ou de la AWS CLI. Vous pouvez modifier la description de la version du moteur BYOM ou son statut 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 du statut par défaut pour une version du moteur BYOM nouvellement créée.
+ **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 le statut 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 du 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 du 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 du moteur BYOM
<a name="sqlserver-byom-creating-cev.deleting"></a>

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

**Conditions préalables à la suppression**

Avant de pouvoir supprimer une version du 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 du 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 principales. Toutes les versions mineures de la même version majeure et de la même édition réutiliseront le même support d'installation.
+ Lorsque vous fournissez votre RTM SQL Server pour Bring Your Own Media, vous devez uniquement utiliser 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 le `available` statut, vous pouvez lancer une instance RDS for SQL Server en l'utilisant. Consultez [Création d'une instance de base de données BYOM pour RDS pour SQL Server](sqlserver-byom-creating-instance.md).