

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.

# Datenmigration von einer RDS-for-PostgreSQL-DB-Instance zu einem Aurora-PostgreSQL-DB-Cluster unter Verwendung eines Aurora–Lesereplikats
<a name="AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica"></a>

Sie können eine RDS-for-PostgreSQL-DB-Instance als Grundlage für einen neuen Aurora-PostgreSQL-DB-Cluster verwenden, indem Sie eine Aurora-Lesereplikat für den Migrationsprozess verwenden. Die Aurora-Read-Replica-Option ist nur für die Migration innerhalb desselben AND-Kontos verfügbar AWS-Region und nur verfügbar, wenn die Region eine kompatible Version von Aurora PostgreSQL für Ihre RDS for PostgreSQL-DB-Instance anbietet. *Kompatibel* bedeutet, dass die Aurora-PostgreSQL-Version mit der RDS-for-PostgreSQL-Version identisch ist oder dass es sich um eine höhere Nebenversion in derselben Hauptversionsfamilie handelt.

Um diese Technik beispielsweise zum Migrieren einer RDS-for-PostgreSQL-11.14-DB-Instance verwenden zu können, muss die Region Aurora PostgreSQL Version 11.14 oder eine höhere Nebenversion in der PostgreSQL-Version-11-Familie anbieten. 

**Topics**
+ [Übersicht über das Migrieren von Daten mittels einer Aurora-Read Replica](#AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.Intro)
+ [Vorbereiten der Migration von Daten mithilfe einer Aurora Read Replica](#AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.Prepare)
+ [Erstellen einer Aurora Read Replica](#AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.Create)
+ [Hochstufen einer Aurora Read Replica](#AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.Promote)

## Übersicht über das Migrieren von Daten mittels einer Aurora-Read Replica
<a name="AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.Intro"></a>

Migrieren von einer RDS-for-PostgreSQL-DB-Instance zu einem Aurora-PostgreSQL-DB-Cluster ist ein mehrstufiges Verfahren. Zuerst erstellen Sie ein Aurora-Lesereplikat Ihrer Quell-RDS-Instance-for-PostgreSQL-DB-Instance. Dies startet einen Replikationsprozess von Ihrer RDS-for-PostgreSQL-DB-Instance zu einem speziellen DB-Cluster, der als **Replikat*-Cluster* bekannt ist. Der Replikat-Cluster besteht ausschließlich aus einem Aurora-Lesereplikat (einer Reader-Instance). 

**Anmerkung**  
Es kann mehrere Stunden pro Terabyte Daten dauern, bis die Migration abgeschlossen ist. 

**Hochstufen eines Aurora-PostgreSQL-Replikats**

Nachdem Sie einen DB-Cluster von Aurora PostgreSQL erstellt haben, gehen Sie wie folgt vor, um das Aurora-Replikat hochzustufen:

1. Halten Sie den gesamten Datenbank-Schreib-Workload auf der Quell-DB-Instance von RDS für PostgreSQL an.

1. Rufen Sie die aktuelle `WAL LSN` aus der Quell-DB-Instance von RDS für PostgreSQL ab.

   ```
   SELECT pg_current_wal_lsn();
   pg_current_wal_lsn
   --------------------
   0/F0000318
   (1 row)
   ```

1. Überprüfen Sie auf dem Replikat-Cluster von Aurora PostgreSQL, ob die wiedergegebene LSN größer ist als die LSN aus Schritt 2:

   ```
   SELECT pg_last_wal_replay_lsn();
   pg_last_wal_replay_lsn
   ------------------------
   0/F0000400
   (1 row)
   ```

   Alternativ können Sie die folgende Abfrage auf der Quell-DB-Instance von RDS für PostgreSQL verwenden:

   ```
   SELECT restart_lsn FROM pg_replication_slots;
   ```

1. Stufen Sie den Replikat-Cluster von Aurora PostgreSQL hoch.

   Wenn die Replikation anhält, wird der Replikat-Cluster zu einem eigenständigen DB-Cluster von Aurora PostgreSQL und der Leser zur Schreiber-Instance für den Cluster hochgestuft. Nun können Sie Instances zum DB-Cluster von Aurora PostgreSQL hinzufügen, um dessen Größe Ihrem Anwendungsfall entsprechend anpassen. Wenn Sie die ursprüngliche DB-Instance von RDS für PostgreSQL nicht mehr benötigen, können Sie sie löschen.

Sie können kein Aurora-Lesereplikat erstellen, falls die RDS-for-PostgreSQL-DB-Instance bereits über ein Aurora-Lesereplikat verfügt oder ein regionsübergreifendes Lesereplikat enthält. 

## Vorbereiten der Migration von Daten mithilfe einer Aurora Read Replica
<a name="AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.Prepare"></a>

**Anmerkung**  
Bei der Vorbereitung der Migration von Daten zu Aurora PostgreSQL ist es wichtig, Tabellen ohne Protokollierung zu identifizieren und angemessen zu handhaben. Weitere Informationen finden Sie unter [Handhaben von Tabellen ohne Protokollierung während der Migration](aurora-postgresql-unlogged-tables.md#aurora-postgresql-unlogged-tables-migration).

Während des Migrationsprozesses mit Aurora-Lesereplikat werden Aktualisierungen, die mit den Daten der Quell-RDS-for-PostgreSQL-DB-Instance vorgenommen werden, asynchron in diesem Aurora-Lesereplikat des Replica-Clusters repliziert. Der Prozess verwendet die native Streaming-Replikationsfunktion von PostgreSQL, die Write-Ahead-Log-Segmente (WAL) auf der Quell-Instance speichert. Bevor Sie mit diesem Migrationsprozess beginnen, stellen Sie sicher, dass die Instance über genügend Speicherkapazität verfügt, indem Sie die Werte für die in der Tabelle aufgeführten Metriken überprüfen. 


| Metrik | Beschreibung | 
| --- | --- | 
|  `FreeStorageSpace`  |  Den verfügbaren Speicherplatz. Einheiten: Byte  | 
|  `OldestReplicationSlotLag`  |  Der Verzögerungsgröße für WAL-Daten in der Replika, die die höchste Verzögerung aufweist. Einheiten: Megabyte  | 
|  `RDSToAuroraPostgreSQLReplicaLag`  |  Die Zeit in Sekunden, wie lange ein Aurora PostgreSQL-DB-Cluster hinter der RDS-DB-Quell-Instance liegt.  | 
|  `TransactionLogsDiskUsage`  |  Der von den Transaktionsprotokollen verwendete Festplattenspeicher. Einheiten: Megabyte  | 

Weitere Informationen zur Überwachung Ihrer RDS-Instance finden Sie unter [Überwachung](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Monitoring.html) im *Amazon-RDS-Benutzerhandbuch*.

## Erstellen einer Aurora Read Replica
<a name="AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.Create"></a>

Sie können eine Aurora-Read Replica für eine RDS for PostgreSQL-DB-Instance erstellen, indem Sie den oder den AWS-Managementkonsole verwenden. AWS CLI Die Option zum Erstellen einer Aurora-Read Replica mit dem AWS-Managementkonsole ist nur verfügbar, wenn das eine kompatible Aurora PostgreSQL-Version AWS-Region anbietet. Das heißt, es ist nur verfügbar, wenn es eine Aurora-PostgreSQL-Version gibt, die mit der RDS-for-PostgreSQL-Version oder einer höheren Nebenversion in derselben Hauptversionsfamilie identisch ist.

### Konsole
<a name="AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.Create.Console"></a>

**Sie erstellen Sie eine Aurora Read Replica aus einer PostgreSQL-DB-Instance**

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

1. Wählen Sie im Navigationsbereich **Datenbanken** aus. 

1. Wählen Sie die RDS-for-PostgreSQL-DB-Instance aus, die Sie als Quelle für Ihr Aurora-Lesereplikat verwenden möchten. Wählen Sie für **Actions (Aktionen)** **Create Aurora read replica (Aurora Read Replica erstellen)** aus. Wenn diese Auswahl nicht angezeigt wird, bedeutet dies, dass eine kompatible Aurora-PostgreSQL-Version in der Region nicht verfügbar ist.   
![\[Erstellen einer Aurora-Read Replicas\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/Aurorapgres-migrate.png)

1. Auf der Seite Einstellungen für Aurora-Lesereplikat erstellen konfigurieren Sie die Eigenschaften für den Aurora-PostgreSQL-DB-Cluster wie in der folgenden Tabelle dargestellt. Das Replica-DB-Cluster wird aus einem Snapshot der Quell-DB-Instance unter Verwendung des gleichen Master-Benutzernamens und Kennworts wie die Quelle erstellt, sodass Sie diese derzeit nicht ändern können.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.html)

1. Wählen Sie **Read Replica erstellen** aus.

### AWS CLI
<a name="AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.Create.CLI"></a>

Um mithilfe von eine Aurora-Read Replica aus einer RDS-Quell-DB-Instance für PostgreSQL zu erstellen, verwenden Sie zunächst den [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html)CLI-Befehl AWS CLI, um einen leeren Aurora-DB-Cluster zu erstellen. Sobald der DB-Cluster existiert, verwenden Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html), um die primäre Instance für Ihren DB-Cluster zu erstellen. Die primäre Instance ist die erste in einem Aurora-DB-Cluster erstellte Instance. In diesem Fall wird sie zunächst als Aurora-Lesereplikat Ihrer RDS-for-PostgreSQL-DB-Instance erstellt. Wenn der Prozess abgeschlossen wird, wurde Ihre RDS-for-PostgreSQL-DB-Instance effektiv zu einem Aurora-PostgreSQL-DB-Cluster migriert.

Sie müssen das Hauptbenutzerkonto (normalerweise `postgres`), sein Passwort oder den Datenbanknamen nicht angeben. Die Aurora-Read Replica bezieht diese automatisch von der Quell-RDS für PostgreSQL-DB-Instance, die Sie beim Aufrufen der Befehle identifizieren. AWS CLI 

Sie müssen allerdings die Engine-Version angeben, die für den Aurora-PostgreSQL-DB-Cluster und die DB-Instance verwendet werden soll. Die von Ihnen angegebene Version sollte mit der Quell-DB-Instance von RDS für PostgreSQL übereinstimmen. Wenn die Quell-DB-Instance von RDS für PostgreSQL verschlüsselt ist, müssen Sie auch die Verschlüsselung für die primäre Instance des Aurora-PostgreSQL-DB-Clusters angeben. Die Migration einer verschlüsselten Instance zu einem unverschlüsselten Aurora-DB-Cluster wird nicht unterstützt. 

In den folgenden Beispielen wird ein Aurora-PostgreSQL-DB-Cluster mit dem Namen `my-new-aurora-cluster` erstellt, der eine unverschlüsselte RDS-DB-Quell-Instance verwenden soll. Sie erstellen zuerst den Aurora-PostgreSQL-DB-Cluster, indem Sie den CLI-Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) aufrufen. Das Beispiel zeigt, wie Sie den optionalen Parameter `--storage-encrypted ` verwenden, um anzugeben, dass der DB-Cluster verschlüsselt werden soll. Da die Quell-DB nicht verschlüsselt ist, wird `--kms-key-id` verwendet, um den zu verwendenden Schlüssel anzugeben. Weitere Informationen zu den erforderlichen und optionalen Parametern finden Sie in der Liste, die auf das Beispiel folgt.

Für Linux, macOS oder Unix:

```
aws rds create-db-cluster  \
    --db-cluster-identifier my-new-aurora-cluster \
    --db-subnet-group-name my-db-subnet
    --vpc-security-group-ids sg-11111111 
    --engine aurora-postgresql \
    --engine-version same-as-your-rds-instance-version \
    --replication-source-identifier arn:aws:rds:aws-region:111122223333:db/rpg-source-db \
    --storage-encrypted \
    --kms-key-id arn:aws:kms:aws-region:111122223333:key/11111111-2222-3333-444444444444
```

Für Windows:

```
aws rds create-db-cluster  ^
    --db-cluster-identifier my-new-aurora-cluster ^
    --db-subnet-group-name my-db-subnet ^
    --vpc-security-group-ids sg-11111111 ^
    --engine aurora-postgresql ^
    --engine-version same-as-your-rds-instance-version ^
    --replication-source-identifier arn:aws:rds:aws-region:111122223333:db/rpg-source-db ^
    --storage-encrypted ^
    --kms-key-id arn:aws:kms:aws-region:111122223333:key/11111111-2222-3333-444444444444
```

In der folgenden Liste finden Sie weitere Informationen zu einigen der im Beispiel gezeigten Optionen. Sofern nicht anders angegeben, sind diese Parameter erforderlich.
+ `--db-cluster-identifier` – Sie müssen Ihrem neuen Aurora-PostgreSQL-DB-Cluster einen Namen geben.
+ `--db-subnet-group-name` – Erstellen Sie Ihren Aurora-PostgreSQL-DB-Cluster im selben DB-Subnetz wie die DB-Quell-Instance.
+ `--vpc-security-group-ids` – Legen Sie die Sicherheitsgruppe für Ihren Aurora-PostgreSQL-DB-Cluster fest. 
+ `--engine-version` – Legen Sie die Version fest, die Sie für den Aurora-PostgreSQL-DB-Cluster verwenden möchten. Dies sollte die gleiche Version oder eine höhere Nebenversion sein wie die Version, die von Ihrer Quell-DB-Instance von RDS für PostgreSQL verwendet wird. 
+ `--replication-source-identifier` – Identifizieren Sie Ihre RDS-for-PostgreSQL-DB-Instance über den Amazon-Ressourcennamen (ARN). Weitere Informationen zu Amazon RDS ARNs finden Sie unter [Amazon Relational Database Service (Amazon RDS)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-rds) in der *Allgemeine AWS-Referenz*. Ihres DB-Clusters.
+ `--storage-encrypted` – Optional. Verwenden Sie diese Option, wenn die Verschlüsselung wie folgt angegeben werden muss:
  + Verwenden Sie diesen Parameter, wenn die Quell-DB-Instance über verschlüsselten Speicher verfügt. Der Aufruf von [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) schlägt fehl, wenn Sie diesen Parameter nicht mit einer Quell-DB-Instance verwenden, die über verschlüsselten Speicher verfügt. Wenn Sie einen anderen Schlüssel für den Aurora-PostgreSQL-DB-Cluster verwenden möchten als den von der Quell-DB-Instance verwendeten Schlüssel, müssen Sie auch die `--kms-key-id` angeben. 
  + Verwenden Sie diese Option, wenn der Speicher der Quell-DB-Instance unverschlüsselt ist, der Aurora-PostgreSQL-DB-Cluster jedoch die Verschlüsselung verwenden soll. In diesem Fall müssen Sie auch den Verschlüsselungsschlüssel identifizieren, der mit dem `--kms-key-id`-Parameter verwendet werden soll.
+ `--kms-key-id` – Optional. Wenn Sie diese Option verwenden, können Sie den Schlüssel angeben, der für die Speicherverschlüsselung (`--storage-encrypted`) verwendet werden soll, indem Sie den ARN, die ID, den Alias-ARN oder den Aliasnamen des Schlüssels angeben. Dieser Parameter wird nur für die folgenden Situationen benötigt:
  + Wenn Sie einen anderen Schlüssel für den Aurora-PostgreSQL-DB-Cluster auswählen möchten als den, der von der Quell-DB-Instance verwendet wird. 
  + Wenn Sie einen verschlüsselten Cluster aus einer unverschlüsselten Quelle erstellen möchten. In diesem Fall müssen Sie den Schlüssel angeben, den Aurora PostgreSQL für die Verschlüsselung verwenden soll.

Nachdem Sie den Aurora-PostgreSQL-DB-Cluster erstellt haben, erstellen Sie die primäre Instance mithilfe des CLI-Befehls [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html), wie im Folgenden gezeigt: 

Für Linux, macOS oder Unix:

```
aws rds create-db-instance \
    --db-cluster-identifier my-new-aurora-cluster \
    --db-instance-class db.x2g.16xlarge \
    --db-instance-identifier rpg-for-migration \
    --engine aurora-postgresql
```

Für Windows:

```
aws rds create-db-instance ^
    --db-cluster-identifier my-new-aurora-cluster ^
    --db-instance-class db.x2g.16xlarge ^
    --db-instance-identifier rpg-for-migration ^
    --engine aurora-postgresql
```

In der folgenden Liste finden Sie weitere Informationen zu einigen der im Beispiel gezeigten Optionen.
+ `--db-cluster-identifier` – Der Name des neuen Aurora-PostgreSQL-DB-Clusters, den Sie im vorherigen Schritt mit dem Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) erstellt haben.
+ `--db-instance-class` – Der Name der DB-Instance-Klasse, die für Ihre primäre Instance verwendet werden soll, z. B. `db.r4.xlarge`, `db.t4g.medium`, `db.x2g.16xlarge` usw. Eine Liste der verfügbaren DB-Instance-Klassen finden Sie unter [DB-Instance-Klassenarten](Concepts.DBInstanceClass.Types.md). 
+ `--db-instance-identifier` – Geben Sie den Namen an, den Ihre primäre Instance erhalten soll.
+ `--engine aurora-postgresql` – Geben Sie `aurora-postgresql` für die Engine an.

### RDS-API
<a name="Aurora.Migration.RDSPostgreSQL.Create.API"></a>

Wenn Sie ein Aurora-Lesereplikat aus einer Quell-DB-Instance von RDS für PostgreSQL erstellen möchten, verwenden Sie zuerst die RDS-API-Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html), um einen neuen Aurora-DB-Cluster für das Aurora-Lesereplikat zu erstellen, das aus Ihrer RDS-for-PostgreSQL-Quell-DB-Instance erstellt wird. Wenn der Aurora-PostgreSQL-DB-Cluster verfügbar ist, verwenden Sie [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html), um die primäre Instance für den Aurora-DB-Cluster zu erstellen.

Sie müssen das Hauptbenutzerkonto (normalerweise `postgres`), sein Passwort oder den Datenbanknamen nicht angeben. Das Aurora-Lesereplikat bezieht diese Angaben automatisch aus der RDS-for-PostgreSQL-Quell-DB-Instance, die in `ReplicationSourceIdentifier` angegeben ist. 

Sie müssen allerdings die Engine-Version angeben, die für den Aurora-PostgreSQL-DB-Cluster und die DB-Instance verwendet werden soll. Die von Ihnen angegebene Version sollte mit der Quell-DB-Instance von RDS für PostgreSQL übereinstimmen. Wenn die Quell-DB-Instance von RDS für PostgreSQL verschlüsselt ist, müssen Sie auch die Verschlüsselung für die primäre Instance des Aurora-PostgreSQL-DB-Clusters angeben. Die Migration einer verschlüsselten Instance zu einem unverschlüsselten Aurora-DB-Cluster wird nicht unterstützt. 

Wenn Sie den Aurora-DB-Cluster für das Aurora-Lesereplikat erstellen möchten, verwenden Sie die RDS-API-Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) mit folgenden Parametern:
+ `DBClusterIdentifier` – Der Name des zu erstellenden DB-Clusters.
+ `DBSubnetGroupName` – Der Name der DB-Subnetzgruppe, die mit diesem DB-Cluster verknüpft werden soll.
+ `Engine=aurora-postgresql` – Der Name der zu verwendenden Engine.
+ `ReplicationSourceIdentifier` – Der Amazon Resource Name (ARN) für die PostgreSQL-Quell-DB-Instance. *Weitere Informationen zu Amazon RDS ARNs finden Sie unter [Amazon Relational Database Service (Amazon RDS)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-rds) in der Allgemeine Amazon Web Services-Referenz.* Wenn `ReplicationSourceIdentifier` eine verschlüsselte Quelle identifiziert, verwendet Amazon RDS Ihren Standard-KMS-Schlüssel, es sei denn, Sie geben mit der Option `KmsKeyId` einen anderen Schlüssel an. 
+ `VpcSecurityGroupIds` – Eine Liste der Amazon-EC2-VPC-Sicherheitsgruppen, die mit diesem DB-Cluster verknüpft werden sollen.
+ `StorageEncrypted` – Gibt an, ob der DB-Cluster verschlüsselt ist. Wenn Sie diesen Parameter verwenden, ohne auch die `ReplicationSourceIdentifier` anzugeben, verwendet Amazon RDS Ihren KMS-Standardschlüssel.
+ `KmsKeyId` – Der Schlüssel für einen verschlüsselten Cluster. Wenn Sie diese Option verwenden, können Sie den Schlüssel angeben, der für die Speicherverschlüsselung verwendet werden soll, indem Sie den ARN, die ID, den Alias-ARN oder den Aliasnamen des Schlüssels angeben.

Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) in der *Amazon-RDS-API-Referenz*.

Sobald der Aurora-DB-Cluster verfügbar ist, können Sie eine primäre Instance dafür erstellen, indem Sie die RDS-API-Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) mit folgenden Parametern verwenden:
+ `DBClusterIdentifier` – Der Name Ihres DB-Clusters.
+ `DBInstanceClass` – Der Name der DB-Instance-Klasse, die für Ihre primäre Instance verwendet werden soll.
+ `DBInstanceIdentifier` – Der Name Ihrer primären Instance.
+ `Engine=aurora-postgresql` – Der Name der zu verwendenden Engine.

Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) in der *Amazon-RDS-API-Referenz*.

## Hochstufen einer Aurora Read Replica
<a name="AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.Promote"></a>

Die Migration zu Aurora PostgreSQL ist erst abgeschlossen, wenn Sie den Replikat-Cluster hochgestuft haben. Löschen Sie also die RDS-for-PostgreSQL-Quell-DB-Instance noch nicht. 

Stellen Sie vor dem Hochladen des Replikat-Clusters sicher, dass die RDS-for-PostgreSQL-DB-Instance keine prozessinternen Transaktionen oder andere Aktivitäten enthält, die in die Datenbank schreiben. Wenn die Replikatverzögerung auf dem Aurora-Lesereplikat Null (0) erreicht, können Sie den Replikatcluster heraufstufen. Weitere Informationen zum Überwachen der Replikatverzögerung finden Sie unter [Überwachung einer Aurora PostgreSQL-Replikation](AuroraPostgreSQL.Replication.md#AuroraPostgreSQL.Replication.Monitoring) und [Metriken auf Instance-Ebene für Amazon Aurora](Aurora.AuroraMonitoring.Metrics.md#Aurora.AuroraMySQL.Monitoring.Metrics.instances).

### Konsole
<a name="AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.Promote.Console"></a>

**So stufen Sie eine Aurora-Read Replica zu einem Aurora-DB-Cluster hoch:**

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

1. Wählen Sie im Navigationsbereich **Datenbanken** aus. 

1. Wählen Sie den Replikatcluster aus.   
![\[Einen Replikatcluster auf den vollständigen Aurora-PostgreSQL-DB-Clusterstatus hochstufen\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/Aurorapgres-migrate-2.png)

1. Wählen Sie für **Actions (Aktionen)****Promote (Hochstufen)** aus. Dies kann einige Minuten dauern und zu Ausfallzeiten führen. 

Wenn der Prozess abgeschlossen ist, ist der Aurora-Replikatcluster ein regionaler Aurora-PostgreSQL-DB-Cluster mit einer Writer-Instance, die die Daten aus der RDS-for-PostgreSQL-DB-Instance enthält.

### AWS CLI
<a name="AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.Promote.CLI"></a>

Verwenden Sie den Befehl, um eine Aurora-Read Replica zu einem eigenständigen DB-Cluster hochzustufen. [https://docs.aws.amazon.com/cli/latest/reference/rds/promote-read-replica-db-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/rds/promote-read-replica-db-cluster.html) AWS CLI 

**Example**  
Für Linux, macOS oder Unix:  

```
aws rds promote-read-replica-db-cluster \
    --db-cluster-identifier myreadreplicacluster
```
Für Windows:  

```
aws rds promote-read-replica-db-cluster ^
    --db-cluster-identifier myreadreplicacluster
```

### RDS-API
<a name="AuroraPostgreSQL.Migrating.RDSPostgreSQL.Replica.Promote.API"></a>

Verwenden Sie den RDS-API-Vorgang, um eine Aurora-Read Replica zu einem eigenständigen DB-Cluster hochzustufen. [PromoteReadReplicaDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_PromoteReadReplicaDBCluster.html) 

Nachdem Sie den Replikatcluster hochgestuft haben, können Sie bestätigen, dass das Hochstufen abgeschlossen wurde, indem Sie das Ereignisprotokoll wie folgt überprüfen.

**Um zu bestätigen, dass das Aurora-Replikatcluster hochgestuft wurde**

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

1. Wählen Sie im Navigationsbereich die Option **Events**.

1. Auf der Seite **Events** (Ereignisse) finden Sie den Namen Ihres Clusters in der Liste **Source** (Quelle). Jedes Ereignis hat eine Quelle, einen Typ, eine Uhrzeit und eine Nachricht. Sie können alle Ereignisse sehen, die in Ihrem AWS-Region für Ihr Konto aufgetreten sind. Ein erfolgreiches Hochstufen generiert die folgende Nachricht. 

   ```
   Promoted Read Replica cluster to a stand-alone database cluster.
   ```

Nach Abschluss der Hochstufung wird die Verknüpfung zwischen der Quell-RDS-for-PostgreSQL-DB-Instance und dem Aurora-PostgreSQL-DB-Cluster aufgehoben. Sie können Ihre Clientanwendungen für den Zugriff auf den Endpunkt des Aurora-Lesereplikats konfigurieren. Weitere Informationen zu den Aurora-Endpunkten finden Sie unter [Amazon-Aurora-Endpunktverbindungen](Aurora.Overview.Endpoints.md). Nun können Sie die DB-Instance bei Bedarf sicher löschen.