

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.

# BYOM-Engine-Versionen für RDS for SQL Server erstellen und verwalten
<a name="sqlserver-byom-creating-cev"></a>

Das Erstellen einer BYOM-Engine-Version erfordert eine einmalige Einrichtung (Überprüfung der Lizenzmobilität, Abrufen der RTM-Medien und Hochladen auf S3). Nach der Einrichtung können Sie Engine-Versionen mithilfe der Amazon RDS-Konsole oder der CLI erstellen. AWS 

## Bevor Sie beginnen
<a name="sqlserver-byom-creating-cev.before-you-begin"></a>

### Schritt 1: Schließen Sie die Überprüfung von Microsoft License Mobility ab
<a name="sqlserver-byom-creating-cev.step1"></a>

Für BYOM ist die Lizenzmobilität durch Software Assurance erforderlich. Ihre SQL Server-Lizenzen müssen über einen aktiven Software Assurance-Schutz verfügen, bevor Sie sie bereitstellen können. AWS

Gehen Sie wie folgt vor, um den Überprüfungsprozess abzuschließen:

1. **Eignung überprüfen ** Besuchen Sie die Seite [AWS License Mobility](https://aws.amazon.com/windows/resources/licensemobility/), um die Anforderungen und Zulassungskriterien zu überprüfen.

1. **Senden Sie das Bestätigungsformular ** Laden Sie das [ Microsoft License Mobility-Bestätigungsformular herunter und füllen Sie es aus. ](https://www.microsoft.com/en-us/licensing/licensing-programs/software-assurance-license-mobility.aspx) Senden Sie das Formular über Ihren Lizenzpartner oder direkt an Microsoft.

1. **Warten Sie auf die Genehmigung ** Microsoft sendet Ihnen eine Bestätigungs-E-Mail, wenn Ihre Überprüfung genehmigt wurde.

Sie müssen das Formular innerhalb von 10 Tagen nach Lieferung der Produkte direkt oder über Ihren Microsoft-Händler bei Microsoft einreichen. AWS

**Wichtig**  
AWS bestätigt oder erzwingt nicht die Einhaltung der Microsoft-Lizenzbestimmungen. Sie sind dafür verantwortlich, die Einhaltung Ihrer Microsoft-Lizenzvereinbarungen aufrechtzuerhalten.

### Schritt 2: Besorgen Sie sich das SQL Server-Installationsmedium
<a name="sqlserver-byom-creating-cev.step2"></a>

Laden Sie die RTM-Datei (Release to Manufacturing) für die SQL Server-Hauptversion herunter, die Sie verwenden möchten. Die RTM-Datei ist das Basisinstallationsmedium für eine SQL Server-Hauptversion und -Edition (z. B. SQL Server 2019 Enterprise Edition).

Sie können die RTM-Datei aus einer der folgenden Microsoft-Quellen beziehen:
+ **Visual Studio-Abonnement ** Wenn Sie ein aktives Visual Studio-Abonnement haben, laden Sie die RTM-Datei von der Downloadseite für [ Abonnenten herunter. ](https://visualstudio.microsoft.com/subscriptions/)
+ **Microsoft 365 Admin Center ** Wenn Sie Produkte im Rahmen einer Volumenlizenzierung gekauft haben, laden Sie die RTM-Datei von der [ Microsoft 365 Admin Center-Downloadseite herunter. ](https://admin.microsoft.com)

**Wichtig**  
Laden Sie nur die englische Core-based ISO-Datei herunter. Verwenden Sie nicht die Server\+ CAL-based ISO-Datei.

**Wichtig**  
Laden Sie Installationsmedien für SQL Server 2019 Release to Manufacturing (RTM) (Standard- und Enterprise Core-Editionen) nur vom Microsoft 365 Admin Center herunter. Aus Visual Studio-Abonnements heruntergeladene SQL Server 2019-Medien werden nicht unterstützt. Für SQL Server 2022 und höher können Sie RTM-Installationsmedien entweder vom Microsoft 365 Admin Center oder von Visual Studio-Abonnements herunterladen.

### Schritt 3: Laden Sie die Installationsmedien auf Amazon S3 hoch
<a name="sqlserver-byom-creating-cev.step3"></a>

Laden Sie die SQL Server-RTM-Datei in einen Amazon S3-Bucket in derselben AWS Region und demselben Konto hoch, in dem Sie die BYOM-Engine-Version erstellen möchten. So laden Sie die RTM-Datei mit der CLI hoch: AWS 

```
aws s3 cp SQLServer2022-x64-ENU-Enterprise.iso s3://my-sqlserver-media/ISOs/
```

**Anmerkung**  
Wenn Sie bei der Erstellung der BYOM-Engine keine Cumulative Update (CU) -Datei bereitstellen, lädt Amazon RDS die erforderliche CU-Datei automatisch von Microsoft herunter, wenn Sie die Engine-Version erstellen.

## Eine BYOM-Engine-Version erstellen
<a name="sqlserver-byom-creating-cev.creating"></a>

Wird verwendet`describe-db-engine-versions`, um zu überprüfen, welche Engine-Versionen für die Erstellung einer BYOM-Engine-Version in Frage kommen. Informationen zu unterstützten Versionen finden Sie unter. [Bringen Sie Ihre eigenen Medien (BYOM) für RDS für SQL Server](sqlserver-byom.md)

### Konsole
<a name="sqlserver-byom-creating-cev.console"></a>

1. Melden Sie sich bei der [AWS Management Console an ](https://console.aws.amazon.com/rds/) und öffnen Sie die Amazon RDS-Konsole.

1. Wählen Sie im Navigationsbereich und dann aus.**Benutzerdefinierte Engine-Versionen**aus.

1. Wählen Sie in der Dropdownliste ** RDS for SQL Server ** aus.

1. Klicken Sie auf **Erstellen einer benutzerdefinierten Engine-Version**.

1. Wählen Sie als ** Engine-Typ ** die Option ** SQL Server ** aus.

1. Wählen Sie für **Datenbankverwaltungstyp** die Option **Amazon RDS** aus.

1. Wählen Sie für ** Edition ** eine der folgenden Optionen aus: 
   + SQL Server Enterprise Edition
   + SQL Server Standard Edition

1. Wählen Sie für die ** Engine-Version ** die SQL Server-Version aus, die Ihren Installationsdateien entspricht (z. B. SQL Server 2022 `16.00.4175.1.v1` oder SQL Server 2025`17.00.4045.5.v1`).

1. Geben Sie für ** Installationsmedien ** die S3-URI ein, die Ihre SQL Server-RTM-Medien enthält, oder wählen Sie S3 ** durchsuchen, ** um die Datei zu suchen und auszuwählen.

1. Klicken Sie auf **Erstellen einer benutzerdefinierten Engine-Version**.

In der Konsole wird die neue BYOM-Engine-Version mit dem Anfangsstatus Ausstehende Validierung angezeigt. ** ** Der Status wird automatisch aktualisiert. Weitere Informationen finden Sie unter [Lebenszyklusstatus der BYOM-Engine-Version](#sqlserver-byom-creating-cev.lifecycle).

### CLI
<a name="sqlserver-byom-creating-cev.cli"></a>

Verwenden Sie den `create-custom-db-engine-version` Befehl, um eine BYOM-Engine-Version von Ihrem Installationsmedium zu erstellen. Amazon RDS lädt das erforderliche kumulative Update automatisch von Microsoft herunter.

```
aws rds create-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --database-installation-files-s3-bucket-name my-sqlserver-media \
    --database-installation-files-s3-prefix "ISOs/" \
    --database-installation-files "SQLServer2022-x64-ENU-Enterprise.iso"
```

**Antwort**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    "DatabaseInstallationFiles": [
        "SQLServer2022-x64-ENU-Enterprise.iso"
    ],
    "DBEngineDescription": "Microsoft SQL Server Enterprise Edition",
    "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:sqlserver-ee/16.00.4175.1.v1/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    ....
    "Status": "pending-validation",
    .....
}
```

**CLI-Parameter **


| Parameter | Erforderlich | Beschreibung | 
| --- | --- | --- | 
| --engine | Ja | Der Typ der Datenbank-Engine:sqlserver-ee,sqlserver-se. | 
| --engine-version | Ja | Die Version der Ziel-Engine (z. B.16.00.4175.1.v1). | 
| --database-installation-files-s3-bucket-name | Ja | Der Name des S3-Buckets, der Ihre Installationsmedien enthält. Der Bucket muss sich in derselben AWS Region wie die BYOM-Engine-Version befinden. | 
| --database-installation-files-s3-prefix | Nein | Das S3-Schlüsselpräfix (Ordnerpfad), in dem die Installationsmediendateien gespeichert sind. | 
| --database-installation-files | Ja | Die Dateinamen der Installationsmedien. | 

**Anmerkung**  
Wenn Sie die AWS CLI verwenden, sind die `--database-installation-files-s3-bucket-name` `--database-installation-files` Parameter`--database-installation-files-s3-prefix`, und nur für die erste BYOM-Engine-Version erforderlich, die Sie für eine Hauptversion und Edition erstellen. Nur für nachfolgende Nebenversionen innerhalb derselben Hauptversion `--engine-version` sind `--engine` und erforderlich.

## Beschreibung der BYOM-Engine-Versionen
<a name="sqlserver-byom-creating-cev.describing"></a>

Nachdem Sie eine BYOM-Engine-Version erstellt haben, verwenden Sie diese, `describe-db-engine-versions` um deren Status und Details zu überprüfen. Die Ausgabe gibt zwei Datensätze für dieselbe Engine-Version zurück: einen für License Included (`DBEngineMediaType: None`) und einen für BYOM (). `DBEngineMediaType: Customer Provided`

**Beispiel:**

```
aws rds describe-db-engine-versions \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --include-all \
    --output table \
    --query "DBEngineVersions[].{Engine: Engine, Version: EngineVersion, Status: Status, MediaType: DBEngineMediaType}"
```

**Antwort:**

```
-----------------------------------------------------------------------
|                      DescribeDBEngineVersions                       |
+--------------+---------------------+------------+-------------------+
|    Engine    |      MediaType      |  Status    |      Version      |
+--------------+---------------------+------------+-------------------+
|  sqlserver-ee|  None               |  available |  16.00.4175.1.v1  |
|  sqlserver-ee|  Customer Provided  |  available |  16.00.4175.1.v1  |
+--------------+---------------------+------------+-------------------+
```

## Lebenszyklusstatus der BYOM-Engine-Version
<a name="sqlserver-byom-creating-cev.lifecycle"></a>


| Status | Description | 
| --- | --- | 
| pending-validation | RDS akzeptierte die Anfrage und stellte sie zur Verarbeitung in eine Warteschlange. | 
| validating | RDS validiert die RTM-Mediendatei. | 
| creating | RDS installiert SQL Server aus einer RTM-Mediendatei. | 
| available | Die BYOM-Engine-Version ist bereit für die Instanzerstellung. | 
| incompatible\_installation\_media | Die Installationsdateien sind ungültig oder beschädigt. Diese ist ein Terminalstatus. Löschen Sie die BYOM-Engine-Version und versuchen Sie es erneut mit den richtigen Dateien. | 

## Ändern einer BYOM-Engine-Version
<a name="sqlserver-byom-creating-cev.modifying"></a>

Sie können eine BYOM-Engine-Version mithilfe der AWS Managementkonsole oder der CLI ändern. AWS Sie können die Versionsbeschreibung der BYOM-Engine oder ihren Verfügbarkeitsstatus ändern. Ihre BYOM-Engine-Version hat einen der folgenden Statuswerte:
+ **verfügbar ** — Sie können diese BYOM-Engine-Version verwenden, um eine neue DB-Instance zu erstellen oder eine DB-Instance zu aktualisieren. Dies ist der Standardstatus für eine neu erstellte BYOM-Engine-Version.
+ **inaktiv ** — Mit dieser BYOM-Engine-Version können Sie keine DB-Instance erstellen oder aktualisieren. Mit dieser BYOM-Engine-Version können Sie keinen DB-Snapshot wiederherstellen, um eine neue DB-Instance zu erstellen.

Sie können den Status der BYOM-Engine-Version von bis oder von `available` bis `inactive` ändern. `inactive` `available` Sie können den Status ändern, `inactive` um die versehentliche Verwendung einer BYOM-Engine-Version zu verhindern oder um eine eingestellte BYOM-Engine-Version wieder zur Verwendung in Frage zu stellen.

```
aws rds modify-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --status inactive
```

**Antwort**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    ....
    "Status": "inactive",
    ....
}
```

**Anmerkung**  
Bestehende Instances, die auf einer BYOM-Engine-Version laufen, die Sie auf inaktiv gesetzt haben, funktionieren weiterhin normal. Nur Vorgänge zur Erstellung und Wiederherstellung neuer Instanzen sind betroffen.

## Löschen einer BYOM-Engine-Version
<a name="sqlserver-byom-creating-cev.deleting"></a>

Wird verwendet`delete-custom-db-engine-version`, um eine BYOM-Engine-Version dauerhaft zu entfernen. Nach dem Löschen kehrt die Engine-Version zu einem einzigen LI-only Eintrag zurück.

**Voraussetzungen für das Löschen **

Bevor Sie eine BYOM-Engine-Version löschen können, stellen Sie Folgendes sicher:
+ Keine DB-Instances verwenden die BYOM-Version.
+ Keine DB-Snapshots verweisen auf die BYOM-Version.

Wenn eine der RDS-Ressourcen vorhanden ist, schlägt die API die Löschanforderung fehl.

**Löschen einer BYOM-Engine-Version (CLI) **

```
aws rds delete-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1
```

**Antwort**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    .....
    "Status": "deleting",
    ....
}
```

## Überlegungen
<a name="sqlserver-byom-creating-cev.considerations"></a>
+ Sie stellen die RTM-ISO-Datei einmal pro Hauptversion und Edition bereit. Für alle Nebenversionen innerhalb derselben Hauptversion und Edition werden dieselben Installationsmedien wiederverwendet.
+ Wenn Sie Ihr SQL Server-RTM für Bring Your Own Media bereitstellen, dürfen Sie nur die Core-based RTM-ISO-Datei verwenden und nicht die auf Server\+ CAL basierende RTM-ISO-Datei.

## Nächste Schritte
<a name="sqlserver-byom-creating-cev.next-steps"></a>

Sobald Ihre BYOM-Engine-Version `available` den Status erreicht hat, können Sie damit eine RDS for SQL Server-Instanz starten. Siehe [Erstellen einer BYOM-DB-Instance für RDS für SQL Server](sqlserver-byom-creating-instance.md).