Utilisation de l’interface de ligne de commande (CLI) AWS - Amazon Aurora DSQL
Connexion à un clusterCréation de clustersSuppression de clusters

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de l’interface de ligne de commande (CLI) AWS

L’interface de ligne de commande (CLI) AWS fournit une interface de ligne de commande pour gérer vos clusters multi-régions Aurora DSQL. Les exemples suivants montrent comment créer, configurer et supprimer des clusters multi-régions.

Connexion à votre cluster multi-régions

Les clusters multi-régions associés fournissent deux points de terminaison régionaux, un dans chaque cluster associé Région AWS. Les deux points de terminaison présentent une base de données logique unique qui prend en charge les opérations de lecture et d’écriture simultanées avec une forte cohérence des données. Outre les clusters associés, un cluster multi-régions possède également une région témoin qui stocke une fenêtre limitée de journaux de transactions chiffrés, qui est utilisée pour améliorer la durabilité et la disponibilité de plusieurs régions. Les régions témoins multi-régions n’ont pas de points de terminaison.

Création de clusters multi-régions

Pour créer des clusters multi-régions, vous devez d’abord créer un cluster avec une région témoin. Ensuite, vous associez ce cluster à un second cluster qui partage la même région témoin que votre premier cluster. L’exemple suivant montre comment créer des clusters dans les régions USA Est (Virginie du Nord) et USA Est (Ohio) avec la région USA Ouest (Oregon) comme région témoin.

Étape 1 : création du cluster 1 dans la région USA Est (Virginie du Nord)

Pour créer un cluster dans la région USA Est (Virginie du Nord) Région AWS avec des propriétés multi-régions, utilisez la commande ci-dessous. 

aws dsql create-cluster \
--region us-east-1 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'
Exemple Réponse :
{
    "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"
}
Note

Lorsque l’opération d’API aboutit, le cluster passe à l’état PENDING_SETUP. La création du cluster reste à l’état PENDING_SETUP jusqu’à ce que vous le mettiez à jour avec l’ARN de son cluster homologue.

Étape 2 : création du cluster 2 dans la région USA Est (Ohio)

Pour créer un cluster dans la région USA Est (Ohio) Région AWS avec des propriétés multi-régions, utilisez la commande ci-dessous. 

aws dsql create-cluster \
--region us-east-2 \
--multi-region-properties '{"witnessRegion":"us-west-2"}'
Exemple Réponse :
{
    "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"
        ]
    }
}

Lorsque l’opération d’API réussit, le cluster passe à l’état PENDING_SETUP. La création du cluster reste à l’état PENDING_SETUP jusqu’à ce que vous le mettiez à jour avec l’ARN d’un autre cluster associé.

Étape 3 : association d’un cluster de la région USA Est (Virginie du Nord) avec la région USA Est (Ohio)

Pour associer votre cluster de la région USA Est (Virginie du Nord) à votre cluster de la région USA Est (Ohio), utilisez la commande update-cluster. Spécifiez le nom de votre cluster de la région USA Est (Virginie du Nord) et une chaîne JSON avec l’ARN du cluster de la région USA Est (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"]}'
Exemple Réponse
{
    "identifier": "foo0bar1baz2quux3quuxquux4",
    "arn": "arn:aws:dsql:us-east-1:111122223333:cluster/foo0bar1baz2quux3quuxquux4",
    "status": "UPDATING",
    "creationTime": "2025-05-06T06:46:10.745000-07:00"
}

Étape 4 : association d’un cluster de la région USA Est (Ohio) avec la région USA Est (Virginie du Nord)

Pour associer votre cluster de la région USA Est (Ohio) à votre cluster de la région USA Est (Virginie du Nord), utilisez la commande update-cluster. Spécifiez le nom de votre cluster de la région USA Est (Ohio) et une chaîne JSON avec l’ARN du cluster de la région USA Est (Virginie du Nord).

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"]}'
Exemple Réponse
{
    "identifier": "foo0bar1baz2quux3quuxquux5",
    "arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
    "status": "UPDATING",
    "creationTime": "2025-05-06T06:51:16.145000-07:00"
}
Note

Après une association réussie, les deux clusters passent de l’état « PENDING_SETUP » à « CREATING » et enfin à l’état « ACTIVE » lorsqu’ils sont prêts à être utilisés.

Affichage des propriétés d’un cluster multi-régions

Lorsque vous décrivez un cluster, vous pouvez afficher les propriétés multi-régions des clusters de différentes Régions AWS.

aws dsql get-cluster \
--region us-east-1 \
--identifier 'foo0bar1baz2quux3quuxquux4'
Exemple Réponse
{
    "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"
       ]
    }
}

Association des clusters lors de la création

Vous pouvez réduire le nombre d’étapes en incluant des informations d’association lors de la création du cluster. Après avoir créé votre premier cluster dans la région USA Est (Virginie du Nord) (étape 1), vous pouvez créer votre deuxième cluster dans la région USA Est (Ohio) tout en lançant le processus d’association en incluant l’ARN du premier 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"]}'

Cela combine les étapes 2 et 4, mais vous devez tout de même terminer l’étape 3 (mise à jour du premier cluster avec l’ARN du deuxième cluster) pour établir la relation d’association. Une fois toutes les étapes terminées, les deux clusters passeront par les mêmes états que dans le processus standard : de PENDING_SETUP à CREATING, puis à ACTIVE lorsqu’ils seront prêts à être utilisés.

Suppression de clusters multi-régions

Pour supprimer un cluster multi-régions, vous devez effectuer deux étapes.

  1. Désactivez la protection contre la suppression pour chaque cluster.

  2. Supprimez chaque cluster associé séparément dans sa Région AWS respective.

Mise à jour et suppression d’un cluster dans la région USA Est (Virginie du Nord)

  1. Désactivez la protection contre la suppression à l’aide de la commande update-cluster.

    aws dsql update-cluster \
  --region us-east-1 \
  --identifier 'foo0bar1baz2quux3quuxquux4' \
  --no-deletion-protection-enabled

  2. Supprimez le cluster à l’aide de la commande delete-cluster.

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

    Cette commande renvoie la réponse suivante.

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

    Le cluster passe à l’état PENDING_DELETE. La suppression n’est pas terminée tant que vous n’avez pas supprimé le cluster associé dans la région USA Est (Ohio).

Mise à jour et suppression d’un cluster dans la région USA Est (Ohio)

  1. Désactivez la protection contre la suppression à l’aide de la commande update-cluster.

    aws dsql update-cluster \
--region us-east-2 \
--identifier 'foo0bar1baz2quux3quux4quuux' \
--no-deletion-protection-enabled

  2. Supprimez le cluster à l’aide de la commande delete-cluster.

    aws dsql delete-cluster \
--region us-east-2 \
--identifier 'foo0bar1baz2quux3quuxquux5'

    Cette commande renvoie la réponse suivante :

    {
    "identifier": "foo0bar1baz2quux3quuxquux5",
    "arn": "arn:aws:dsql:us-east-2:111122223333:cluster/foo0bar1baz2quux3quuxquux5",
    "status": "PENDING_DELETE",
    "creationTime": "2025-05-06T06:46:10.745000-07:00"
}
    Note

    Le cluster passe à l’état PENDING_DELETE. Après quelques secondes, le système fait passer automatiquement les deux clusters associés à l’état DELETING après validation.