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.
# AWS CLI verwenden
Die AWS CLI bietet eine Befehlszeilenschnittstelle für die Verwaltung Ihrer Aurora DSQL-Cluster mit mehreren Regionen. Die folgenden Beispiele veranschaulichen, wie Sie Cluster mit mehreren Regionen erstellen, konfigurieren und löschen.
## Verbindung zu Ihrem Cluster mit mehreren Regionen herstellen
Verbundene Cluster mit mehreren Regionen stellen zwei regionale Endpunkte bereit, jeweils einen in jeder Region des verbundenen AWS-Region-Clusters. Beide Endpunkte stellen eine einzige logische Datenbank dar, die gleichzeitige Lese- und Schreibvorgänge mit hoher Datenkonsistenz unterstützt. Zusätzlich zu den verbundenen Clustern verfügt ein Cluster mit mehreren Regionen auch über eine Witness-Region, die verschlüsselte Transaktionsprotokolle für einen begrenzten Zeitraum speichert. Dies dient der Verbesserung der Beständigkeit und Verfügbarkeit über mehrere Regionen hinweg. Witness-Regionen mit mehreren Regionen haben keine Endpunkte.
## Erstellen von Clustern mit mehreren Regionen
Um Cluster mit mehreren Regionen zu erstellen, erstellen Sie zunächst einen Cluster mit einer Witness-Region. Anschließend wird dieser Cluster mit einem zweiten Cluster verbunden, der dieselbe Witness-Region wie Ihr erster Cluster teilt. Im folgenden Beispiel sehen Sie, wie Sie Cluster in USA Ost (Nord-Virginia) und USA Ost (Ohio) mit USA West (Oregon) als Witness-Region erstellen.
### Schritt 1: Erstellen Sie Cluster Nummer Eins in USA Ost (Nord-Virginia)
Verwenden Sie den folgenden Befehl, um einen Cluster im Osten der USA (Nord-Virginia) AWS-Region mit multiregionalen Eigenschaften zu erstellen.
```
aws dsql create-cluster \
--region us-east-1 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'
```
**Example Antwort:**
```
{
"identifier": "abc0def1baz2quux3quuux4",
"arn": "arn:aws:dsql:us-east-1:111122223333:cluster/abc0def1baz2quux3quuux4",
"status": "UPDATING",
"encryptionDetails": {
"encryptionType": "AWS_OWNED_KMS_KEY",
"encryptionStatus": "ENABLED"
}
"creationTime": "2024-05-24T09:15:32.708000-07:00"
}
```
**Anmerkung**
Wenn die API-Operation erfolgreich ist, wechselt der Cluster in den `PENDING_SETUP`-Status. Die Clustererstellung verbleibt so lange im Status `PENDING_SETUP`, bis Sie den Cluster mit dem ARN seines Peer-Clusters aktualisieren.
### Schritt 2: Erstellen Sie Cluster Nummer Zwei in USA Ost (Ohio)
Verwenden Sie den folgenden Befehl, um einen Cluster im Osten der USA (Ohio) AWS-Region mit Eigenschaften für mehrere Regionen zu erstellen.
```
aws dsql create-cluster \
--region us-east-2 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'
```
**Example Antwort:**
```
{
"identifier": "foo0bar1baz2quux3quuxquux5",
"arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
"status": "PENDING_SETUP",
"creationTime": "2025-05-06T06:51:16.145000-07:00",
"deletionProtectionEnabled": true,
"multiRegionProperties": {
"witnessRegion": "us-west-2",
"clusters": [
"arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5"
]
}
}
```
Wenn die API-Operation erfolgreich ist, wechselt der Cluster in den `PENDING_SETUP`-Status. Die Clustererstellung verbleibt so lange im Status `PENDING_SETUP`, bis Sie den Cluster mit dem ARN eines anderen Clusters zum Peering aktualisieren.
### Schritt 3: Verbinden Sie den Cluster in USA Ost (Nord-Virginia) mit dem in USA Ost (Ohio)
Verwenden Sie den `update-cluster`-Befehl, um Ihr USA Ost (Nord-Virginia)-Cluster mit Ihrem USA Ost (Ohio)-Cluster zu verbinden. Geben Sie den Namen Ihres USA Ost (Nord-Virginia)-Clusters und eine JSON-Zeichenfolge mit dem ARN des USA OSt (Ohio)-Clusters an.
```
aws dsql update-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4' \
--multi-region-properties '{"witnessRegion": "us-west-2","clusters": ["arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5"]}'
```
**Example Antwort**
```
{
"identifier": "foo0bar1baz2quux3quuxquux4",
"arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
"status": "UPDATING",
"creationTime": "2025-05-06T06:46:10.745000-07:00"
}
```
### Schritt 4: Verbinden Sie den Cluster in USA Ost (Ohio) mit dem in USA Ost (Nord-Virginia)
Verwenden Sie den `update-cluster`-Befehl, um Ihr USA Ost (Nord-Virginia)-Cluster mit Ihrem USA Ost (Ohio)-Cluster zu verbinden. Geben Sie den Namen Ihres USA Ost (Ohio)-Clusters und eine JSON-Zeichenfolge mit dem ARN des USA Ost (Nord-Virginia)-Clusters an.
**Example**
```
aws dsql update-cluster \
--region us-east-2 \
--identifier 'foo0bar1baz2quux3quuxquux5' \
--multi-region-properties '{"witnessRegion": "us-west-2", "clusters": ["arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4"]}'
```
**Example Antwort**
```
{
"identifier": "foo0bar1baz2quux3quuxquux5",
"arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
"status": "UPDATING",
"creationTime": "2025-05-06T06:51:16.145000-07:00"
}
```
**Anmerkung**
Nach erfolgreichem Peering wechseln beide Cluster vom Status PENDING\_SETUP in den Status CREATING und schließlich in den Status ACTIVE, wenn sie einsatzbereit sind.
#### Anzeigen von Eigenschaften in Clustern mit mehreren Regionen
Wenn Sie einen Cluster beschreiben, können Sie sich die Eigenschaften mehrerer Regionen für Cluster in verschiedenen Regionen anzeigen lassen. AWS-Regionen
**Example**
```
aws dsql get-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4'
```
**Example Antwort**
```
{
"identifier": "foo0bar1baz2quux3quuxquux4",
"arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
"status": "PENDING_SETUP",
"encryptionDetails": {
"encryptionType": "AWS_OWNED_KMS_KEY",
"encryptionStatus": "ENABLED"
},
"creationTime": "2024-11-27T00:32:14.434000-08:00",
"deletionProtectionEnabled": false,
"multiRegionProperties": {
"witnessRegion": "us-west-2",
"clusters": [
"arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
"arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5"
]
}
}
```
#### Peer-Cluster während der Erstellung
Sie können die Anzahl der Arbeitsschritte reduzieren, indem Sie bei der Clustererstellung Peering-Informationen einbeziehen. Nachdem Sie Ihren ersten Cluster in USA Ost (Nord-Virginia) erstellt haben (Schritt 1), können Sie Ihren zweiten Cluster in USA Ost (Ohio) erstellen und gleichzeitig den Peering-Prozess einleiten, indem Sie den ARN des ersten Clusters mit angeben.
**Example**
```
aws dsql create-cluster \
--region us-east-2 \
--multi-region-properties '{"witnessRegion":"us-west-2","clusters": ["arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4"]}'
```
So werden die Schritte 2 und 4 kombiniert, aber Sie müssen immer noch Schritt 3 (Aktualisierung des ersten Clusters mit dem ARN des zweiten Clusters) durchführen, um die Peering-Beziehung herzustellen. Nachdem alle Schritte abgeschlossen sind, durchlaufen beide Cluster dieselben Zustände wie im Standardprozess: von **PENDING\_SETUP** zu **CREATING** und schließlich zu **ACTIVE**, wenn sie dann einsatzbereit sind.
## Löschen von Clustern mit mehreren Regionen
Es sind zwei Arbeitsschritte erforderlich, um einen Cluster mit mehreren Regionen zu löschen.
1. Deaktivieren Sie den Löschschutz für die einzelnen Cluster.
1. Löschen Sie jeden Peering-Cluster separat in seinem jeweiligen AWS-Region
### Aktualisieren und löschen Sie den Cluster in der Region USA Ost (Nord-Virginia).
1. Deaktivieren Sie den Löschschutz mit dem `update-cluster`-Befehl.
```
aws dsql update-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4' \
--no-deletion-protection-enabled
```
1. Löschen Sie den Cluster mit dem `delete-cluster`-Befehl.
```
aws dsql delete-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4'
```
Dieser Befehl gibt die folgende Antwort zurück.
```
{
"identifier": "foo0bar1baz2quux3quuxquux4",
"arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
"status": "PENDING_DELETE",
"creationTime": "2025-05-06T06:46:10.745000-07:00"
}
```
**Anmerkung**
Der Cluster wechselt in den `PENDING_DELETE`-Status. Der Löschvorgang ist erst abgeschlossen, wenn Sie den Peering-Cluster in USA Ost (Ohio) gelöscht haben.
### Aktualisieren und löschen Sie den Cluster in der Region USA Ost (Ohio).
1. Deaktivieren Sie den Löschschutz mit dem `update-cluster`-Befehl.
```
aws dsql update-cluster \
--region us-east-2 \
--identifier 'foo0bar1baz2quux3quux4quuux' \
--no-deletion-protection-enabled
```
1. Löschen Sie den Cluster mit dem `delete-cluster`-Befehl.
```
aws dsql delete-cluster \
--region us-east-2 \
--identifier 'foo0bar1baz2quux3quuxquux5'
```
Dieser Befehl gibt die folgende Antwort zurück.
```
{
"identifier": "foo0bar1baz2quux3quuxquux5",
"arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
"status": "PENDING_DELETE",
"creationTime": "2025-05-06T06:46:10.745000-07:00"
}
```
**Anmerkung**
Der Cluster wechselt in den `PENDING_DELETE`-Status. Nach der Validierung versetzt das System beide Peering-Cluster nach einigen Sekunden automatisch in den `DELETING`-Status.