Utilizzo della AWS CLI

La AWS CLI fornisce un'interfaccia a riga di comando per la gestione dei cluster Aurora DSQL multiregione. Negli esempi seguenti viene illustrato come creare, configurare ed eliminare cluster multi-Regione.

Connessione a un cluster multi-Regione

I cluster in peering multi-Regione forniscono due endpoint regionali, uno in ogni Regione AWS di cluster in peering. Entrambi gli endpoint presentano un unico database logico che supporta operazioni di lettura e scrittura simultanee con una forte coerenza dei dati. Oltre ai cluster in peering, un cluster multi-Regione dispone anche di una Regione di riferimento che archivia una finestra limitata di registri delle transazioni crittografati, utilizzata per migliorare la durabilità e la disponibilità multi-Regione. Le Regioni testimone dei cluster multi-Regione non dispongono di endpoint.

Creazione di cluster multi-Regione

Per creare cluster multi-Regione, è prima necessario creare un cluster con una Regione testimone. Quindi si esegue il peering di questo cluster a un secondo cluster che condivide la stessa Regione testimone del primo cluster. Nell’esempio seguente viene illustrato come creare cluster negli Stati Uniti orientali (Virginia settentrionale) e negli Stati Uniti orientali (Ohio) con Stati Uniti occidentali (Oregon) come Regione testimone.

Fase 1: creazione di un cluster negli Stati Uniti orientali (Virginia settentrionale)

Per creare un cluster negli Stati Uniti orientali (Virginia settentrionale) Regione AWS con proprietà multiregionali, usa il comando seguente.

aws dsql create-cluster \
--region us-east-1 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'

{
    "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"
}

Fase 2: creazione di un secondo cluster negli Stati Uniti orientali (Ohio)

Per creare un cluster negli Stati Uniti orientali (Ohio) Regione AWS con proprietà multiregionali, usa il comando seguente.

aws dsql create-cluster \
--region us-east-2 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'

{
    "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"
        ]
    }
}      

Quando l’operazione API ha esito positivo, il cluster passa allo stato PENDING_SETUP. La creazione del cluster rimane nello stato PENDING_SETUP fino a quando non viene aggiornata con l’ARN di un altro cluster in peering.

Fase 3: peering dei cluster negli Stati Uniti orientali (Virginia settentrionale) con quello negli Stati Uniti orientali (Ohio)

Per effettuare il peering del cluster negli Stati Uniti orientali (Virginia settentrionale) con il cluster negli Stati Uniti orientali (Ohio), utilizza il comando update-cluster. Specifica il nome del cluster negli Stati Uniti orientali (Virginia settentrionale) e una stringa JSON con l’ARN del cluster negli Stati Uniti orientali (Ohio).

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"]}'

{
    "identifier": "foo0bar1baz2quux3quuxquux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
    "status": "UPDATING",
    "creationTime": "2025-05-06T06:46:10.745000-07:00"
}

Fase 4: peering del cluster negli Stati Uniti orientali (Ohio) con quello negli Stati Uniti orientali (Virginia settentrionale)

Per effettuare il peering tra il cluster negli Stati Uniti orientali (Ohio) e il cluster negli Stati Uniti orientali (Virginia settentrionale), utilizza il comando update-cluster. Specifica il nome del cluster negli Stati Uniti orientali (Ohio) e una stringa JSON con l’ARN del cluster negli Stati Uniti orientali (Virginia settentrionale).

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"]}'

{
    "identifier": "foo0bar1baz2quux3quuxquux5",
    "arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
    "status": "UPDATING",
    "creationTime": "2025-05-06T06:51:16.145000-07:00"
}

Visualizzazione delle proprietà del cluster multi-Regione

Quando descrivi un cluster, puoi visualizzare le proprietà multiregionali per cluster di diversi tipi. Regioni AWS

aws dsql get-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4'

{
    "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"
       ]
    }
}

Peering dei cluster durante la creazione

È possibile ridurre il numero di passaggi includendo le informazioni di peering durante la creazione del cluster. Dopo aver creato il primo cluster negli Stati Uniti orientali (Virginia settentrionale) (Fase 1), è possibile creare il secondo cluster negli Stati Uniti orientali (Ohio) avviando contemporaneamente il processo di peering includendo l’ARN del primo cluster.

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"]}'

Questo approccio combina i passaggi 2 e 4, ma è comunque necessario completare il passaggio 3 (aggiornamento del primo cluster con l’ARN del secondo cluster) per stabilire la relazione di peering. Una volta completati tutti i passaggi, entrambi i cluster passeranno attraverso gli stessi stati del processo standard: da IN ATTESA DI CONFIGURAZIONE a CREAZIONE IN CORSO e infine allo stato ATTIVO quando sono pronti per l’uso.

Eliminazione di cluster multi-Regione

Per eliminare un cluster multi-Regione, è necessario completare due passaggi.

Aggiorna ed elimina il cluster negli Stati Uniti orientali (Virginia settentrionale)

Aggiorna ed elimina il cluster negli Stati Uniti orientali (Ohio)