Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# 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-string`kann 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](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html).
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 über`describe-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 über`describe-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 via`describe-db-engine-versions`. Löschen Sie CEV. |
### Beschreiben Sie den CEV-Status
Sie können den Status Ihrer CEVs Nutzung von einsehen: AWS CLI
```
1. aws rds describe-db-engine-versions \
2. --engine sqlserver-dev-ee \
3. --engine-version 16.00.4215.2.my-dev-cev \
4. --region us-west-2 \
5. --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:
```
1. aws rds describe-db-engine-versions \
2. --engine sqlserver-dev-ee \
3. --engine-version 16.00.4215.2.my-dev-cev \
4. --region us-west-2 \
5. --query 'DBEngineVersions[0].{Version:EngineVersion,Status:Status,FailureReason:FailureReason}'
```