Utilizzo della CLI di AWS

La CLI di AWS fornisce un’interfaccia a riga di comando per la gestione dei cluster Aurora DSQL multi-Regione. 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 per ogni cluster Regione AWS 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 nella Regione AWS Stati Uniti orientali (Virginia settentrionale) con proprietà multi-Regione, utilizzare il seguente comando.

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 nella Regione AWS Stati Uniti orientali (Ohio) con proprietà multi-Regione, utilizzare 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), utilizzare il comando update-cluster. Specificate 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. Specificare 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 si descrive un cluster, è possibile visualizzare le proprietà multi-Regione per i cluster in diverse 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.

Aggiornare ed eliminare il cluster negli Stati Uniti orientali (Virginia settentrionale)

Aggiornare ed eliminare il cluster negli Stati Uniti orientali (Ohio)