View a markdown version of this page

使用全局数据存储 (CLI) - Amazon ElastiCache
下载和配置 AWS CLI将 AWS CLI 与全局数据存储结合使用

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用全局数据存储 (CLI)

您可以使用 AWS Command Line Interface (AWS CLI) 从命令行管理多个 AWS 服务并通过脚本自动执行这些服务。您可以使用 AWS CLI 执行临时（一次性）操作。

下载和配置 AWS CLI

AWS CLI 在 Windows、macOS 或 Linux 上运行。按照以下步骤下载和并对其进行配置。

下载、安装和配置 CLI

  1. 在 AWS Command Line Interface 网页上下载 AWS CLI。

  2. 按照 AWS Command Line Interface 用户指南中的说明安装 AWS CLI 和配置 AWS CLI。

将 AWS CLI 与全局数据存储结合使用

使用以下 CLI 操作来处理全局数据存储：

  • 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 会在全局数据存储 ID 被创建时自动对其应用前缀。每个 AWS 区域有自己的前缀。例如，在美国西部（北加利福尼亚）区域创建的全局数据存储 ID 以“virxk”和您提供的后缀名称开头。后缀与自动生成的前缀相结合，保证了全局数据存储名称在多个区域中的唯一性。

    下表列出了每个 AWS 区域及其全局数据存储 ID 前缀。

    区域名称/区域 Prefix

    美国东部（俄亥俄州）区域

    us-east-2

    fpkhr

    美国东部（弗吉尼亚州北部）区域

    us-east-1

    ldgnf

    美国西部（北加利福尼亚）区域

    us-west-1

    virxk

    美国西部（俄勒冈州）区域

    us-west-2

    sgaui

    加拿大（中部）区域

    ca-central-1

    bxodz

    亚太地区（孟买）区域

    ap-south-1

    erpgt

    Asia Pacific（Tokyo）Region

    ap-northeast-1

    quwsw

    亚太地区（首尔）区域

    ap-northeast-2

    lfqnh

    亚太地区（大阪）区域

    ap-northeast-3

    nlapn

    亚太地区（新加坡）区域

    ap-southeast-1

    vlqxn

    亚太地区（悉尼）区域

    ap-southeast-2

    vbgxd

    欧洲地区（法兰克福）区域

    eu-central-1

    iudkw

    欧洲地区（爱尔兰）区域

    eu-west-1

    gxeiz

    欧洲地区（伦敦）区域

    eu-west-2

    okuqm

    欧洲（巴黎）区域

    eu-west-3

    fgjhi

    南美洲（圣保罗）区域

    sa-east-1

    juxlw

    中国（北京）区域

    cn-north-1

    emvgo

    中国（宁夏）区域

    cn-northwest-1

    ckbem

    亚太地区（香港）区域

    ap-east-1

    knjmp

    AWS GovCloud（美国西部）

    us-gov-west-1

    		 sgwui

  • create-replication-group – 使用此操作可通过向 --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

    当调用此操作并传入 --global-replication-group-id 值时，ElastiCache 会从全局复制组的主复制组中推断下列参数的值。请勿传入这些参数的值：

    "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

    ElastiCache GlobalDataStore 的 Redis 到 OSS Valkey 跨引擎升级

    您可以使用控制台、API 或 CLI 将现有 Redis OSS 全局复制组升级到 Valkey。

    如果您有现成的 Redis OSS 全局复制组，您可以使用 modify-global-replication-group API 指定新引擎和引擎版本，从而升级到 Valkey。

    对于 Linux、macOS 或 Unix：

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

    对于 Windows：

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

    如果您对要升级的现有 Redis OSS 全局复制组应用了自定义缓存参数组，则还需要在请求中传递自定义 Valkey 缓存参数组。输入 Valkey 自定义参数组必须具有与现有 Redis OSS 自定义参数组相同的 Redis OSS 静态参数值。

    对于 Linux、macOS 或 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

    对于 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-replication-group

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

使用 help 列出 ElastiCache for Valkey 或 ElastiCache for Redis OSS 的所有可用命令。

aws elasticache help

您还可以使用帮助来描述特定命令并了解有关其用法的详细信息：

aws elasticache create-global-replication-group help