Utilisation des entrepôts de données globaux (CLI) - Amazon ElastiCache for Redis

Utilisation des entrepôts de données globaux (CLI)

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

Téléchargement et configuration de la AWS CLI

L'AWS CLI s'exécute 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 CLI AWS sur la page web Interface de ligne de commande AWS.

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

Utilisation de la CLI AWS avec des entrepôts de données globaux

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 ElastiCache applique automatiquement un préfixe à l'ID de l'entrepôt de données global lors de sa création. Chaque région AWS a 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 « dsdfu » 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 région AWS et son préfixe d'ID d'entrepôt 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 (Ireland)

    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 (Pékin)

    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-West)

    us-gov-west-1

    sgwui
  • create-replication-group – Utilisez cette opération pour créer des clusters secondaires pour un entrepôt de données global en fournissant le nom de l'entrepôt de données global au paramètre --global-replication-group-id.

    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

    Lors de l'appel de cette opération et de la transmission d'une valeur --global-replication-group-id, ElastiCache for Redis déduira les valeurs 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
  • 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-replication-group

    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 ElastiCache disponibles.

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