修改 ElastiCache 参数组

重要

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

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

修改参数组（控制台）

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

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

1. 登录 AWS Management Console 并打开 ElastiCache 控制台，网址为 https://console.aws.amazon.com/elasticache/。

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

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

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

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

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

6. 选择 Save Changes（保存更改）。

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. 使用修改的参数组和备份还原集群，以便为新集群创建种子。请参阅 从备份还原到新缓存。

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

修改参数组 (AWS CLI)

要使用更改参数的值 AWS 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 参数

以下示例代码设置了两个参数的值，reserved-memory-percent并在参数组上启用了群集。myredis32-on-30我们将集群启用设置为 reserved-memory-percent30(30%)，将集群启用设置为，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 参数

以下示例代码设置了两个参数的值，reserved-memory-percent并在参数组上启用了群集。myredis32-on-30我们将集群启用设置为 reserved-memory-percent30(30%)，将集群启用设置为，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. 使用修改的参数组和备份还原集群，以便为新集群创建种子。请参阅 从备份还原到新缓存。

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