Utilisation des entrepôts de données globaux (CLI) - Amazon ElastiCache
Téléchargement et configuration du AWS CLIUtilisation de la AWS CLI avec des banques de données globales

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 des entrepôts de données globaux (CLI)

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour contrôler plusieurs AWS services à partir de la ligne de commande et les automatiser par le biais de scripts. Vous pouvez utiliser la AWS CLI pour des opérations ad hoc (ponctuelles).

Téléchargement et configuration du AWS CLI

Il AWS CLI fonctionne sous Windows, macOS ou Linux. Suivez la procédure suivante pour la télécharger et la configurer.

Pour télécharger, installer et configurer la CLI

  1. Téléchargez la AWS CLI sur la page Web de l'interface de ligne de AWS commande.

  2. Suivez les instructions d'installation de la AWS CLI et de configuration de la AWS CLI dans le guide de AWS Command Line Interface l'utilisateur.

Utilisation de la AWS CLI avec des banques de données globales

Utilisez les opérations de la CLI suivantes pour utiliser les magasins de données globaux :

  • create-global-replication-group

    aws elasticache create-global-replication-group \
   --global-replication-group-id-suffix my global datastore  \
   --primary-replication-group-id sample-repl-group  \
   --global-replication-group-description an optional description of the global datastore

    Amazon applique ElastiCache automatiquement un préfixe à l'identifiant global de la banque de données lors de sa création. Chaque AWS région possède son propre préfixe. Par exemple, un ID d'entrepôt de données global créé dans la région USA Ouest (Californie du Nord) commence par « virxk » avec le nom de suffixe que vous fournissez. Le suffixe, combiné au préfixe autogénéré, garantit l'unicité du nom de l'entrepôt de données global dans plusieurs régions.

    Le tableau suivant répertorie chaque AWS région et son préfixe d'ID de banque de données global.

    Nom de région/Région Préfixe

    Région US East (Ohio)

    us-east-2

    fpkhr

    Région US East (N. Virginia)

    us-east-1

    ldgnf

    Région US West (N. California)

    us-west-1

    virxk

    Région US West (Oregon)

    us-west-2

    sgaui

    Région Canada (Centre)

    ca-central-1

    bxodz

    Région Asia Pacific (Mumbai)

    ap-south-1

    erpgt

    Région Asia Pacific (Tokyo)

    ap-northeast-1

    quwsw

    Région Asia Pacific (Seoul)

    ap-northeast-2

    lfqnh

    Région Asie-Pacifique (Osaka)

    ap-northeast-3

    nlapn

    Région Asia Pacific (Singapore)

    ap-southeast-1

    vlqxn

    Région Asia Pacific (Sydney)

    ap-southeast-2

    vbgxd

    Région Europe (Frankfurt)

    eu-central-1

    iudkw

    Région Europe (Irlande)

    eu-west-1

    gxeiz

    Région Europe (London)

    eu-west-2

    okuqm

    Région Europe (Paris)

    eu-west-3

    fgjhi

    Région South America (São Paulo)

    sa-east-1

    juxlw

    Région Chine (Beijing)

    cn-north-1

    emvgo

    Région Chine (Ningxia)

    cn-northwest-1

    ckbem

    Région Asie-Pacifique (Hong Kong)

    ap-east-1

    knjmp

    AWS GovCloud (US-Ouest)

    us-gov-west-1

    		 sgwui

  • create-replication-group— Utilisez cette opération pour créer des clusters secondaires pour une banque de données globale en fournissant le nom de la banque de données globale au --global-replication-group-id paramètre.

    aws elasticache create-replication-group \
  --replication-group-id secondary replication group name \
  --replication-group-description “Replication group description" \
  --global-replication-group-id global datastore name

    Lorsque vous appelez cette opération et que vous --global-replication-group-id transmettez une valeur, les valeurs ElastiCache seront déduites du groupe de réplication principal du groupe de réplication global pour les paramètres suivants. Ne transmettez pas de valeurs pour ces paramètres :

    "PrimaryClusterId",

    "AutomaticFailoverEnabled",

    "NumNodeGroups",

    "CacheParameterGroupName",

    "CacheNodeType",

    "Engine",

    "EngineVersion",

    "CacheSecurityGroupNames",

    "EnableTransitEncryption",

    "AtRestEncryptionEnabled",

    "SnapshotArns",

    "SnapshotName"

  • describe-global-replication-groups

    aws elasticache describe-global-replication-groups \
   --global-replication-group-id my global datastore  \
   --show-member-info an optional parameter that returns a list of the primary and secondary clusters that make up the global datastore

  • modify-global-replication-group

    aws elasticache modify-global-replication-group \
   --global-replication-group-id my global datastore  \
   --automatic-failover-enabled \
   --cache-node-type node type \
   --cache-parameter-group-name parameter group name \ 
   --engine-version engine version \
   -—apply-immediately \
   --global-replication-group-description description

    Mise à niveau multimoteur de Redis vers OSS Valkey pour ElastiCache GlobalDataStore

    Vous pouvez mettre à niveau un groupe de réplication global Redis OSS existant vers Valkey à l'aide de la console, de l'API ou de la CLI.

    Si vous disposez d'un groupe de réplication global Redis OSS existant, vous pouvez passer à Valkey en spécifiant le nouveau moteur et la nouvelle version du moteur avec modify-global-replication-group l'API.

    Pour Linux, macOS ou Unix :

    aws elasticache modify-global-replication-group \
   --global-replication-group-id myGlobalReplGroup \
   --engine valkey \
   --apply-immediately \
   --engine-version 8.0

    Pour Windows :

    aws elasticache modify-global-replication-group ^
   --global-replication-group-id myGlobalReplGroup ^
   --engine valkey ^
   --apply-immediately ^
   --engine-version 8.0

    Si un groupe de paramètres de cache personnalisé est appliqué au groupe de réplication global Redis OSS existant que vous souhaitez mettre à niveau, vous devrez également transmettre un groupe de paramètres de cache Valkey personnalisé dans la demande. Le groupe de paramètres personnalisés Valkey en entrée doit avoir les mêmes valeurs de paramètres statiques Redis OSS que le groupe de paramètres personnalisés Redis OSS existant.

    Pour Linux, macOS ou Unix :

    aws elasticache modify-global-replication-group \
   --global-replication-group-id myGlobalReplGroup \
   --engine valkey \
   --engine-version 8.0 \
   --apply-immediately \
   --cache-parameter-group-name myParamGroup

    Pour Windows :

    aws elasticache modify-global-replication-group ^
   --global-replication-group-id myGlobalReplGroup ^
   --engine valkey ^
   --engine-version 8.0 ^
   --apply-immediately ^
   --cache-parameter-group-name myParamGroup

  • delete-global-replication-group

    aws elasticache delete-global-replication-group \
   --global-replication-group-id my global datastore  \
   --retain-primary-replication-group defaults to true

  • disassociate-global-replication-group

    aws elasticache disassociate-global-replication-group \
   --global-replication-group-id my global datastore  \
   --replication-group-id my secondary cluster  \
   --replication-group-region the AWS Region in which the secondary cluster resides

  • failover-global-replication-group

    aws elasticache failover-replication-group \
   --global-replication-group-id my global datastore \
   --primary-region The AWS Region of the primary cluster \  
   --primary-replication-group-id  The name of the global datastore, including the suffix.

  • increase-node-groups-in-global-replication-group

    aws elasticache increase-node-groups-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name \
   --node-group-count 3

  • decrease-node-groups-in-global-replication-group

    aws elasticache decrease-node-groups-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name \
   --node-group-count 3

  • rebalance-shards-in-global-groupe de réplication

    aws elasticache rebalance-shards-in-global-replication-group \
   --apply-immediately yes \
   --global-replication-group-id global-replication-group-name

Utilisez l'aide pour répertorier toutes les commandes disponibles ElastiCache pour Valkey ou Redis OSS.

aws elasticache help

Vous pouvez également utiliser l'aide pour décrire une commande spécifique et en savoir plus sur son utilisation : 

aws elasticache create-global-replication-group help