

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 und Verwalten von BYOM-Engine-Versionen für RDS for SQL Server
<a name="sqlserver-byom-creating-cev"></a>

Die Erstellung einer BYOM-Engine-Version erfordert eine einmalige Einrichtung (License Mobility-Überprüfung, Abrufen von RTM-Medien und Hochladen auf S3). Nach der Einrichtung können Sie Engine-Versionen mit der Amazon RDS-Konsole oder der AWS CLI erstellen.

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

### Schritt 1: Vollständige Überprüfung von Microsoft License Mobility
<a name="sqlserver-byom-creating-cev.step1"></a>

Für BYOM ist die Lizenzmobilität durch Software Assurance erforderlich. Sie müssen über einen aktiven Software Assurance-Schutz für Ihre SQL Server-Lizenzen verfügen, bevor Sie sie auf 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 Bestätigung bestätigt wurde.

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

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

### Schritt 2: Besorgen Sie sich die SQL Server-Installationsmedien
<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 über ein aktives Visual Studio-Abonnement verfügen, 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 erworben haben, laden Sie die RTM-Datei von der [Downloadseite des Microsoft 365 Admin Center 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.

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

Laden Sie die SQL Server-RTM-Datei in einen Amazon S3 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 AWS CLI hoch:

```
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 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](https://console.aws.amazon.com/rds/) an und öffnen Sie die Amazon RDS-Konsole.

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

1. Wählen Sie aus 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 als **Engine-Version** die SQL Server-Version aus, die Ihren Installationsdateien entspricht (z. B. SQL Server 2022`16.00.4175.1.v1`).

1. Geben Sie als **Installationsmedium** den S3-URI ein, der Ihr SQL Server-RTM-Medium 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 Überprüfung angezeigt.** Der Status wird automatisch weiterentwickelt. Weitere Informationen finden Sie unter [Status des Lebenszyklus 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 Datenbank-Engine-Typ: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 Ihr Installationsmedium enthält. Der Bucket muss sich in derselben AWS Region befinden wie die BYOM-Engine-Version. | 
| --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 sie `--engine` erforderlich.

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

Nachdem Sie eine BYOM-Engine-Version erstellt haben, können Sie `describe-db-engine-versions` sie verwenden, 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  |
+--------------+---------------------+------------+-------------------+
```

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


| Status | Description | 
| --- | --- | 
| pending-validation | RDS hat die Anfrage akzeptiert und zur Bearbeitung in eine Warteschlange gestellt. | 
| 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 Management Console oder der AWS CLI ändern. 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** — Sie können mit dieser BYOM-Engine-Version keine DB-Instance erstellen oder aktualisieren. Sie können keinen DB-Snapshot wiederherstellen, um eine neue DB-Instance mit dieser BYOM-Engine-Version zu erstellen.

Sie können den Versionsstatus der BYOM-Engine 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 abgekündigte BYOM-Engine-Version wieder nutzbar zu machen.

```
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 Instanzen, die auf einer BYOM-Engine-Version ausgeführt werden, 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, müssen Sie Folgendes sicherstellen:
+ 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 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 und nicht die auf Server \+ CAL basierende RTM-ISO-Datei verwenden.

## 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 for SQL Server](sqlserver-byom-creating-instance.md).