修改 ElastiCache 参数组 - Amazon ElastiCache
修改参数组（控制台）修改参数组 (Amazon CLI)修改参数组 (ElastiCache API)
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

修改 ElastiCache 参数组

重要

您无法修改任何默认参数组。

您可以修改参数组中的某些参数值。这些参数值应用于与参数组关联的集群。有关参数值更改何时应用于参数组的更多信息，请参阅 Valkey 和 Redis OSS 参数 和 Memcached 特定的参数。

修改参数组（控制台）

以下过程介绍了如何使用 ElastiCache 控制台更改 cluster-enabled 参数的值。您可以使用相同的过程来更改任意参数的值。

使用 ElastiCache 控制台更改参数的值

  1. 登录 Amazon Web Services 管理控制台 并打开 ElastiCache 控制台 (https://console.aws.amazon.com/elasticache/)。

  2. 要查看所有可用的参数组列表，请在导航窗格左侧选择Parameter Groups。

  3. 通过选择参数组名称左侧的框来选择要修改的参数组。

    屏幕底部将列出参数组的参数。您可能需要浏览列表才能查看所有参数。

  4. 要修改一个或多个参数，请选择 Edit Parameters。

  5. 在 Edit Parameter Group:（编辑参数组：）屏幕上，使用左箭头和右箭头滚动找到 binding_protocol 参数，然后在 Value（值）列中键入 ascii。

  6. 选择保存更改。

  7. 对于 Memcached，要查找您更改的参数名称，请参阅 Memcached 特定的参数。如果参数更改在重新启动 生效，则重启使用此参数组的所有集群。有关更多信息，请参阅重启集群。

  8. 对于 Valkey 和 Redis OSS，要查找您更改的参数名称，请参阅Valkey 和 Redis OSS 参数。如果您的集群为 Valkey 和 Redis OSS（已禁用集群模式）集群并对以下参数进行了更改，则您必须重启集群中的节点：

    • activerehashing

    • 数据库

    有关更多信息，请参阅重启节点。

    Valkey 或 Redis OSS（已启用集群模式）参数更改

    如果要更改 Valkey 或 Redis OSS（已启用集群模式）集群上的以下参数，请按照随后的步骤操作。

    • activerehashing

    • 数据库

    1. 对于 Redis OSS，您可以创建集群的手动备份。请参阅进行手动备份。

    2. 请删除集群。请参阅删除集群。

    3. 使用修改的参数组和备份还原集群，以便为新集群创建种子。请参阅从备份还原到新缓存。

    对其他参数的更改不需要执行此操作。

修改参数组 (Amazon CLI)

要使用 Amazon CLI 更改参数值，请使用命令 modify-cache-parameter-group。

对于 Memcached，要查找您要更改的参数名称和允许的值，请参阅 Memcached 特定的参数

以下示例代码演示设置两个参数的值：参数组 myMem14 的 chunk_size 和 chunk_size_growth_fact。

对于 Linux、macOS 或 Unix：

aws elasticache modify-cache-parameter-group \
    --cache-parameter-group-name myMem14 \
    --parameter-name-values \
        ParameterName=chunk_size,ParameterValue=96 \
        ParameterName=chunk_size_growth_fact,ParameterValue=1.5

对于 Windows：

aws elasticache modify-cache-parameter-group ^
    --cache-parameter-group-name myMem14 ^
    --parameter-name-values ^
        ParameterName=chunk_size,ParameterValue=96 ^
        ParameterName=chunk_size_growth_fact,ParameterValue=1.5

此命令的输出如下所示。

{
    "CacheParameterGroupName": "myMem14"
}

对于 Valkey 和 Redis OSS，要查找您要更改的参数名称和允许的值，请参阅 Valkey 和 Redis OSS 参数

以下示例代码演示设置两个参数的值：参数组 myredis32-on-30 的 reserved-memory-percent 和 cluster-enabled。我们将 reserved-memory-percent 设置为 30（30%）并将 cluster-enabled 设置为 yes，以便参数组可与 Valkey 或 Redis OSS（已启用集群模式）集群（复制组）搭配使用。

对于 Linux、macOS 或 Unix：

aws elasticache modify-cache-parameter-group \
    --cache-parameter-group-name myredis32-on-30 \
    --parameter-name-values \
        ParameterName=reserved-memory-percent,ParameterValue=30 \
        ParameterName=cluster-enabled,ParameterValue=yes

对于 Windows：

aws elasticache modify-cache-parameter-group ^
    --cache-parameter-group-name myredis32-on-30 ^
    --parameter-name-values ^
        ParameterName=reserved-memory-percent,ParameterValue=30 ^
        ParameterName=cluster-enabled,ParameterValue=yes

此命令的输出如下所示。

{
    "CacheParameterGroupName": "my-redis32-on-30"
}

有关更多信息，请参阅 modify-cache-parameter-group。

要查找您更改的参数名称，请参阅Valkey 和 Redis OSS 参数。

如果您的集群为 Valkey 和 Redis OSS（已禁用集群模式）集群并对以下参数进行了更改，则您必须重启集群中的节点：

  • activerehashing

  • 数据库

有关更多信息，请参阅重启节点。

Valkey 或 Redis OSS（已启用集群模式）参数更改

如果要更改 Valkey 或 Redis OSS（已启用集群模式）集群上的以下参数，请按照随后的步骤操作。

  • activerehashing

  • 数据库

  1. 创建集群的手动备份。请参阅进行手动备份。

  2. 请删除集群。请参阅删除集群。

  3. 使用修改的参数组和备份还原集群，以便为新集群创建种子。请参阅从备份还原到新缓存。

对其他参数的更改不需要执行此操作。

修改参数组 (ElastiCache API)

要使用 ElastiCache API 更改参数组的参数值，请使用 ModifyCacheParameterGroup 操作。

对于 Memcached，要查找您要更改的参数名称和允许的值，请参阅 Memcached 特定的参数

以下示例代码演示设置两个参数的值：参数组 myMem14 的 chunk_size 和 chunk_size_growth_fact。

https://elasticache.us-west-2.amazonaws.com/
   ?Action=ModifyCacheParameterGroup
   &CacheParameterGroupName=myMem14
   &ParameterNameValues.member.1.ParameterName=chunk_size
   &ParameterNameValues.member.1.ParameterValue=96
   &ParameterNameValues.member.2.ParameterName=chunk_size_growth_fact
   &ParameterNameValues.member.2.ParameterValue=1.5
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &Version=2015-02-02
   &X-Amz-Credential=<credential>

对于 Valkey 和 Redis OSS，要查找您要更改的参数名称和允许的值，请参阅 Valkey 和 Redis OSS 参数

以下示例代码演示设置两个参数的值：参数组 myredis32-on-30 的 reserved-memory-percent 和 cluster-enabled。我们将 reserved-memory-percent 设置为 30（30%）并将 cluster-enabled 设置为 yes，以便参数组可与 Valkey 或 Redis OSS（已启用集群模式）集群（复制组）搭配使用。

https://elasticache.us-west-2.amazonaws.com/
   ?Action=ModifyCacheParameterGroup
   &CacheParameterGroupName=myredis32-on-30
   &ParameterNameValues.member.1.ParameterName=reserved-memory-percent
   &ParameterNameValues.member.1.ParameterValue=30
   &ParameterNameValues.member.2.ParameterName=cluster-enabled
   &ParameterNameValues.member.2.ParameterValue=yes
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &Version=2015-02-02
   &X-Amz-Credential=<credential>

有关更多信息，请参阅 ModifyCacheParameterGroup。

如果您的集群为 Valkey 和 Redis OSS（已禁用集群模式）集群并对以下参数进行了更改，则您必须重启集群中的节点：

  • activerehashing

  • 数据库

有关更多信息，请参阅 重启节点。

Valkey 或 Redis OSS（已启用集群模式）参数更改

如果要更改 Valkey 或 Redis OSS（已启用集群模式）集群上的以下参数，请按照随后的步骤操作。

  • activerehashing

  • 数据库

  1. 创建集群的手动备份。请参阅进行手动备份。

  2. 请删除集群。请参阅在 ElastiCache 中删除集群。

  3. 使用修改的参数组和备份还原集群，以便为新集群创建种子。请参阅从备份还原到新缓存。

对其他参数的更改不需要执行此操作。