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

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

Einschränkungen bei der Benennung

Bei der Erstellung eines CEV müssen Sie bestimmte Benennungskonventionen beachten:

• 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: 16.00.4215.2.my-dev-cev für SQL Server 2022.

Verwenden Sie den folgenden Befehl, um alle unterstützten Engine-Versionen 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, 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"
        }
    ]
}

AWS CLI

Um die benutzerdefinierte Engine-Version zu erstellen

• Verwenden Sie den Befehl 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 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"

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

# 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

Lebenszyklus eines RDS für SQL Server CEV

Bei der Arbeit mit SQL Server Developer Edition auf RDS für SQL Server durchlaufen Ihre benutzerdefinierten Engine-Versionen verschiedene Lebenszyklusstatus.

Lebenszyklusstatus	Description	Wann es auftritt	Verfügbare Aktionen
noch ausstehende Validierung	Anfangszustand bei der Erstellung von CEV	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). Dieser asynchrone Vorgang kann einige Zeit in Anspruch nehmen.	Überwachen Sie den Status, bis die Überprüfung abgeschlossen ist.
available	Die Überprüfung 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 for SQL Server kann die Custom 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 Fehlerursache describe-db-engine-version unter, 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	Nach Kundenanrufen delete-custom-db-engine-version bis der Löschvorgang abgeschlossen ist.	Überwachen Sie den Status überdescribe-db-engine-version.
incompatible-installation-media	Amazon RDS konnte das für die benutzerdefinierte Engine-Version (CEV) bereitgestellte Installationsmedium nicht validieren	Die Validierung der Custom Engine Version (CEV) ist fehlgeschlagen. Diese ist ein Terminalstatus.	Informationen darüber, 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 Nutzung von einsehen: 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}'

Beispielausgabe für

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

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 16.00.4215.2.my-dev-cev \
--region us-west-2 \
--query 'DBEngineVersions[0].{Version:EngineVersion,Status:Status,FailureReason:FailureReason}'