Erstellen einer benutzerdefinierten Engine-Version für RDS für SQL Server

Eine benutzerdefinierte Engine-Version (CEV) für RDS for SQL Server besteht aus Ihrem SQL Server Developer Edition-Installationsmedium, das in Amazon RDS importiert wurde. Es ist notwendig, das Basis-ISO-Installationsprogramm und die kumulativen Aktualisierungsdateien (.exe) in Ihren Amazon S3-Bucket hochzuladen. Nach dem Hochladen sollten Sie RDS den Amazon S3-Speicherort zur Verfügung stellen, damit es Ihr CEV herunterladen, validieren und anschließend erstellen kann.

Einschränkungen bei der Benennung

Beim Erstellen eines CEV müssen Sie bestimmte Namenskonventionen einhalten:

• Der CEV-Name muss dem Muster folgen. major-version.minor-version.customized-string

• customized-stringkann 1—50 alphanumerische Zeichen, Unterstriche, Bindestriche und Punkte enthalten. Zum Beispiel: 17.00.4045.5.my-dev-cev für SQL Server 2025.

Verwenden Sie den folgenden AWS CLI Befehl, um alle unterstützten Engine-Versionen für die Developer Edition (Funktionen der Enterprise Edition) aufzulisten:

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

Verwenden Sie den folgenden AWS CLI Befehl, um alle unterstützten Engine-Versionen für die Developer Edition (Funktionen der Standard Edition) aufzulisten:

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

AWS CLI

Um eine benutzerdefinierte Engine-Version für die Developer Edition (Funktionen der Enterprise Edition) zu erstellen

• Verwenden Sie den Befehl https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html create-custom-db-engine-version.

  Die folgenden Optionen sind erforderlich:

  • --engine

  • --engine-version

  • --database-installation-files-s3-bucket-name

  • --database-installation-files

  • --region

  Sie können auch die folgenden Optionen angeben:

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

Um eine benutzerdefinierte Engine-Version für die Developer Edition zu erstellen (Funktionen der Standard Edition)

• Verwenden Sie den Befehl https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html create-custom-db-engine-version mit. --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"

Die CEV-Erstellung dauert in der Regel 15 bis 30 Minuten. Verwenden Sie den folgenden Befehl, um den Fortschritt der CEV-Erstellung zu überwachen:

# 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

Lebenszyklus eines RDS für SQL Server CEV

Wenn Sie mit der SQL Server Developer Edition auf RDS für SQL Server arbeiten, durchlaufen Ihre benutzerdefinierten Engine-Versionen verschiedene Lebenszykluszustände.

Status des Lebenszyklus	Description	Wann tritt es auf	Verfügbare Aktionen
Ausstehende Validierung	Anfangszustand, wenn CEV erstellt wird	Dies ist der Anfangszustand nach der Erstellung mit dem create-custom-db-engine-version Befehl.	Überwachen Sie den Status überdescribe-db-engine-version.
Validierung	Status der CEV-Validierung	Amazon RDS validiert Ihre benutzerdefinierte Engine-Version (CEV). Es kann einige Zeit dauern, bis dieser asynchrone Vorgang abgeschlossen ist.	Überwachen Sie den Status, bis die Validierung abgeschlossen ist.
available	Die Validierung der benutzerdefinierten Engine-Version (CEV) wurde erfolgreich abgeschlossen.	Die benutzerdefinierte Engine-Version (CEV) ist jetzt verfügbar. Amazon RDS hat Ihre SQL Server-ISO- und kumulativen Aktualisierungsdateien erfolgreich validiert. Sie können jetzt DB-Instances mit diesem CEV erstellen.	Erstellen Sie DB-Instances mit diesem CEV
failed	RDS für SQL Server kann die benutzerdefinierte Engine-Version (CEV) nicht erstellen, da die Validierungsprüfung fehlgeschlagen ist.	Die ISO- und kumulative Medienvalidierung ist fehlgeschlagen.	Die ISO-Validierung ist fehlgeschlagen. Überprüfen Sie die Fehlerursachedescribe-db-engine-version, beheben Sie alle Dateiprobleme wie Hash-Abweichungen oder beschädigte Inhalte und erstellen Sie dann Ihre benutzerdefinierte Engine-Version (CEV) neu.
deleting	Die benutzerdefinierte Engine-Version (CEV) wird gelöscht	Nachdem der Kunde angerufen hatdelete-custom-db-engine-version, bis der Löschvorgang abgeschlossen ist.	Überwachen Sie den Status überdescribe-db-engine-version.
inkompatible Installationsmedien	Amazon RDS konnte die für die benutzerdefinierte Engine-Version (CEV) bereitgestellten Installationsmedien nicht überprüfen	Die Validierung der benutzerdefinierten Engine-Version (CEV) ist fehlgeschlagen. Diese ist ein Terminalstatus.	Informationen dazu, warum die Validierung fehlgeschlagen ist, finden Sie unter FailureReason viadescribe-db-engine-versions. Löschen Sie CEV.

Beschreiben Sie den CEV-Status

Sie können den Status Ihrer CEVs anhand der folgenden Optionen einsehen: 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}'

Ersetzen sqlserver-dev-ee Sie für die Developer Edition (Funktionen der Standard Edition) durch. sqlserver-dev-se

Beispielausgabe für

| DescribeDBEngineVersions                          |
+------------+--------------------------------------+
| Status | Version                                  |
+------------+--------------------------------------+
| available | 17.00.4045.5.cev-dev-ss2025-cu5         |
+------------+--------------------------------------+

Wenn ein CEV failed den Status anzeigt, können Sie den Grund mit dem folgenden Befehl ermitteln:

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