Création d'une version de moteur personnalisée pour RDS pour SQL Server - Amazon Relational Database Service

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

Une version de moteur personnalisée (CEV) pour RDS pour SQL Server comprend le 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 le téléchargement effectué, vous devez fournir l'emplacement Amazon S3 à RDS pour qu'il puisse télécharger, valider puis créer votre CEV.

Limites de dénomination

Lorsque vous créez un CEV, vous devez suivre des conventions de dénomination spécifiques :

  • Le nom du CEV doit suivre le modèle. major-version.minor-version.customized-string

  • customized-stringpeut contenir de 1 à 50 caractères alphanumériques, des traits de soulignement, des tirets et des points. Par exemple : 16.00.4215.2.my-dev-cev pour SQL Server 2022.

Pour répertorier toutes les versions de moteur prises en charge, utilisez la 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, DBEngineVersionDescription: DBEngineVersionDescription}}" { "DBEngineVersions": [ { "Engine": "sqlserver-dev-ee", "EngineVersion": "16.00.4215.2.v1", "Status": "requires-custom-engine-version", "DBEngineDescription": "Microsoft SQL Server Enterprise Developer Edition", "DBEngineVersionDescription": "SQL Server 2022 16.00.4215.2.v1" } ] }
Pour créer la version personnalisée du moteur
  • Utilisez la commande 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 16.00.4215.2.cev-dev-ss2022-cu21 \ --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 "SQLServer2022-x64-ENU-Dev.iso" "SQLServer2022-KB5065865-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 :

# Check CEV status aws rds describe-db-engine-versions \ --engine sqlserver-dev-ee \ --engine-version 16.00.4215.2.my-dev-cev \ --region us-west-2

Cycle de vie d'un RDS pour SQL Server CEV

Lorsque vous travaillez avec SQL Server Developer Edition sur RDS pour SQL Server, les versions de votre moteur personnalisé 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 avec la create-custom-db-engine-version commande.

Surveillez l'état viadescribe-db-engine-version.

validation

État de validation CEV

Amazon RDS est en train de valider votre version de moteur personnalisée (CEV). Ce processus asynchrone peut prendre un certain temps.

Surveillez le statut 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 votre ISO SQL Server et vos fichiers de mise à jour cumulative. 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 ISO et cumulative des supports a échoué. 

La validation ISO a échoué. Vérifiez la raison de l'échecdescribe-db-engine-version, corrigez les problèmes de fichiers tels que les incohérences de hachage ou le contenu corrompu, puis recréez votre version de moteur personnalisée (CEV).

deleting

La version personnalisée du moteur (CEV) est supprimée

Après l'appel du client delete-custom-db-engine-version jusqu'à ce que le flux de suppression soit terminé.

Surveillez l'état viadescribe-db-engine-version.

incompatible-installation-media

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.

Consultez FailureReason via describe-db-engine-versions pour savoir pourquoi la validation a échoué ; supprimez le CEV.

Décrire le statut du CEV

Vous pouvez voir l'état de votre appareil CEVs en utilisant AWS CLI :

aws rds describe-db-engine-versions \ --engine sqlserver-dev-ee \ --engine-version 16.00.4215.2.my-dev-cev \ --region us-west-2 \ --query 'DBEngineVersions[0].{Version:EngineVersion,Status:Status}'

Exemple de sortie.

| DescribeDBEngineVersions | +------------+---------------------------------+ | Status | Version | +------------+---------------------------------+ | available | 16.00.4215.2.cev-dev-ss2022-cu21 | +------------+---------------------------------+

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

aws rds describe-db-engine-versions \ --engine sqlserver-dev-ee \ --engine-version 16.00.4215.2.my-dev-cev \ --region us-west-2 \ --query 'DBEngineVersions[0].{Version:EngineVersion,Status:Status,FailureReason:FailureReason}'