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 depuis 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, ElastiCache (Redis OSS) 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-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 (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