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.
# Utilisation de versions de moteur personnalisées pour RDS Custom for SQL Server
Une *version de moteur personnalisée (CEV)* pour RDS Custom for SQL Server est une Amazon Machine Image (AMI) qui inclut Microsoft SQL Server.
**Les étapes de base du flux de travail CEV sont les suivantes :**
1. Choisissez une AMI Windows AWS EC2 à utiliser comme image de base pour un CEV. Vous avez la possibilité d'utiliser Microsoft SQL Server préinstallé ou le modèle Bring Your Own Media (BYOM) pour installer SQL Server vous-même.
1. Installez d'autres logiciels sur le système d'exploitation et personnalisez la configuration du système d'exploitation et de SQL Server pour répondre aux besoins de votre entreprise.
1. Enregistrez l'image AMI en tant qu'image finale.
1. Créez une version de moteur personnalisée (CEV) à partir de votre image finale.
1. Créez de nouvelles instances de base de données RDS Custom for SQL Server à l'aide de votre version CEV.
Amazon RDS gère ensuite ces instances de base de données pour vous.
Une version CEV vous permet de conserver votre configuration de base préférée du système d'exploitation et de la base de données. L'utilisation d'une version CEV garantit que la configuration de l'hôte, telle que toute installation d'agent tiers ou toute autre personnalisation du système d'exploitation, est conservée sur les instances de base de données RDS Custom for SQL Server. Une version CEV vous permet de déployer rapidement des flottes d'instances de base de données RDS Custom for SQL Server avec la même configuration.
**Topics**
+ [Préparation à la création d'une version CEV pour RDS Custom pour SQL Server](custom-cev-sqlserver.preparing.md)
+ [Création d'une version CEV pour RDS Custom pour SQL Server](custom-cev-sqlserver.create.md)
+ [Modification d'une version CEV pour RDS Custom for SQL Server](custom-cev-sqlserver-modifying.md)
+ [Affichage des détails de version CEV pour Amazon RDS Custom for SQL Server](custom-viewing-sqlserver.md)
+ [Suppression d'une version CEV pour RDS Custom for SQL Server](custom-cev-sqlserver-deleting.md)
# Préparation à la création d'une version CEV pour RDS Custom pour SQL Server
Vous pouvez créer une version CEV à l'aide d'une Amazon Machine Image (AMI) contenant Microsoft SQL Server, License Included (LI), préinstallé, ou à l'aide d'une image AMI sur laquelle vous installez votre propre support d'installation SQL Server (BYOM).
## Préparation d’une CEV
Utilisez les procédures suivantes pour créer une CEV utilisant le modèle Bring Your Own Media (BYOM) ou Microsoft SQL Server (LI) préinstallé.
### Préparation d'une version CEV à l'aide du modèle Bring Your Own Media (BYOM)
Les étapes suivantes utilisent une image AMI avec **Windows Server 2019 Base** à titre d’exemple.
**Pour créer une version CEV à l'aide du modèle BYOM**
1. Dans la console Amazon EC2, choisissez **Lancer une instance**.
1. Pour **Nom**, entrez le nom de l’instance.
1. Sous Démarrage rapide, sélectionnez **Windows**.
1. Choisissez **Microsoft Windows Server 2019 Base**.
1. Choisissez le type d’instance, la paire de clés, les paramètres réseau et de stockage appropriés, puis lancez l’instance.
1. Après avoir lancé ou créé l’instance EC2, assurez-vous que l’AMI Windows appropriée a été sélectionnée à l’étape 4 :
1. Sélectionnez l’instance EC2 dans la console Amazon EC2.
1. **Dans la section **Détails**, vérifiez l'**opération Usage** et assurez-vous qu'elle est définie sur : 0002RunInstances.**
![\[AMI Windows utilisant : RunInstances 0002 pour BYOM.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/cev-sqlserver-byom-ec2runinstances.png)
1. Connectez-vous à l'instance EC2 et copiez-y votre support d'installation de SQL Server.
**Note**
Si vous créez une CEV à l’aide de l’édition SQL Server Developer, vous devrez peut-être obtenir le support d’installation à l’aide de votre [abonnement Microsoft Visual Studio](https://my.visualstudio.com/Downloads?q=sqlserver%20developer).
1. Installez SQL Server. Veillez à effectuer les opérations suivantes :
1. Consultez [Exigences pour le modèle BYOM pour RDS Custom for SQL Server](custom-sqlserver.byom.md#custom-sqlserver.byom.requirements) et [Support de version pour RDS Custom pour SQL Server CEVs](#custom-cev-sqlserver.preparing.VersionSupport).
1. Définissez le répertoire racine de l'instance sur le répertoire par défaut `C:\Program Files\Microsoft SQL Server\`. Ne modifiez pas ce répertoire.
1. Définissez le nom du compte du moteur de base de données SQL Server sur `NT Service\MSSQLSERVER` ou `NT AUTHORITY\NETWORK SERVICE`.
1. Définissez le mode de démarrage de SQL Server sur **Manuel**.
1. Choisissez le mode d'authentification SQL Server **Mixte**.
1. Conservez les paramètres actuels pour les répertoires de données et les emplacements TempDB par défaut.
1. Accordez le privilège de rôle de serveur SQL Server sysadmin (SA) à `NT AUTHORITY\SYSTEM` :
```
1. USE [master]
2. GO
3. EXEC master..sp_addsrvrolemember @loginame = N'NT AUTHORITY\SYSTEM' , @rolename = N'sysadmin'
4. GO
```
1. Installez des logiciels supplémentaires ou personnalisez la configuration du système d'exploitation et de la base de données pour répondre à vos exigences.
1. Exécutez Sysprep sur l'instance EC2. Pour plus d’informations, consultez [Créer une AMI Amazon EC2 à l’aide de Windows Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-create-win-sysprep.html).
1. Enregistrez l'image AMI qui contient la version de SQL Server que vous avez installée, d'autres logiciels et des personnalisations. Cela constituera votre image finale.
1. Créez une nouvelle version CEV en fournissant l'ID AMI de l'image que vous avez créée. Pour obtenir des instructions complètes, consultez [Création d'une version CEV pour RDS Custom pour SQL Server](custom-cev-sqlserver.create.md).
1. Créez une nouvelle instance de base de données RDS Custom pour SQL Server à l'aide de la version CEV. Pour obtenir des instructions complètes, consultez [Création d'une instance de base de données RDS Custom pour SQL Server à partir d'une version CEV](custom-cev-sqlserver.create.md#custom-cev-sqlserver.create.newdbinstance).
### Préparation d'une version CEV utilisant SQL Server (LI) préinstallé
Les étapes suivantes pour créer un CEV à l'aide de Microsoft SQL Server (LI) préinstallé utilisent une AMI avec le numéro de CU20 version de **SQL Server** `2023.05.10` comme exemple. Lorsque vous créez une version CEV, choisissez une image AMI avec le numéro de version le plus récent. Cela garantit que vous utilisez une version prise en charge de Windows Server et de SQL Server avec la dernière mise à jour cumulative (CU).
**Pour créer une version CEV utilisant Microsoft SQL Server (LI) préinstallé**
1. Choisissez la dernière image machine AWS EC2 Windows Amazon (AMI) disponible avec licence incluse (LI) Microsoft Windows Server et SQL Server.
1. Recherchez **CU20**dans l'[historique des versions de l'AMI Windows](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-windows-ami-version-history.html).
1. Notez le numéro de version. Pour SQL Server 2019 CU20, le numéro de version est`2023.05.10`.
![\[Résultat de l'historique des versions de l'AMI pour SQL Server 2019 CU20.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_find_ami_history_li_cu20.png)
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le panneau de navigation de gauche de la console Amazon EC2, choisissez **Images, puis**. **AMIs**
1. Choisissez **Images publiques**.
1. Entrez `2023.05.10` dans la zone de recherche. Une liste de AMIs apparaît.
1. Entrez `Windows_Server-2019-English-Full-SQL_2019` dans la zone de recherche pour filtrer les résultats. Les résultats suivants doivent apparaître.
![\[Pris en charge AMIs à l'aide de SQL Server 2019 CU20.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_find_ami_li_cu.png)
1. Choisissez l'AMI avec l'édition de SQL Server que vous voulez utiliser.
1. Créez ou lancez une instance EC2 à partir de l'AMI de votre choix.
1. Connectez-vous à l'instance EC2 et installez des logiciels supplémentaires ou personnalisez le système d'exploitation et la configuration de la base de données en fonction de vos besoins.
1. Exécutez Sysprep sur l'instance EC2. Pour plus d'informations sur la préparation d'une AMI à l'aide de Sysprep, consultez [Créer une Amazon Machine Image (AMI) standardisée à l'aide de Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html#sysprep-using-ec2launchv2).
1. Enregistrez l'image AMI qui contient la version de SQL Server que vous avez installée, d'autres logiciels et des personnalisations. Cela constituera votre image finale.
1. Créez une nouvelle version CEV en fournissant l'ID AMI de l'image que vous avez créée. Pour obtenir les étapes détaillées de la création d'une version CEV, consultez [Création d'une version CEV pour RDS Custom pour SQL Server](custom-cev-sqlserver.create.md).
1. Créez une nouvelle instance de base de données RDS Custom pour SQL Server à l'aide de la version CEV. Pour obtenir des instructions complètes, consultez [Création d'une instance de base de données RDS Custom pour SQL Server à partir d'une version CEV](custom-cev-sqlserver.create.md#custom-cev-sqlserver.create.newdbinstance).
## Disponibilité régionale pour RDS Custom pour SQL Server CEVs
La prise en charge des versions de moteur personnalisées (CEV) pour RDS Custom pour SQL Server est disponible dans les versions suivantes : Régions AWS
+ USA Est (Ohio)
+ USA Est (Virginie du Nord)
+ USA Ouest (Oregon)
+ USA Ouest (Californie du Nord)
+ Asie-Pacifique (Mumbai)
+ Asie-Pacifique (Osaka)
+ Asia Pacific (Seoul)
+ Asie-Pacifique (Singapour)
+ Asie-Pacifique (Sydney)
+ Asie-Pacifique (Tokyo)
+ Canada (Centre)
+ Europe (Francfort)
+ Europe (Irlande)
+ Europe (Londres)
+ Europe (Paris)
+ Europe (Stockholm)
+ Amérique du Sud (São Paulo)
## Support de version pour RDS Custom pour SQL Server CEVs
La création de CEV pour RDS Custom for SQL Server est prise en charge pour les fenêtres AWS EC2 suivantes : AMIs
+ Pour CEVs utiliser un support préinstallé, Windows AWS EC2 AMIs avec licence incluse (LI), Microsoft Windows Server 2019 (OS) et SQL Server 2022 ou 2019
+ Pour CEVs utiliser Bring your own media (BYOM), AWS EC2 Windows avec AMIs Microsoft Windows Server 2019 (OS)
La création d'une version CEV pour RDS Custom for SQL Server est prise en charge pour les éditions de système d'exploitation et de base de données suivantes :
+ Pour CEVs utiliser un support préinstallé :
+ SQL Server 2022 Enterprise, Standard ou Web, avec, -GDR CU9 CU13, CU14 -GDR,,,,, CU15 -GDR CU16, -GDR CU17 CU18 CU19, CU19 -GDR et -GDR. CU20 CU21 CU22 CU22
+ SQL Server 2019 Enterprise, Standard ou Web, avec,, CU8, CU17, CU18 CU20, -GDR CU24 CU26, CU28 -GDR,, et CU29 -GDR. CU30 CU32 CU32
+ Pour CEVs utiliser Bring your own media (BYOM) :
+ SQL Server 2022 Enterprise, Standard ou Developer, avec,, -GDR CU9 CU13,,,,, CU14 CU15 -GDR, -GDR CU16, -GDR CU17 CU18 CU19, CU19 -GDR et -GDR. CU20 CU21 CU22 CU22
+ SQL Server 2019 Enterprise, Standard ou Developer, avec, CU8, CU17,, CU18 CU20, -GDR CU24 CU26, CU28 -GDR,, et CU29 -GDR. CU30 CU32 CU32
+ Pour CEVs utiliser des supports préinstallés ou apporter votre propre contenu multimédia (BYOM), Windows Server 2019 est le seul système d'exploitation pris en charge.
Pour plus d’informations, consultez [Historique des versions des AMI Windows AWS](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ec2-windows-ami-version-history.html).
## Exigences relatives à RDS Custom pour SQL Server CEVs
Les exigences suivantes s'appliquent à la création d'une version CEV pour RDS Custom pour SQL Server :
+ L'image AMI utilisée pour créer une version CEV doit être basée sur une configuration de système d'exploitation et de base de données prise en charge par RDS Custom for SQL Server. Pour plus d'informations sur les configurations prises en charge, consultez [Conditions requises et limitations d'Amazon RDS Custom for SQL Server](custom-reqs-limits-MS.md).
+ La version CEV doit avoir un nom unique. Vous ne pouvez pas créer une version CEV qui porte le même nom qu'une version CEV existante.
+ Vous devez nommer la version CEV en utilisant le modèle de dénomination de SQL Server *version majeure \$1 version mineure \$1 chaîne personnalisée*. La partie *version majeure \$1 version mineure* doit correspondre à la version de SQL Server fournie avec l'AMI. Par exemple, vous pouvez nommer une AMI avec SQL Server 2019 CU17 **15.00.4249.2.my\$1cevtest**.
+ Vous devez préparer une AMI à l'aide de Sysprep. Pour plus d'informations sur la préparation d'une AMI à l'aide de Sysprep, consultez [Créer une Amazon Machine Image (AMI) standardisée à l'aide de Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-create-win-sysprep.html).
+ Vous êtes responsable du maintien du cycle de vie de l'AMI. Une instance de base de données RDS Custom pour SQL Server créée à partir d'une version CEV ne stocke aucune copie de l'AMI. Il conserve un pointeur vers l'AMI que vous avez utilisée pour créer la version CEV. L'AMI doit exister pour qu'une instance de base de données RDS Custom for SQL Server reste opérationnelle.
## Limitations de RDS Custom pour SQL Server CEVs
Les limites suivantes s'appliquent aux versions de moteur personnalisées avec RDS Custom for SQL Server :
+ Vous ne pouvez pas supprimer une version CEV si des ressources, telles que des instances de base de données ou des instantanés de base de données, y sont associées.
+ Pour créer une instance de base de données RDS Custom for SQL Server, une version CEV doit avoir un statut `pending-validation`, `available`, `failed` ou `validating`. Vous ne pouvez pas créer une instance de base de données RDS Custom for SQL Server à l'aide d'une version CEV si le statut de la version CEV est `incompatible-image-configuration`.
+ Pour modifier une instance de base de données RDS Custom for SQL Server afin d'utiliser une nouvelle version CEV, la version CEV doit avoir un statut `available`.
+ Vous ne pouvez pas créer une image AMI ni une version CEV à partir d'une instance de base de données RDS Custom for SQL Server.
+ Vous ne pouvez pas modifier une version CEV existante pour utiliser une autre image AMI. Toutefois, vous pouvez modifier une instance de base de données RDS Custom for SQL Server afin d'utiliser une autre version CEV. Pour plus d’informations, consultez [Modification d'une instance de base de données RDS Custom for SQL Server](custom-managing.modify-sqlserver.md).
+ Le chiffrement d’une AMI ou d’une CEV avec une clé KMS gérée par le client différente de la clé KMS fournie lors de la création de l’instance de base de données n’est pas pris en charge.
+ La copie interrégionale de CEVs n'est pas prise en charge.
+ La copie entre comptes CEVs n'est pas prise en charge.
+ Vous ne pouvez pas restaurer ni récupérer une version CEV après l'avoir supprimée. Toutefois, vous pouvez créer une version CEV à partir de la même AMI.
+ Une instance de base de données RDS Custom for SQL Server stocke vos fichiers de base de données SQL Server dans le lecteur *D:\$1*. L'AMI associée à une version CEV doit stocker les fichiers de base de données système Microsoft SQL Server dans le lecteur *C:\$1*.
+ Une instance de base de données RDS Custom for SQL Server conserve vos modifications de configuration que vous avez apportées à SQL Server. Les modifications de configuration apportées au système d'exploitation sur une instance de base de données RDS Custom for SQL Server en cours d'exécution, créée à partir d'une version CEV, ne sont pas conservées. Si vous devez apporter une modification permanente à la configuration du système d'exploitation et la conserver comme nouvelle configuration de base, créez une nouvelle version CEV et modifiez l'instance de base de données pour utiliser cette nouvelle version CEV.
**Important**
La modification d'une instance de base de données RDS Custom for SQL Server pour utiliser une nouvelle version CEV est une opération hors ligne. Vous pouvez effectuer la modification immédiatement ou la planifier au cours d'un créneau de maintenance hebdomadaire.
+ Lorsque vous modifiez une version CEV, Amazon RDS ne transmet (push) ces modifications à aucune instance de base de données RDS Custom for SQL Server associée. Vous devez modifier chaque instance de base de données RDS Custom for SQL Server afin d'utiliser la version CEV nouvelle ou mise à jour. Pour plus d’informations, consultez [Modification d'une instance de base de données RDS Custom for SQL Server](custom-managing.modify-sqlserver.md).
+
**Important**
Si une AMI utilisée par une version CEV est supprimée, toutes les modifications pouvant nécessiter le remplacement de l'hôte, par exemple le calcul d'échelle, échoueront. L'instance de base de données RDS Custom for SQL Server sera alors placée en dehors du périmètre de prise en charge RDS. Nous vous recommandons d'éviter de supprimer toute AMI associée à une version CEV.
# Création d'une version CEV pour RDS Custom pour SQL Server
Vous pouvez créer une version de moteur personnalisée (CEV) à l'aide de la AWS Management Console ou d'AWS CLI. Vous pouvez ensuite utiliser la version CEV pour créer une instance de base de données RDS Custom pour SQL Server.
Assurez-vous que l'Amazon Machine Image (AMI) se trouve dans la même région et le même compte AWS que votre CEV. Sinon, le processus de création d'une version CEV échoue.
Pour plus d’informations, consultez [Création et connexion à une instance de base de données pour Amazon RDS Custom for SQL Server](custom-creating-sqlserver.md).
**Important**
Les étapes de création d'une version CEV sont les mêmes pour les images AMI créées avec SQL Server préinstallé et celles créées à l'aide du modèle Bring Your Own Media (BYOM).
## Console
**Pour créer une CEV**
1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon RDS à l’adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Dans le panneau de navigation, choisissez **Custom engine versions** (Versions de moteur personnalisées).
La page **Custom engine versions** (Versions de moteur personnalisées) affiche toutes les CEV qui existent actuellement. Si vous n'avez pas créé de version CEV, la table est vide.
1. Choisissez **Create custom engine version** (Créer une version de moteur personnalisée).
1. Dans **Engine type** (Type de moteur), choisissez **Microsoft SQL Server**.
1. Pour **Édition**, sélectionnez l’édition du moteur de base de données Oracle que vous souhaitez utiliser.
1. Pour **Major version** (Version majeure), choisissez la version majeure du moteur qui est installée sur votre AMI.
1. Dans **Version details** (Détails de la version), saisissez un nom valide dans **Custom engine version name** (Nom de version de moteur personnalisée).
Le format de nom est `major-engine-version.minor-engine-version.customized_string`. Vous pouvez utiliser de 1 à 50 caractères alphanumériques, des traits de soulignement, des tirets et des points. Par exemple, vous pouvez saisir le nom **15.00.4249.2.my\$1cevtest**.
Si vous le souhaitez, saisissez une description pour votre CEV.
1. Dans **Installation Media** (Support d'installation), accédez à l'ID AMI à partir duquel vous souhaitez créer la version CEV ou saisissez-le.
1. Dans la section **Tags** (Identifications), ajoutez des identifications pour identifier la version CEV.
1. Choisissez **Create custom engine version** (Créer une version de moteur personnalisée).
La page **Custom engine versions** (Versions de moteur personnalisées) s'affiche. Votre version CEV s'affiche avec le statut **pending-validation** (validation en attente)
## AWS CLI
Pour créer une CEV à l'aide de la AWS CLI, exécutez la commande [create custom-db-engine version](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html).
Les options suivantes sont requises :
+ `--engine`
+ `--engine-version`
+ `--image-id`
Vous pouvez également spécifier les options suivantes :
+ `--description`
+ `--region`
+ `--tags`
L'exemple suivant crée une CEV nommée `15.00.4249.2.my_cevtest`. Assurez-vous que le nom de votre version CEV commence par le numéro de version majeure du moteur.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds create-custom-db-engine-version \
2. --engine custom-sqlserver-ee \
3. --engine-version 15.00.4249.2.my_cevtest \
4. --image-id ami-0r93cx31t5r596482 \
5. --description "Custom SQL Server EE 15.00.4249.2 cev test"
```
La sortie partielle suivante affiche le moteur, les groupes de paramètres et d'autres informations.
```
1. "DBEngineVersions": [
2. {
3. "Engine": "custom-sqlserver-ee",
4. "MajorEngineVersion": "15.00",
5. "EngineVersion": "15.00.4249.2.my_cevtest",
6. "DBEngineDescription": "Microsoft SQL Server Enterprise Edition for RDS Custom for SQL Server",
7. "DBEngineVersionArn": "arn:aws:rds:us-east-1::cev:custom-sqlserver-ee/15.00.4249.2.my_cevtest/a1234a1-123c-12rd-bre1-1234567890",
8. "DBEngineVersionDescription": "Custom SQL Server EE 15.00.4249.2 cev test",
9.
10. "Image": [
11. "ImageId": "ami-0r93cx31t5r596482",
12. "Status": "pending-validation"
13. ],
14. "CreateTime": "2022-11-20T19:30:01.831000+00:00",
15. "SupportsLogExportsToCloudwatchLogs": false,
16. "SupportsReadReplica": false,
17. "Status": "pending-validation",
18. "SupportsParallelQuery": false,
19. "SupportsGlobalDatabases": false,
20. "TagList": []
21. }
22. ]
```
Si le processus de création d'une version CEV échoue, RDS Custom pour SQL Server émet des problèmes `RDS-EVENT-0198` avec le message `Creation failed for custom engine version major-engine-version.cev_name`. Le message comprend des détails sur l'échec. Par exemple, l'événement imprime les fichiers manquants. Pour trouver des idées de résolution des problèmes liés à la création d'une version CEV, consultez [Résolution des erreurs de version CEV pour RDS Custom for SQL Server](custom-troubleshooting-sqlserver.md#custom-troubleshooting-sqlserver.cev).
## Création d'une instance de base de données RDS Custom pour SQL Server à partir d'une version CEV
Une fois que vous avez créé une version CEV, **CEV status** (Statut de CEV) affiche `pending-validation`. Vous pouvez maintenant créer une nouvelle instance de base de données RDS Custom pour SQL Server à l'aide de la version CEV. Pour créer une nouvelle instance de base de données RDS Custom pour SQL Server à partir d'une version CEV, consultez [Création d'une instance de base de données RDS Custom for SQL Server](custom-creating-sqlserver.md#custom-creating-sqlserver.create).
## Cycle de vie d'une version CEV
Le cycle de vie d'une version CEV comprend les statuts suivants.
****
| Statut de CEV | Description | Suggestions de dépannage |
| --- | --- | --- |
| `pending-validation` | Une version CEV a été créée et attend la validation de l'AMI associée. Une version CEV restera à l'état `pending-validation` jusqu'à ce qu'une instance de base de données RDS Custom pour SQL Server soit créée à partir d'elle. | En l'absence de tâches existantes, créez une nouvelle instance de base de données RDS Custom pour SQL Server à partir de la version CEV. Lors de la création de l'instance de base de données RDS Custom pour SQL Server, le système tente de valider l'AMI associée pour une version CEV. |
| `validating` | Une tâche de création pour l'instance de base de données RDS Custom pour SQL Server basée sur une nouvelle version CEV est en cours. Lors de la création de l'instance de base de données RDS Custom pour SQL Server, le système tente de valider l'AMI associée d'une version CEV. | Attendez la fin de la tâche de création de l'instance de base de données RDS Custom pour SQL Server existante. Vous pouvez utiliser la console RDS EVENTS pour passer en revue les messages d'événement détaillés à des fins de résolution des problèmes. |
| `available` | La version CEV a été validée avec succès. Une version CEV saisira le statut `available` une fois qu'une instance de base de données RDS Custom pour SQL Server aura été créée à partir d'elle. | La version CEV ne nécessite aucune validation supplémentaire. Elle peut être utilisée pour créer des instances de base de données RDS Custom pour SQL Server ou modifier des instances existantes. |
| `inactive` | La version CEV est passée à un état inactif. | Vous ne pouvez pas créer ou mettre à niveau une instance de base de données RDS Custom avec cette version CEV. De plus, vous ne pouvez pas restaurer un instantané de base de données pour créer une nouvelle instance de base de données RDS Custom avec cette version CEV. Pour obtenir des informations sur la façon de modifier l'état en `ACTIVE`, consultez [Modification d'une version CEV pour RDS Custom for SQL Server](custom-cev-sqlserver-modifying.md). |
| `failed` | L'étape de création d'une instance de base de données a échoué pour cette version CEV avant qu'elle puisse valider l'AMI. Sinon, l'AMI sous-jacente utilisée par la version CEV n'est pas dans un état disponible. | Résolvez la cause racine pour laquelle le système n'a pas pu créer l'instance de base de données. Consultez le message d'erreur détaillé et essayez à nouveau de créer une nouvelle instance de base de données. Veillez à ce que l'AMI sous-jacente utilisée par la version CEV soit dans un état disponible. |
| `incompatible-image-configuration` | Une erreur s'est produite lors de la validation de l'AMI. | Consultez les détails techniques de l'erreur. Vous ne pouvez pas tenter de valider à nouveau l'AMI avec cette version CEV. Passez en revue les recommandations suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/custom-cev-sqlserver.create.html) Créez une nouvelle version CEV en utilisant les informations correctes. Si nécessaire, créez une nouvelle instance EC2 à l'aide d'une AMI prise en charge et exécutez le processus Sysprep sur celle-ci. |
# Modification d'une version CEV pour RDS Custom for SQL Server
Vous pouvez modifier une CEV à l'aide de la AWS Management Console ou de la AWS CLI. Vous pouvez modifier la description de la CEV ou son état de disponibilité. Votre CEV possède l'une des valeurs d'état suivantes :
+ `available` – Vous pouvez utiliser cette CEV pour créer une nouvelle instance de base de données RDS Custom ou mettre à niveau une instance de base de données. Il s'agit de l'état par défaut d'une nouvelle CEV.
+ `inactive` : vous ne pouvez pas créer ni mettre à niveau une instance RDS Custom avec cette version CEV. Vous ne pouvez pas restaurer un instantané de base de données pour créer une nouvelle instance de base de données RDS Custom avec cette CEV.
Vous pouvez modifier le statut de la version CEV de `available` à `inactive` ou de `inactive` à `available`. Vous pouvez modifier le statut en spécifiant `INACTIVE` pour empêcher l'utilisation accidentelle d'une version CEV ou pour rendre une version CEV abandonnée à nouveau éligible à l'utilisation.
## Console
**Pour modifier une CEV**
1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon RDS à l’adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Dans le panneau de navigation, choisissez **Custom engine versions** (Versions de moteur personnalisées).
1. Choisissez une CEV dont vous souhaitez modifier la description ou l'état.
1. Pour **Actions**, choisissez **Modifier**.
1. Effectuez une ou plusieurs des modifications suivantes :
+ Pour **Paramètres d'état de CEV** (CEV status settings), choisissez un nouvel état de disponibilité.
+ Sur la page **Version description** (Description de la version), saisissez une nouvelle description.
1. Choisissez **Modify CEV** (Modifier la CEV).
Si la CEV est en cours d'utilisation, la console affiche **You can't modify the CEV status** (Vous ne pouvez pas modifier l'état de la CEV). Résolvez les problèmes, puis réessayez.
La page **Custom engine versions** (Versions de moteur personnalisées) s'affiche.
## AWS CLI
Pour modifier une CEV à l'aide de la AWS CLI, exécutez la commande [modify-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-custom-db-engine-version.html). Vous pouvez trouver des CEV à modifier en exécutant la commande[describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html).
Les options suivantes sont requises :
+ `--engine`
+ `--engine-version cev`, où *`cev`* représente le nom de la version de moteur personnalisée que vous souhaitez modifier
+ `--status`` status`, où *`status`* représente l'état de disponibilité que vous souhaitez attribuer à la CEV
L'exemple suivant modifie une CEV nommée `15.00.4249.2.my_cevtest` de son état actuel vers `inactive`.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds modify-custom-db-engine-version \
2. --engine custom-sqlserver-ee \
3. --engine-version 15.00.4249.2.my_cevtest \
4. --status inactive
```
Pour Windows :
```
1. aws rds modify-custom-db-engine-version ^
2. --engine custom-sqlserver-ee ^
3. --engine-version 15.00.4249.2.my_cevtest ^
4. --status inactive
```
Pour modifier une instance de base de données RDS Custom for SQL Server pour utiliser une nouvelle version CEV, consultez [Modification d'une instance de base de données RDS Custom for SQL Server pour utiliser une nouvelle version CEV](custom-cev-sqlserver-modifying-dbinstance.md).
# Modification d'une instance de base de données RDS Custom for SQL Server pour utiliser une nouvelle version CEV
Vous pouvez modifier une instance de base de données RDS Custom for SQL Server existante afin d'utiliser une autre version CEV. Les modifications que vous pouvez apporter incluent :
+ Modification de la version CEV
+ Modification de la classe d'instance
+ Modification de la période de rétention des sauvegardes et de la fenêtre de sauvegarde
+ Modification de la fenêtre de maintenance
## Console
**Pour modifier une instance de base de données RDS Custom for SQL Server**
1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon RDS à l’adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Dans la panneau de navigation, choisissez **Databases (Bases de données)**.
1. Choisissez l'instance de bases de données que vous souhaitez modifier.
1. Sélectionnez **Modify**.
1. Effectuez les modifications suivantes selon les besoins :
1. Pour la **version du moteur de base de données**, choisissez une version CEV différente.
1. Modifiez la valeur de **Classe d'instance de base de données**. Pour connaître les classes prises en charge, consultez [Prise en charge de la classe d'instance de base de données pour RDS Custom for SQL Server](custom-reqs-limits.instancesMS.md).
1. Modifiez la valeur de **Période de rétention des sauvegardes**.
1. Dans le champ **Fenêtre de sauvegarde**, définissez les valeurs pour **Heure de début** et **Durée**.
1. Dans le champ **Fenêtre de maintenance d'instance de bases de données**, définissez les valeurs pour **Jour de début**, **Heure de début** et **Durée**.
1. Choisissez **Continuer**.
1. Sélectionnez **Appliquer immédiatement** ou **Appliquer au cours de la prochaine fenêtre de maintenance planifiée**.
1. Choisissez **Modifier l’instance DB**.
**Note**
Lorsque vous modifiez une instance de base de données d'une version CEV à une autre, par exemple, lors de la mise à niveau d'une version mineure, les bases de données système SQL Server, y compris leurs données et leurs configurations, sont conservées à partir de l'instance de base de données RDS Custom for SQL Server actuelle.
## AWS CLI
Pour modifier une instance de base de données pour qu'elle utilise une autre version CEV à l'aide d'AWS CLI, exécutez la commande [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-custom-db-engine-version.html).
Les options suivantes sont requises :
+ `--db-instance-identifier`
+ `--engine-version cev`, où *`cev`* représente le nom de la version de moteur personnalisée que vous souhaitez que l'instance de base de données prenne.
L'exemple suivant modifie une instance de base de données nommée `my-cev-db-instance` pour utiliser une version CEV nommée `15.00.4249.2.my_cevtest_new` et applique la modification immédiatement.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds modify-db-instance \
2. --db-instance-identifier my-cev-db-instance \
3. --engine-version 15.00.4249.2.my_cevtest_new \
4. --apply-immediately
```
Pour Windows :
```
1. aws rds modify-db-instance ^
2. --db-instance-identifier my-cev-db-instance ^
3. --engine-version 15.00.4249.2.my_cevtest_new ^
4. --apply-immediately
```
# Affichage des détails de version CEV pour Amazon RDS Custom for SQL Server
Vous pouvez consulter les détails de votre version CEV en utilisant la AWS Management Console ou AWS CLI.
## console
**Pour afficher les détails de la version CEV**
1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon RDS à l'adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Dans le panneau de navigation, choisissez **Custom engine versions** (Versions de moteur personnalisées).
La page **Custom engine versions** (Versions de moteur personnalisées) affiche toutes les CEV qui existent actuellement. Si vous n'avez pas créé de CEV, la page est vide.
1. Choisissez le nom de la version CEV que vous souhaitez consulter.
1. Choisissez **Configuration** pour afficher les détails.
![\[Affichez les détails de configuration d'une version CEV.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_viewdetails.PNG)
## AWS CLI
Pour afficher les détails d'une version CEV à l'aide d'AWS CLI, exécutez la commande [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html).
Vous pouvez également spécifier les options suivantes :
+ `--include-all`, pour afficher toutes les versions CEV, quel que soit leur état de cycle de vie. Sans l'option `--include-all`, seules les versions CEV dans un état de cycle de vie `available` seront renvoyées.
```
aws rds describe-db-engine-versions --engine custom-sqlserver-ee --engine-version 15.00.4249.2.my_cevtest --include-all
{
"DBEngineVersions": [
{
"Engine": "custom-sqlserver-ee",
"MajorEngineVersion": "15.00",
"EngineVersion": "15.00.4249.2.my_cevtest",
"DBParameterGroupFamily": "custom-sqlserver-ee-15.0",
"DBEngineDescription": "Microsoft SQL Server Enterprise Edition for custom RDS",
"DBEngineVersionArn": "arn:aws:rds:us-east-1:{my-account-id}:cev:custom-sqlserver-ee/15.00.4249.2.my_cevtest/a1234a1-123c-12rd-bre1-1234567890",
"DBEngineVersionDescription": "Custom SQL Server EE 15.00.4249.2 cev test",
"Image": {
"ImageId": "ami-0r93cx31t5r596482",
"Status": "pending-validation"
},
"DBEngineMediaType": "AWS Provided",
"CreateTime": "2022-11-20T19:30:01.831000+00:00",
"ValidUpgradeTarget": [],
"SupportsLogExportsToCloudwatchLogs": false,
"SupportsReadReplica": false,
"SupportedFeatureNames": [],
"Status": "pending-validation",
"SupportsParallelQuery": false,
"SupportsGlobalDatabases": false,
"TagList": [],
"SupportsBabelfish": false
}
]
}
```
Vous pouvez utiliser des filtres pour afficher les versions CEV ayant un certain statut de cycle de vie. Par exemple, pour afficher les CEV dont le statut de cycle de vie est `pending-validation`, `available` ou `failed` :
```
aws rds describe-db-engine-versions engine custom-sqlserver-ee
region us-west-2 include-all query 'DBEngineVersions[?Status == pending-validation ||
Status == available || Status == failed]'
```
# Suppression d'une version CEV pour RDS Custom for SQL Server
Vous pouvez supprimer une CEV à l'aide de la AWS Management Console ou de la AWS CLI. Cette tâche prend généralement quelques minutes.
Avant de supprimer une CEV, veillez à ce qu'elle ne soit pas utilisée par aucun des éléments suivants :
+ Une instance de base de données RDS Custom
+ Un instantané d'une instance de base de données RDS Custom
+ Une sauvegarde automatisée de votre instance de base de données RDS Custom
## Console
**Pour supprimer une CEV**
1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon RDS à l’adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Dans le panneau de navigation, choisissez **Custom engine versions** (Versions de moteur personnalisées).
1. Choisissez une CEV dont vous souhaitez supprimer la description ou l'état.
1. Pour **Actions**, choisissez **Supprimer**.
La boîte de dialogue **Delete *cev\$1name*?** (Supprimer cev\$1name ?) s'affiche.
1. Entrez **delete me**, puis choisissez **Delete (Supprimer)**.
Dans **Custom engine versions** (Versions de moteur personnalisées), la bannière indique que votre CEV est en cours de suppression.
## AWS CLI
Pour supprimer une CEV à l'aide de la AWS CLI, exécutez la commande [delete-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-custom-db-engine-version.html).
Les options suivantes sont requises :
+ `--engine custom-sqlserver-ee`
+ `--engine-version cev`, où *cev* représente le nom de la version de moteur personnalisée à supprimer
L'exemple suivant supprime une CEV nommée `15.00.4249.2.my_cevtest`.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds delete-custom-db-engine-version \
2. --engine custom-sqlserver-ee \
3. --engine-version 15.00.4249.2.my_cevtest
```
Pour Windows :
```
1. aws rds delete-custom-db-engine-version ^
2. --engine custom-sqlserver-ee ^
3. --engine-version 15.00.4249.2.my_cevtest
```