Verwenden von AWS-CLI - Amazon Aurora DSQL
Verbinden mit einem ClusterErstellen von ClusternLöschen von Clustern

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.

Verwenden von AWS-CLI

Die AWS-CLI stellt eine Befehlszeilenschnittstelle für die Verwaltung Ihrer Aurora DSQL-Cluster mit mehreren Regionen bereit. 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-Cluster. 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 in der USA Ost (Nord-Virginia)-AWS-Region mit multiregionalen Eigenschaften zu erstellen. 

aws dsql create-cluster \
--region us-east-1 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'
Beispiel 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 in der US East (Ohio)-AWS-Region mit multiregionalen Eigenschaften zu erstellen. 

aws dsql create-cluster \
--region us-east-2 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'
Beispiel 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 US East (Ohio)-Cluster zu verbinden. Geben Sie den Namen Ihres USA Ost (Nord-Virginia)-Clusters und eine JSON-Zeichenfolge mit dem ARN des US East (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"]}'
Beispiel 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 US East (Ohio)-Cluster zu verbinden. Geben Sie den Namen Ihres USA Ost (Ohio)-Clusters und eine JSON-Zeichenfolge mit dem ARN des US East (Nord-Virginia)-Clusters an.

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"]}'
Beispiel 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 Eigensschaften in Clustern mit mehreren Regionen

Wenn Sie einen Cluster beschreiben, können Sie sich die Eigenschaften mehrerer Regionen für Cluster in verschiedenen AWS-Regionen anzeigen lassen.

aws dsql get-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4'
Beispiel 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.

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.

  2. Löschen Sie jeden Peer-Cluster einzeln in der 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

  2. 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

  2. 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.