Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# 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"}'
```
**Example Risposta:**
```
{
"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"
}
```
**Nota**
Quando l’operazione API ha esito positivo, lo stato del cluster diventa `PENDING_SETUP`. La creazione del cluster rimane in stato `PENDING_SETUP` finché non si aggiorna il cluster con l’ARN del relativo cluster peer.
### 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"}'
```
**Example Risposta:**
```
{
"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"]}'
```
**Example Risposta**
```
{
"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).
**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 Risposta**
```
{
"identifier": "foo0bar1baz2quux3quuxquux5",
"arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
"status": "UPDATING",
"creationTime": "2025-05-06T06:51:16.145000-07:00"
}
```
**Nota**
Se il peering si conclude con successo, entrambi i cluster passano dallo stato “IN ATTESA DI CONFIGURAZIONE” a “CREAZIONE IN CORSO” e infine allo stato “ATTIVO” quando sono pronti per l’uso.
#### Visualizzazione delle proprietà del cluster multi-Regione
Quando descrivi un cluster, puoi visualizzare le proprietà multiregionali per cluster di diversi tipi. Regioni AWS
**Example**
```
aws dsql get-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4'
```
**Example Risposta**
```
{
"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.
**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"]}'
```
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.
1. Disattiva la protezione dall’eliminazione per ogni cluster.
1. Elimina ogni cluster peered separatamente nei rispettivi Regione AWS
### Aggiorna ed elimina il cluster negli Stati Uniti orientali (Virginia settentrionale)
1. Disattiva la protezione dall’eliminazione utilizzando il comando `update-cluster`.
```
aws dsql update-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4' \
--no-deletion-protection-enabled
```
1. Elimina il cluster utilizzando il comando `delete-cluster`.
```
aws dsql delete-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4'
```
Il comando restituisce la seguente risposta.
```
{
"identifier": "foo0bar1baz2quux3quuxquux4",
"arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
"status": "PENDING_DELETE",
"creationTime": "2025-05-06T06:46:10.745000-07:00"
}
```
**Nota**
Lo stato del cluster diventa `PENDING_DELETE`. L’eliminazione non è completa finché non si elimina il cluster in peering negli Stati Uniti orientali (Ohio).
### Aggiorna ed elimina il cluster negli Stati Uniti orientali (Ohio)
1. Disattiva la protezione dall’eliminazione utilizzando il comando `update-cluster`.
```
aws dsql update-cluster \
--region us-east-2 \
--identifier 'foo0bar1baz2quux3quux4quuux' \
--no-deletion-protection-enabled
```
1. Elimina il cluster utilizzando il comando `delete-cluster`.
```
aws dsql delete-cluster \
--region us-east-2 \
--identifier 'foo0bar1baz2quux3quuxquux5'
```
Il comando restituisce la seguente risposta:
```
{
"identifier": "foo0bar1baz2quux3quuxquux5",
"arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
"status": "PENDING_DELETE",
"creationTime": "2025-05-06T06:46:10.745000-07:00"
}
```
**Nota**
Lo stato del cluster diventa `PENDING_DELETE`. Dopo alcuni secondi, il sistema fa automaticamente passare a `DELETING` lo stato di entrambi i cluster in peering dopo la convalida.