View a markdown version of this page

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

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

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 viadescribe-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'échecdescribe-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 viadescribe-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

Vous pouvez consulter l'état de vos CEV à l'aide des outils suivants : AWS CLI

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

Pour Developer Edition (fonctionnalités de l'édition Standard), remplacez sqlserver-dev-ee parsqlserver-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 :

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