本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 引擎特定参数
**Valkey 和 Redis OSS**
大多数 Valkey 8 参数都与 Redis OSS 7.1 参数兼容。Valkey 7.2 的参数与 Redis OSS 7 的参数相同。
如果您没有为 Valkey 或 Redis OSS 集群指定参数组，则将使用适合您引擎版本的默认参数组。您无法更改默认参数组中的任何参数的值。但是，您可以随时创建自定义参数组并将其分配给集群，只要可按条件修改的参数的值在两个参数组中相同。有关更多信息，请参阅 [创建 ElastiCache 参数组](ParameterGroups.Creating.md)。
**Topics**
+ [Valkey 和 Redis OSS 参数](#ParameterGroups.Redis)
+ [Memcached 特定的参数](#ParameterGroups.Memcached)
## Valkey 和 Redis OSS 参数
**Topics**
+ [Valkey 8.2 参数更改](#ParameterGroups.Valkey.8.2)
+ [Valkey 8.1 参数更改](#ParameterGroups.Valkey.8.1)
+ [Valkey 8.0 参数更改](#ParameterGroups.Valkey.8)
+ [Valkey 7.2 和 Redis OSS 7 参数更改](#ParameterGroups.Redis.7)
+ [Redis OSS 6.x 参数更改](#ParameterGroups.Redis.6-x)
+ [Redis OSS 5.0.3 参数更改](#ParameterGroups.Redis.5-0-3)
+ [Redis OSS 5.0.0 参数更改](#ParameterGroups.Redis.5.0)
+ [Redis OSS 4.0.10 参数更改](#ParameterGroups.Redis.4-0-10)
+ [Redis OSS 3.2.10 参数更改](#ParameterGroups.Redis.3-2-10)
+ [Redis OSS 3.2.6 参数更改](#ParameterGroups.Redis.3-2-6)
+ [Redis OSS 3.2.4 参数更改](#ParameterGroups.Redis.3-2-4)
+ [Redis OSS 2.8.24（加强版）增加的参数](#ParameterGroups.Redis.2-8-24)
+ [Redis OSS 2.8.23（加强版）增加的参数](#ParameterGroups.Redis.2-8-23)
+ [Redis OSS 2.8.22（加强版）增加的参数](#ParameterGroups.Redis.2-8-22)
+ [Redis OSS 2.8.21 增加的参数](#ParameterGroups.Redis.2-8-21)
+ [Redis OSS 2.8.19 增加的参数](#ParameterGroups.Redis.2-8-19)
+ [Redis OSS 2.8.6 增加的参数](#ParameterGroups.Redis.2-8-6)
+ [Redis OSS 2.6.13 参数](#ParameterGroups.Redis.2-6-13)
+ [特定于 Redis OSS 节点类型的参数](#ParameterGroups.Redis.NodeSpecific)
### Valkey 8.2 参数更改
**参数组家族：valk** ey8
**注意**
Valkey 8.2 参数更改不适用于 Valkey 8.1
Valkey 8.0 及更高版本的参数组与 Redis OSS 7.2.4 不兼容。
在 Valkey 8.2 中，以下命令不可用于无服务器缓存：`commandlog`、`commandlog get`、`commandlog help`、`commandlog len` 和 `commandlog reset.`
**Valkey 8.2 中的新参数组**
| Name | Details | 说明 |
| --- | --- | --- |
| search-fanout-target-mode （已在 8.2 中添加） | 默认：客户端 类型：字符串 可修改：是 更改生效：立即 | search-fanout-target-mode配置参数控制如何在 Valkey 集群环境中跨节点分配搜索查询。此设置支持两个值：“throughput”模式通过将搜索查询随机分配至所有集群节点来优化最大吞吐量，不考虑客户端类型或 READONLY 状态；“client”模式则遵循客户端连接特性：将非 READONLY 客户端仅路由至主节点，将 READONLY 客户端仅路由至副本节点上的副本连接，而将主连接上的 READONLY 客户端随机分配至所有节点。 默认行为是“client”模式，即系统将根据客户端连接类型和 READONLY 状态做出查询路由决策。对于需要最大群集资源利用率的大容量搜索工作负载，使用吞吐量模式；如果要保持 read/write 分离并尊重应用程序级 READONLY 连接模式，请使用客户端模式。 |
| search-default-timeout-ms | 默认值：50000 允许的值：1 到 60000 类型：整数 可修改：是 更改生效：立即 | Valkey 搜索查询的默认超时（毫秒）。 |
| search-enable-partial-results | 默认值：yes 允许的值：yes、no 类型：布尔值 可修改：是 更改生效：立即 | 配置 Valkey 搜索的查询失败行为。启用后，如果一个或多个分片出现超时，搜索查询将返回部分结果。禁用后，任何分片超时都将导致整个搜索查询失败并返回错误。 |
### Valkey 8.1 参数更改
**参数组家族：valk** ey8
**注意**
Valkey 8.1 参数更改不适用于 Valkey 8.0
Valkey 8.0 及更高版本的参数组与 Redis OSS 7.2.4 不兼容。
在 Valkey 8.1 中，以下命令不可用于无服务器缓存：`commandlog`、`commandlog get`、`commandlog help`、`commandlog len` 和 `commandlog reset.`
**Valkey 8.1 中的新参数组**
| Name | Details | 说明 |
| --- | --- | --- |
| commandlog-large-request-max-len（在 8.1 中添加） | 默认值：1048576 类型：整数 可修改：是 更改生效：立即 | Valkey 命令日志功能要记录的请求的最大大小（字节）。 |
| commandlog-large-request-max-len（在 8.1 中添加） | 默认值：128 允许的值：0-1024 类型：整数 可修改：是 更改生效：立即 | Valkey 命令日志中请求的最大长度。 |
| commandlog-reply-larger-than （已在 8.1 版本中添加） | 默认值：1048576 类型：整数 可修改：是 更改生效：立即 | Valkey 命令日志功能要记录的响应的最大大小（字节）。 |
| commandlog-large-reply-max-len（在 8.1 中添加） | 默认值：128 允许的值：0-1024 类型：整数 可修改：是 更改生效：立即 | Valkey 命令日志中响应的最大长度。 |
### Valkey 8.0 参数更改
**参数组家族：valk** ey8
**注意**
Redis OSS 7.2.4 与 Valkey 8 及更高版本的参数组不兼容。
**Valkey 8.0 中的特定参数更改**
| Name | Details | 说明 |
| --- | --- | --- |
| repl-backlog-size | 默认值：10485760 类型：整数 可修改：是 更改生效：立即 | 主节点积压缓冲区的大小（以字节为单位）。积压用于记录主节点上数据的更新。只读副本连接到主节点时会尝试执行部分同步（psync），应用积压中的数据以与主节点同步。如果 psync 失败，则需要完整同步。 此参数的最小值为 16384。 注意：从 Redis OSS 2.8.22 开始，此参数应用于主集群以及只读副本。 |
| maxmemory-samples | 原定设置值：3 允许的值：1 到 64 类型：整数 可修改：是 更改生效：立即 | 对于 least-recently-used (LRU) 和 time-to-live (TTL) 计算，此参数表示要检查的密钥的样本量。默认情况下，Redis OSS 选择 3 个键并使用最近最少使用的一个键。 |
**Valkey 8.0 中的新参数组**
| Name | Details | 说明 |
| --- | --- | --- |
| extended-redis-compatibility | 允许的值：yes、no 默认值：yes 类型：布尔值 可修改：是 发生更改：立即 | 扩展的 Redis OSS 兼容模式让 Valkey 可以模拟 Redis OSS 7.2。仅在工具或客户端出现问题时才启用此选项。 面向客户的影响： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonElastiCache/latest/dg/ParameterGroups.Engine.html) |
**在 Valkey 8.0 中移除了参数组**
| Name | Details | 说明 |
| --- | --- | --- |
| lazyfree-lazy-eviction | 允许的值：yes、no 默认值：no 类型：布尔值 可修改：是 发生更改：立即 | 对移出执行异步删除。 |
| lazyfree-lazy-expire | 允许的值：yes、no 默认值：no 类型：布尔值 可修改：是 发生更改：立即 | 对已过期密钥执行异步删除。 |
| lazyfree-lazy-server-del | 允许的值：yes、no 默认值：no 类型：布尔值 可修改：是 发生更改：立即 | 对更新值的命令执行异步删除。 |
| lazyfree-lazy-user-del | 默认值：no 类型：字符串 可修改：是 更改生效：立即跨集群中的所有节点生效 | 当该值设置为“yes”时，DEL 命令的行为与 UNLINK 相同。 |
| replica-lazy-flush | 默认值：yes 类型：布尔值 可修改：否 以前的名字： slave-lazy-flush | 在副本同步期间执行异步 flushDB。 |
### Valkey 7.2 和 Redis OSS 7 参数更改
**参数组系列：**valkey7
Valkey 7.2 默认参数组如下所示：
+ `default.valkey7` – 对 Valkey（已禁用集群模式）集群和复制组使用此参数组或从中派生的参数组。
+ `default.valkey7.cluster.on` – 对 Valkey（已启用集群模式）集群和复制组使用此参数组或从中派生的参数组。
**参数组系列：**redis7
Redis OSS 7 默认参数组如下所示：
+ `default.redis7` – 对 Redis OSS（已禁用集群模式）集群和复制组使用此参数组或从中派生的参数组。
+ `default.redis7.cluster.on` – 对 Redis OSS（已启用集群模式）集群和复制组使用此参数组或从中派生的参数组。
**特定参数更改**
Redis OSS 7 中增加的参数如下所示。Valkey 7.2 也支持这些参数。
| Name | Details | 说明 |
| --- | --- | --- |
| cluster-allow-pubsubshard-when-down | 允许的值：`yes`、`no` 默认值：`yes` 类型：字符串 可修改：是 更改生效：立即跨集群中的所有节点生效。 | 如果设置为默认值“yes”（是），则允许节点在集群处于停机状态时提供发布订阅分片流量，只要它认为自己拥有插槽即可。 |
| cluster-preferred-endpoint-type | 允许的值：`ip`、`tls-dynamic` 默认值：`tls-dynamic` 类型：字符串 可修改：是 更改生效：立即跨集群中的所有节点生效。 | 此值控制 MOVED/ASKING 请求返回的端点以及 `CLUSTER SLOTS` 和 `CLUSTER SHARDS` 的端点字段。当该值设置为 ip 时，节点将传播其 IP 地址。当该值设置为 tls-dynamic 时，节点将在启用时通告主机名 encryption-in-transit，否则通告一个 IP 地址。 |
| latency-tracking | 允许的值：`yes`、`no` 默认值：`no` 类型：字符串 可修改：是 更改生效：立即跨集群中的所有节点生效。 | 设置为“yes”（是）时，将跟踪每个命令的延迟，并允许通过 `INFO` 延迟统计命令导出百分位数分布，并通过 `LATENCY` 命令导出累积延迟分布（直方图）。 |
| hash-max-listpack-entries | 允许的值：`0+` 默认值：`512` 类型：整数 可修改：是 更改生效：立即跨集群中的所有节点生效。 | 压缩数据集所需的最大哈希条目数。 |
| hash-max-listpack-value | 允许的值：`0+` 默认值：`64` 类型：整数 可修改：是 更改生效：立即跨集群中的所有节点生效。 | 压缩数据集所需的最大哈希条目数的阈值。 |
| zset-max-listpack-entries | 允许的值：`0+` 默认值：`128` 类型：整数 可修改：是 更改生效：立即跨集群中的所有节点生效。 | 压缩数据集所需的最大已排序集合条目数。 |
| zset-max-listpack-value | 允许的值：`0+` 默认值：`64` 类型：整数 可修改：是 更改生效：立即跨集群中的所有节点生效。 | 压缩数据集所需的最大已排序集合条目数的阈值。 |
Redis OSS 7 中更改的参数如下所示。
| Name | Details | 说明 |
| --- | --- | --- |
| activerehashing | 可修改：`no`。在 Redis OSS 7 中，默认情况下，此参数处于隐藏和已启用状态。为了禁用此参数，您需要创建一个[支持案例](https://console.aws.amazon.com/support/home)。 | 可修改：是。 |
Redis OSS 7 中删除的参数如下所示。
| Name | Details | 说明 |
| --- | --- | --- |
| hash-max-ziplist-entries | 允许的值：`0+` 默认值：`512` 类型：整数 可修改：是 更改生效：立即跨集群中的所有节点生效。 | 使用 `listpack` 而非 `ziplist` 来表示小哈希编码 |
| hash-max-ziplist-value | 允许的值：`0+` 默认值：`64` 类型：整数 可修改：是 更改生效：立即跨集群中的所有节点生效。 | 使用 `listpack` 而非 `ziplist` 来表示小哈希编码 |
| zset-max-ziplist-entries | 允许的值：`0+` 默认值：`128` 类型：整数 可修改：是 更改生效：立即跨集群中的所有节点生效。 | 使用 `listpack` 而非 `ziplist` 来表示小哈希编码。 |
| zset-max-ziplist-value | 允许的值：`0+` 默认值：`64` 类型：整数 可修改：是 更改生效：立即跨集群中的所有节点生效。 | 使用 `listpack` 而非 `ziplist` 来表示小哈希编码。 |
| list-max-ziplist-size | 允许的值： 默认值：`-2` 类型：整数 可修改：是 更改生效：立即跨集群中的所有节点生效。 | 每个内部列表节点允许的条目数。 |
### Redis OSS 6.x 参数更改
**参数组系列：**redis6.x
Redis OSS 6.x 默认参数组如下所示：
+ `default.redis6.x` – 对 Valkey 或 Redis OSS（已禁用集群模式）集群和复制组使用此参数组或从中派生的参数组。
+ `default.redis6.x.cluster.on` – 对 Valkey 或 Redis OSS（已启用集群模式）集群和复制组使用此参数组或从中派生的参数组。
**注意**
在 Redis OSS 引擎版本 6.2 中，在推出 r6gd 节点系列以使用 [ElastiCache 中的数据分层](data-tiering.md)时，r6gd 节点类型仅支持 *noeviction*、*volatile-lru* 和 *allkeys-lru* max-memory 策略。
有关更多信息，请参阅[ElastiCache 适用于 Redis OSS 的 6.2 版（增强版）](engine-versions.md#redis-version-6.2)和[ElastiCache 适用于 Redis OSS 的 6.0 版（增强版）](engine-versions.md#redis-version-6.0)。
Redis OSS 6.x 中增加的参数如下所示。
| Details | 说明 |
| --- | --- |
| acl-pubsub-default (added in 6.2) | 允许的值：`resetchannels`、`allchannels` 默认值：`allchannels` 类型：字符串 可修改：是 更改的生效范围：与集群关联的现有 Redis OSS 用户将继续拥有现有的权限。需要更新用户或者重新启动集群以更新现有的 Redis OSS 用户。 | 部署到此集群的 ACL 用户将默认拥有发布订阅频道权限。 |
| cluster-allow-reads-when-down (added in 6.0) | 默认值：no 类型：字符串 可修改：是 更改生效：立即跨集群中的所有节点生效 | 当设置为“是”时，Redis OSS（已启用集群模式）复制组将继续处理读取命令，即使节点无法达到主节点的法定数量。 当设置为默认值“no（不）”时，复制组将拒绝所有命令。如果您使用的集群的节点组少于三个，或者您的应用程序可以安全地处理陈旧读取，我们建议将此值设置为“yes（是）”。 |
| tracking-table-max-keys (added in 6.0) | 默认值：1000000 类型：数字 可修改：是 更改生效：立即跨集群中的所有节点生效 | 为了帮助客户端缓存，Redis OSS 支持跟踪哪些客户端访问了哪些键。 当所跟踪的密钥被修改后，会向所有客户端发送失效消息，通知它们缓存的值不再有效。此值允许您指定此表的上限。超出此参数值后，将随机向客户端发送失效。应该调整此值以限制内存使用，同时仍对足够的密钥进行跟踪。在内存不足的情况下，密钥也会失效。 |
| acllog-max-len (added in 6.0) | 默认值：128 类型：数字 可修改：是 更改生效：立即跨集群中的所有节点生效 | 此值对应于 ACL 日志中的最大条目数。 |
| active-expire-effort (added in 6.0) | 默认：1 类型：数字 可修改：是 更改生效：立即跨集群中的所有节点生效 | Redis OSS 会通过两种机制删除超过键自身存活时间的键。一种机制是，访问密钥并发现其已过期。另一种机制是，周期性任务对密钥进行采样，并使那些超过其存活时间的密钥过期。此参数定义 Redis OSS 用于在周期性任务中使项目过期的工作量。 默认值 1 用于避免 10% 以上的过期密钥仍存在于内存中。其还用于避免 25% 以上的总内存被消耗及增加系统的延迟。您可以将此值增加到 10，以提高用在过期密钥上的工作量。需要权衡的是，当 CPU 更高时，延迟也可能会更高。我们建议将值设为 1，除非您发现内存使用率较高，并且可以容忍 CPU 使用率升高。 |
| lazyfree-lazy-user-del (added in 6.0) | 默认值：no 类型：字符串 可修改：是 更改生效：立即跨集群中的所有节点生效 | 当该值设置为“yes”时，`DEL` 命令的行为与 `UNLINK` 相同。 |
Redis OSS 6.x 中删除的参数如下所示。
| Name | Details | 说明 |
| --- | --- | --- |
| lua-replicate-commands | 允许的值：yes/no 默认值：yes 类型：布尔值 可修改：是 更改生效：立即 | 是否始终在 Lua 脚本中启用 Lua 效果复制 |
### Redis OSS 5.0.3 参数更改
**参数组系列：**redis5.0
Redis OSS 5.0 默认参数组
+ `default.redis5.0` – 对 Valkey 或 Redis OSS（已禁用集群模式）集群和复制组使用此参数组或从中派生的参数组。
+ `default.redis5.0.cluster.on` – 对 Valkey 或 Redis OSS（已启用集群模式）集群和复制组使用此参数组或从中派生的参数组。
**Redis OSS 5.0.3 中增加的参数**
| Name | Details | 说明 |
| --- | --- | --- |
| rename-commands | 默认：无 类型：字符串 可修改：是 更改生效：立即跨集群中的所有节点生效 | 重命名的 Redis OSS 命令列表，以空格分隔。以下是可用于重命名的命令的限制列表： `APPEND AUTH BITCOUNT BITFIELD BITOP BITPOS BLPOP BRPOP BRPOPLPUSH BZPOPMIN BZPOPMAX CLIENT CLUSTER COMMAND DBSIZE DECR DECRBY DEL DISCARD DUMP ECHO EVAL EVALSHA EXEC EXISTS EXPIRE EXPIREAT FLUSHALL FLUSHDB GEOADD GEOHASH GEOPOS GEODIST GEORADIUS GEORADIUSBYMEMBER GET GETBIT GETRANGE GETSET HDEL HEXISTS HGET HGETALL HINCRBY HINCRBYFLOAT HKEYS HLEN HMGET HMSET HSET HSETNX HSTRLEN HVALS INCR INCRBY INCRBYFLOAT INFO KEYS LASTSAVE LINDEX LINSERT LLEN LPOP LPUSH LPUSHX LRANGE LREM LSET LTRIM MEMORY MGET MONITOR MOVE MSET MSETNX MULTI OBJECT PERSIST PEXPIRE PEXPIREAT PFADD PFCOUNT PFMERGE PING PSETEX PSUBSCRIBE PUBSUB PTTL PUBLISH PUNSUBSCRIBE RANDOMKEY READONLY READWRITE RENAME RENAMENX RESTORE ROLE RPOP RPOPLPUSH RPUSH RPUSHX SADD SCARD SCRIPT SDIFF SDIFFSTORE SELECT SET SETBIT SETEX SETNX SETRANGE SINTER SINTERSTORE SISMEMBER SLOWLOG SMEMBERS SMOVE SORT SPOP SRANDMEMBER SREM STRLEN SUBSCRIBE SUNION SUNIONSTORE SWAPDB TIME TOUCH TTL TYPE UNSUBSCRIBE UNLINK UNWATCH WAIT WATCH ZADD ZCARD ZCOUNT ZINCRBY ZINTERSTORE ZLEXCOUNT ZPOPMAX ZPOPMIN ZRANGE ZRANGEBYLEX ZREVRANGEBYLEX ZRANGEBYSCORE ZRANK ZREM ZREMRANGEBYLEX ZREMRANGEBYRANK ZREMRANGEBYSCORE ZREVRANGE ZREVRANGEBYSCORE ZREVRANK ZSCORE ZUNIONSTORE SCAN SSCAN HSCAN ZSCAN XINFO XADD XTRIM XDEL XRANGE XREVRANGE XLEN XREAD XGROUP XREADGROUP XACK XCLAIM XPENDING GEORADIUS_RO GEORADIUSBYMEMBER_RO LOLWUT XSETID SUBSTR` |
有关更多信息，请参阅 [ElastiCache 适用于 Redis OSS 的 5.0.6 版（增强版）](engine-versions.md#redis-version-5-0.6)。
### Redis OSS 5.0.0 参数更改
**参数组系列：**redis5.0
Redis OSS 5.0 默认参数组
+ `default.redis5.0` – 对 Valkey 或 Redis OSS（已禁用集群模式）集群和复制组使用此参数组或从中派生的参数组。
+ `default.redis5.0.cluster.on` – 对 Valkey 或 Redis OSS（已启用集群模式）集群和复制组使用此参数组或从中派生的参数组。
**Redis OSS 5.0 中增加的参数**
| Name | Details | 说明 |
| --- | --- | --- |
| stream-node-max-bytes | 允许的值：0\$1 默认值：4096 类型：整数 可修改：是 更改生效：立即 | 流数据结构是节点的基数树，这些节点对内部的多个项进行编码。使用此配置指定基数树中单个节点的最大大小（以字节为单位）。如果设置为 0，则树节点的大小是不受限制的。 |
| stream-node-max-entries | 允许的值：0\$1 默认值：100 类型：整数 可修改：是 更改生效：立即 | 流数据结构是节点的基数树，这些节点对内部的多个项进行编码。使用此配置指定在追加新的流条目时切换到新节点之前单个节点可包含的项的最大数目。如果设置为 0，则树节点中的项数是不受限制的 |
| active-defrag-max-scan-fields | 允许的值：1 到 1000000 默认值：1000 类型：整数 可修改：是 更改生效：立即 | 将从主词典扫描中处理的最大set/hash/zset/list字段数 |
| lua-replicate-commands | 允许的值：yes/no 默认值：yes 类型：布尔值 可修改：是 更改生效：立即 | 是否始终在 Lua 脚本中启用 Lua 效果复制 |
| replica-ignore-maxmemory | 默认值：yes 类型：布尔值 可修改：否 | 确定副本是否通过不移出独立于主节点的项来忽略 maxmemory 设置 |
Redis OSS 已在引擎版本 5.0 中重命名几个参数以响应社区反馈。有关更多信息，请参阅 [Redis OSS 5 中的新增功能](https://aws.amazon.com/redis/Whats_New_Redis5/)。下表列出了新名称以及它们映射到早期版本的方式。
**Redis OSS 5.0 中已重命名的参数**
| Name | Details | 说明 |
| --- | --- | --- |
| replica-lazy-flush | 默认值：yes 类型：布尔值 可修改：否 以前的名字： slave-lazy-flush | 在副本同步期间执行异步 flushDB。 |
| client-output-buffer-limit-replica-hard-limit | 默认值：有关值的信息，请参阅 [特定于 Redis OSS 节点类型的参数](#ParameterGroups.Redis.NodeSpecific) 类型：整数 可修改：否 以前的名字：client-output-buffer-limit-slave-hard-limit | 对于 Redis OSS 只读副本：如果客户端的输出缓冲区达到指定字节数，则客户端将断开连接。 |
| client-output-buffer-limit-replica-soft-limit | 默认值：有关值的信息，请参阅 [特定于 Redis OSS 节点类型的参数](#ParameterGroups.Redis.NodeSpecific) 类型：整数 可修改：否 以前的名字：client-output-buffer-limit-slave-soft-limit | 对于 Redis OSS 只读副本：如果客户端的输出缓冲区达到指定字节数，仅当此条件保持 client-output-buffer-limit-replica-soft-seconds 时间时，客户端将断开连接。 |
| client-output-buffer-limit-replica-soft-seconds | 默认值：60 类型：整数 可修改：否 以前的名字：client-output-buffer-limit-slave-soft-seconds | 对于 Redis OSS 只读副本：如果客户端的输出缓冲区保持 client-output-buffer-limit-replica-soft-limit 字节的时间长于此秒数，则客户端将断开连接。 |
| replica-allow-chaining | 默认值：no 类型：字符串 可修改：否 以前的名字： slave-allow-chaining | 确定 Redis OSS 中的只读副本是否可以具有自己的只读副本。 |
| min-replicas-to-write | 默认：0 类型：整数 可修改：是 以前的名字： min-slaves-to-write 更改生效：立即 | 使主节点可以从客户端接受写入所必需的可用只读副本的最小数目。如果可用副本数下降到低于此数字，则主节点不再接受写入请求。 如果此参数或 min-replicas-max-lag为 0，则即使没有副本可用，主节点也将始终接受写入请求。 |
| min-replicas-max-lag | 默认值：10 类型：整数 可修改：是 以前的名字： min-slaves-max-lag 更改生效：立即 | 主节点必须从只读副本收到 Ping 请求的秒数。如果此时间量已过，但主节点未收到 Ping，则不再将副本视为可用。如果可用副本的数量降至以下 min-replicas-to-write，则主副本将在此时停止接受写入。 如果此参数或 min-replicas-to-write为 0，则即使没有副本可用，主节点也将始终接受写入请求。 |
| close-on-replica-write | 默认值：yes 类型：布尔值 可修改：是 以前的名字： close-on-slave-write 更改生效：立即 | 如果启用，尝试写入只读副本的客户端将会断开连接。 |
**Redis OSS 5.0 中已删除的参数**
| Name | Details | 说明 |
| --- | --- | --- |
| repl-timeout | 默认值：60 可修改：否 | 此版本中不提供参数。 |
### Redis OSS 4.0.10 参数更改
**参数组系列：** redis4.0
Redis OSS 4.0.x 默认参数组
+ `default.redis4.0` – 对 Valkey 或 Redis OSS（已禁用集群模式）集群和复制组使用此参数组或从中派生的参数组。
+ `default.redis4.0.cluster.on` – 对 Valkey 或 Redis OSS（已启用集群模式）集群和复制组使用此参数组或从中派生的参数组。
**Redis OSS 4.0.10 中已更改的参数**
| Name | Details | 说明 |
| --- | --- | --- |
| maxmemory-policy | 允许的值：`allkeys-lru`、`volatile-lru`、**allkeys-lfu**、**volatile-lfu**、`allkeys-random`、`volatile-random`、`volatile-ttl`、`noeviction` 默认值：volatile-lru 类型：字符串 可修改：是 发生更改：立即 | 在 2.6.13 版中增加了 maxmemory-policy。在版本 4.0.10 中增加了两个新允许的值：allkeys-lfu（将使用近似的 LFU 移出任何键）；和 volatile-lfu（将使用近似的 LFU 移出具有过期设置的键）。在 6.2 版中，在推出 r6gd 节点系列以支持数据分层功能时，r6gd 节点类型仅支持 noeviction、volatile-lru 和 allkeys-lru max-memory 策略 |
**Redis OSS 4.0.10 中增加的参数**
| Name | Details | 说明 |
| --- |--- |--- |
| **异步删除参数** |
| --- |
| lazyfree-lazy-eviction | 允许的值：yes/no 默认值：no 类型：布尔值 可修改：是 发生更改：立即 | 对移出执行异步删除。 |
| lazyfree-lazy-expire | 允许的值：yes/no 默认值：no 类型：布尔值 可修改：是 发生更改：立即 | 对已过期密钥执行异步删除。 |
| lazyfree-lazy-server-del | 允许的值：yes/no 默认值：no 类型：布尔值 可修改：是 发生更改：立即 | 对更新值的命令执行异步删除。 |
| slave-lazy-flush | 允许的值：N/A 默认值：no 类型：布尔值 可修改：否 发生更改：N/A | 在从属同步期间执行异步 flushDB。 |
| **LFU 参数** |
| --- |
| lfu-log-factor | 允许的值：任意整数 > 0 默认值：10 类型：整数 可修改：是 发生更改：立即 | 设置日志因素，这确定键命中数以使键计数器饱和。 |
| lfu-decay-time | 允许的值：任意整数 默认：1 类型：整数 可修改：是 发生更改：立即 | 减少键计数器的时间，以分钟为单位。 |
| **有效的碎片整理参数** |
| --- |
| activedefrag | 允许的值：yes/no 默认值：no 类型：布尔值 可修改：是 发生更改：立即 | 启用有效的碎片整理。 在 Valkey 和 Redis 7.0 及更高版本中，无论此AWS设置如何，都可以在操作必要时自动执行碎片整理。 |
| active-defrag-ignore-bytes | 允许的值：10485760 – 104857600 默认值：104857600 类型：整数 可修改：是 发生更改：立即 | 启动有效碎片整理的碎片垃圾最低量。 |
| active-defrag-threshold-lower | 允许的值：1-100 默认值：10 类型：整数 可修改：是 发生更改：立即 | 启动有效碎片整理的碎片最低百分比。 |
| active-defrag-threshold-upper | 允许的值：1-100 默认值：100 类型：整数 可修改：是 发生更改：立即 | 我们使用最大精力的碎片最高百分比。 |
| active-defrag-cycle-min | 允许的值：1-75 默认值：25 类型：整数 可修改：是 发生更改：立即 | 用于碎片整理的最少精力，以 CPU 百分比为单位。 |
| active-defrag-cycle-max | 允许的值：1-75 默认值：75 类型：整数 可修改：是 发生更改：立即 | 用于碎片整理的最多精力，以 CPU 百分比为单位。 |
| **客户端输出缓冲区参数** |
| --- |
| client-query-buffer-limit | 允许的值：1048576 – 1073741824 默认值：1073741824 类型：整数 可修改：是 发生更改：立即 | 单个客户端查询缓冲区的最大大小。 |
| proto-max-bulk-len | 允许的值：1048576 – 536870912 默认值：536870912 类型：整数 可修改：是 发生更改：立即 | 单个元素请求的最大大小。 |
### Redis OSS 3.2.10 参数更改
**参数组系列：** redis3.2
ElastiCache 对于 Redis OSS 3.2.10，不支持其他参数。
### Redis OSS 3.2.6 参数更改
**参数组系列：** redis3.2
对于 Redis OSS 3.2.6，不支持附加参数。
### Redis OSS 3.2.4 参数更改
**参数组系列：** redis3.2
从 Redis OSS 3.2.4 开始，提供两个默认参数组。
+ `default.redis3.2` – 在运行 Redis OSS 3.2.4 时，如果您需要创建 Valkey 或 Redis OSS（已禁用集群模式）复制组并仍使用 Redis OSS 3.2.4 的附加功能，请指定此参数组或从中派生的参数组。
+ `default.redis3.2.cluster.on` – 当您需要创建 Valkey 或 Redis OSS（已启用集群模式）复制组时，请指定此参数组或从中派生的参数组。
**Topics**
+ [Redis OSS 3.2.4 的新参数](#ParameterGroups.Redis.3-2-4.New)
+ [Redis OSS 3.2.4 中已更改的参数（加强版）](#ParameterGroups.Redis.3-2-4.Changed)
#### Redis OSS 3.2.4 的新参数
**参数组系列：** redis3.2
对于 Redis OSS 3.2.4，支持以下附加参数。
****
| Name | Details | 说明 |
| --- | --- | --- |
| list-max-ziplist-size | 默认值：-2 类型：整数 可修改：否 | 将采用特殊方式对列表进行编码以节省空间。可将每个内部列表节点允许的条目数指定为固定的最大大小或最大元素数。对于固定最大大小，请使用数字 -5 到 -1，含义如下：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonElastiCache/latest/dg/ParameterGroups.Engine.html) |
| list-compress-depth | 默认：0 类型：整数 可修改：是 更改生效：立即 | 也可以压缩列表。压缩深度是要从压缩中排除的列表各端的 quicklist ziplist 节点的数目。始终不会压缩列表的首尾以便执行快速推送和弹出操作。设置为：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonElastiCache/latest/dg/ParameterGroups.Engine.html) |
| cluster-enabled | 默认： no/yes \$1 类型：字符串 可修改：否 | 指示这是处于集群模式（“是”）的 Valkey 或 Redis OSS（已启用集群模式）复制组，还是处于非集群模式（“否”）的 Valkey 或 Redis OSS（已启用集群模式）复制组。集群模式下的 Valkey 或 Redis OSS（已启用集群模式）复制组可跨最多 500 个节点组对数据进行分区。 \$1 Redis OSS 3.2.*x* 具有两个默认参数组。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonElastiCache/latest/dg/ParameterGroups.Engine.html). |
| cluster-require-full-coverage | 默认值：no 类型：布尔值 可修改：是 更改生效：立即 | 如果设为 `yes`，集群模式下的 Valkey 或 Redis OSS（已启用集群模式）节点会在检测到至少一个未覆盖的哈希槽（没有节点为其提供服务）时停止接受查询。因此，如果集群部分出现故障，则整个集群将不可用。只要所有槽全都覆盖到，它就会自动恢复可用。 但有时，您需要让集群的子集能够继续接受仍覆盖到的键空间部分的查询。为此，请将 `cluster-require-full-coverage` 选项设为 `no`。 |
| hll-sparse-max-bytes | 默认值：3000 类型：整数 可修改：是 更改生效：立即 | HyperLogLog 稀疏表示字节限制。限制包括 16 个字节的标头。当 HyperLogLog 使用稀疏表示超过此限制时，它将转换为密集表示。 不建议使用超过 16000 的值，因为此时密集表现形式具有更高的内存效率。 我们建议使用 3000 左右的值来获得空间效率较高的编码，同时不会过多地降低 PFADD 效率，即稀疏编码的复杂度为 O(N)。如果不考虑CPU，而是空间，并且数据集由许多 HyperLogLogs 基数介于 0-15000 范围内的数据集组成，则可以将该值提高到大约 10000。 |
| reserved-memory-percent | 默认值：25 类型：整数 可修改：是 更改生效：立即 | 为非数据使用预留的节点内存的百分比。默认情况下，Redis OSS 数据占用会一直增长，直至消耗掉节点的所有内存。如果发生这种情况，可能会因内存分页过多而影响节点性能。通过预留内存，您可以为非 Redis OSS 用途留出一些可用内存，以帮助减少分页量。 此参数特定于标准 Redis OSS 发行版 ElastiCache，不属于标准 Redis OSS 发行版的一部分。 有关更多信息，请参阅`reserved-memory`和[管理 Valkey 和 Redis OSS 的预留内存](redis-memory-management.md)。 |
#### Redis OSS 3.2.4 中已更改的参数（加强版）
**参数组系列：** redis3.2
对于 Redis OSS 3.2.4，以下参数已更改。
****
| Name | Details | 更改 |
| --- | --- | --- |
| activerehashing | 可修改：如果参数组未与任何集群关联，则为“是”。否则不是必需。 | 可修改：否。 |
| databases | 可修改：如果参数组未与任何集群关联，则为“是”。否则不是必需。 | 可修改：否。 |
| appendonly | 默认：关闭 可修改：否 | 如果您需要从早期版本的 Redis OSS 升级，则必须先禁用 `appendonly`。 |
| appendfsync | 默认：关闭 可修改：否 | 如果您需要从早期版本的 Redis OSS 升级，则必须先禁用 `appendfsync`。 |
| repl-timeout | 默认值：60 可修改：否 | 目前无法修改，默认值为 60。 |
| tcp-keepalive | 默认：300 | 默认值为 0。 |
| list-max-ziplist-entries | | 参数不再可用。 |
| list-max-ziplist-value | | 参数不再可用。 |
### Redis OSS 2.8.24（加强版）增加的参数
**参数组系列：** redis2.8
对于 Redis OSS 2.8.24，不支持附加参数。
### Redis OSS 2.8.23（加强版）增加的参数
**参数组系列：** redis2.8
对于 Redis OSS 2.8.23，支持以下附加参数。
****
| Name | Details | 说明 |
| --- | --- | --- |
| close-on-slave-write | 默认值：yes 类型：字符串（yes/no） 可修改：是 更改生效：立即 | 如果启用，尝试写入只读副本的客户端将会断开连接。 |
#### close-on-slave-write 的工作原理
该`close-on-slave-write`参数由 Amazon ElastiCache 引入，可让您更好地控制集群在主节点和只读副本节点因将只读副本提升为主节点而交换角色时群集的响应方式。
![\[图片： close-on-replica-write，一切正常\]](http://docs.aws.amazon.com/zh_cn/AmazonElastiCache/latest/dg/images/ElastiCache-close-on-slave-write-01.png)
如果出于支持多可用区的复制组发生故障转移之外的任何其他原因，只读副本集群提升为主集群，则客户端将继续尝试写入端点 A。由于端点现在是只读副本的端点，这些写入将会失败。这是 Redis OSS 在ElastiCache 引入之前的行为，`close-on-replica-write`以及禁`close-on-replica-write`用后的行为。
![\[图片: close-on-slave-write，写入失败\]](http://docs.aws.amazon.com/zh_cn/AmazonElastiCache/latest/dg/images/ElastiCache-close-on-slave-write-02.png)
在启用 `close-on-replica-write` 的情况下，只要客户端尝试写入只读副本，客户端与集群的连接就会被关闭。您的应用程序逻辑应检测断开连接情况，检查 DNS 表，然后重新连接到主端点（现在是端点 B）。
![\[Image: close-on-slave-write，正在写入新的主群集\]](http://docs.aws.amazon.com/zh_cn/AmazonElastiCache/latest/dg/images/ElastiCache-close-on-slave-write-03.png)
#### 何时可以禁用 close-on-replica-write
如果禁用 `close-on-replica-write` 会导致写入集群的操作失败，那么为什么禁用 `close-on-replica-write`？
如前所述，在启用 `close-on-replica-write` 的情况下，只要客户端尝试写入只读副本，客户端与集群的连接就会被关闭。建立与节点的新连接需要时间。因此，由于对副本的写入请求而断开连接并重新连接也会影响通过相同连接处理的读取请求的延迟。在建立新连接之前，此影响会持续存在。如果您的应用程序主要执行大量读取操作或者对延迟非常敏感，您可能使客户端保持连接，以避免降低读取性能。
### Redis OSS 2.8.22（加强版）增加的参数
**参数组系列：** redis2.8
对于 Redis OSS 2.8.22，不支持附加参数。
**重要**
从 Redis OSS 版本 2.8.22 开始，`repl-backlog-size` 应用于主集群以及副本集群。
从 Redis OSS 版本 2.8.22 开始，不支持 `repl-timeout` 参数。如果它被更改， ElastiCache 将像我们一样用默认值（60 秒）覆盖。`appendonly`
不再支持以下参数。
+ *appendonly*
+ *appendfsync*
+ *repl-timeout*
### Redis OSS 2.8.21 增加的参数
**参数组系列：** redis2.8
对于 Redis OSS 2.8.21，不支持附加参数。
### Redis OSS 2.8.19 增加的参数
**参数组系列：** redis2.8
对于 Redis OSS 2.8.19，不支持附加参数。
### Redis OSS 2.8.6 增加的参数
**参数组系列：** redis2.8
对于 Redis OSS 2.8.6，支持以下附加参数。
****
| Name | Details | 说明 |
| --- | --- | --- |
| min-slaves-max-lag | 默认值：10 类型：整数 可修改：是 更改生效：立即 | 主节点必须从只读副本收到 Ping 请求的秒数。如果此时间量已过，但主节点未收到 Ping，则不再将副本视为可用。如果可用副本的数量降至以下 min-slaves-to-write，则主副本将在此时停止接受写入。 如果此参数或 min-slaves-to-write为 0，则即使没有副本可用，主节点也将始终接受写入请求。 |
| min-slaves-to-write | 默认：0 类型：整数 可修改：是 更改生效：立即 | 使主节点可以从客户端接受写入所必需的可用只读副本的最小数目。如果可用副本数下降到低于此数字，则主节点不再接受写入请求。 如果此参数或 min-slaves-max-lag为 0，则即使没有副本可用，主节点也将始终接受写入请求。 |
| notify-keyspace-events | 默认值：（空字符串） 类型：字符串 可修改：是 更改生效：立即 | Redis OSS 可以向客户端通知的键空间事件类型。每种事件类型由单个字母表示： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonElastiCache/latest/dg/ParameterGroups.Engine.html) 您可以使用这些事件类型的任何组合。例如，*AKE* 表示 Redis OSS 可以发布所有事件类型的通知。 请勿使用上面未列出的任何字符；尝试这样操作会导致错误消息。 默认情况下，此参数设置为空字符串，这表示禁用了键空间事件通知。 |
| repl-backlog-size | 默认值：1048576 类型：整数 可修改：是 更改生效：立即 | 主节点积压缓冲区的大小（以字节为单位）。积压用于记录主节点上数据的更新。只读副本连接到主节点时会尝试执行部分同步（`psync`），应用积压中的数据以与主节点同步。如果 `psync` 失败，则需要完整同步。 此参数的最小值为 16384。 从 Redis OSS 2.8.22 开始，此参数应用于主集群以及只读副本。 |
| repl-backlog-ttl | 默认值：3600 类型：整数 可修改：是 更改生效：立即 | 主节点保留积压缓冲区的秒数。从上一个副本节点断开连接时开始，积压中的数据将保持不变，直到 `repl-backlog-ttl` 过期。如果副本未在此时间内连接到主节点，则主节点会释放积压缓冲区。当副本最终重新连接时，它必须执行与主节点的完整同步。 如果此参数设置为 0，则永不释放积压缓冲区。 |
| repl-timeout | 默认值：60 类型：整数 可修改：是 更改生效：立即 | 表示超时期限（以秒为单位），适用于：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonElastiCache/latest/dg/ParameterGroups.Engine.html) |
### Redis OSS 2.6.13 参数
**参数组系列：** redis2.6
Redis OSS 2.6.13 是支持的 Redis OSS 的第一个版本。 ElastiCache下表显示了支持的 Redis OSS 2.6.13 参数。 ElastiCache
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonElastiCache/latest/dg/ParameterGroups.Engine.html)
**注意**
如果您没有为 Redis OSS 2.6.13 集群指定参数组，则将使用默认的参数组（`default.redis2.6`）。您不能在默认的参数组中更改任何参数的值；但是，您始终可以创建自定义参数组，然后随时将其分配给您的集群。
### 特定于 Redis OSS 节点类型的参数
虽然大多数参数具有单个值，但是某些参数根据使用的节点类型具有不同的值。下表显示了每种节点类型的 `maxmemory`、`client-output-buffer-limit-slave-hard-limit` 和 `client-output-buffer-limit-slave-soft-limit` 参数的默认值。`maxmemory` 的值是节点上可供您使用（数据和其他用途）的最大字节数。有关更多信息，请参阅[可用内存](https://aws.amazon.com/premiumsupport/knowledge-center/available-memory-elasticache-redis-node/)。
**注意**
无法修改 `maxmemory` 参数。
| 节点类型 | Maxmemory | C lient-output-buffer-limit-slave-hard-limit | C lient-output-buffer-limit-slave-soft-limit |
| --- | --- | --- | --- |
| cache.t1.micro | 142606336 | 14260633 | 14260633 |
| cache.t2.micro | 581959680 | 58195968 | 58195968 |
| cache.t2.small | 1665138688 | 166513868 | 166513868 |
| cache.t2.medium | 3461349376 | 346134937 | 346134937 |
| cache.t3.micro | 536870912 | 53687091 | 53687091 |
| cache.t3.small | 1471026299 | 147102629 | 147102629 |
| cache.t3.medium | 3317862236 | 331786223 | 331786223 |
| cache.t4g.micro | 536870912 | 53687091 | 53687091 |
| cache.t4g.small | 1471026299 | 147102629 | 147102629 |
| cache.t4g.medium | 3317862236 | 331786223 | 331786223 |
| cache.m1.small | 943718400 | 94371840 | 94371840 |
| cache.m1.medium | 3093299200 | 309329920 | 309329920 |
| cache.m1.large | 7025459200 | 702545920 | 702545920 |
| cache.m1.xlarge | 14889779200 | 1488977920 | 1488977920 |
| cache.m2.xlarge | 17091788800 | 1709178880 | 1709178880 |
| cache.m2.2xlarge | 35022438400 | 3502243840 | 3502243840 |
| cache.m2.4xlarge | 70883737600 | 7088373760 | 7088373760 |
| cache.m3.medium | 2988441600 | 309329920 | 309329920 |
| cache.m3.large | 6501171200 | 650117120 | 650117120 |
| cache.m3.xlarge | 14260633600 | 1426063360 | 1426063360 |
| cache.m3.2xlarge | 29989273600 | 2998927360 | 2998927360 |
| cache.m4.large | 6892593152 | 689259315 | 689259315 |
| cache.m4.xlarge | 15328501760 | 1532850176 | 1532850176 |
| cache.m4.2xlarge | 31889126359 | 3188912636 | 3188912636 |
| cache.m4.4xlarge | 65257290629 | 6525729063 | 6525729063 |
| cache.m4.10xlarge | 166047614239 | 16604761424 | 16604761424 |
| cache.m5.large | 6854542746 | 685454275 | 685454275 |
| cache.m5.xlarge | 13891921715 | 1389192172 | 1389192172 |
| cache.m5.2xlarge | 27966669210 | 2796666921 | 2796666921 |
| cache.m5.4xlarge | 56116178125 | 5611617812 | 5611617812 |
| cache.m5.12xlarge | 168715971994 | 16871597199 | 16871597199 |
| cache.m5.24xlarge | 337500562842 | 33750056284 | 33750056284 |
| cache.m6g.large | 6854542746 | 685454275 | 685454275 |
| cache.m6g.xlarge | 13891921715 | 1389192172 | 1389192172 |
| cache.m6g.2xlarge | 27966669210 | 2796666921 | 2796666921 |
| cache.m6g.4xlarge | 56116178125 | 5611617812 | 5611617812 |
| cache.m6g.8xlarge | 111325552312 | 11132555231 | 11132555231 |
| cache.m6g.12xlarge | 168715971994 | 16871597199 | 16871597199 |
| cache.m6g.16xlarge | 225000375228 | 22500037523 | 22500037523 |
| cache.c1.xlarge | 6501171200 | 650117120 | 650117120 |
| cache.r3.large | 14470348800 | 1468006400 | 1468006400 |
| cache.r3.xlarge | 30513561600 | 3040870400 | 3040870400 |
| cache.r3.2xlarge | 62495129600 | 6081740800 | 6081740800 |
| cache.r3.4xlarge | 126458265600 | 12268339200 | 12268339200 |
| cache.r3.8xlarge | 254384537600 | 24536678400 | 24536678400 |
| cache.r4.large | 13201781556 | 1320178155 | 1320178155 |
| cache.r4.xlarge | 26898228839 | 2689822883 | 2689822883 |
| cache.r4.2xlarge | 54197537997 | 5419753799 | 5419753799 |
| cache.r4.4xlarge | 108858546586 | 10885854658 | 10885854658 |
| cache.r4.8xlarge | 218255432090 | 21825543209 | 21825543209 |
| cache.r4.16xlarge | 437021573120 | 43702157312 | 43702157312 |
| cache.r5.large | 14037181030 | 1403718103 | 1403718103 |
| cache.r5.xlarge | 28261849702 | 2826184970 | 2826184970 |
| cache.r5.2xlarge | 56711183565 | 5671118356 | 5671118356 |
| cache.r5.4xlarge | 113609865216 | 11360986522 | 11360986522 |
| cache.r5.12xlarge | 341206346547 | 34120634655 | 34120634655 |
| cache.r5.24xlarge | 682485973811 | 68248597381 | 68248597381 |
| cache.r6g.large | 14037181030 | 1403718103 | 1403718103 |
| cache.r6g.xlarge | 28261849702 | 2826184970 | 2826184970 |
| cache.r6g.2xlarge | 56711183565 | 5671118356 | 5671118356 |
| cache.r6g.4xlarge | 113609865216 | 11360986522 | 11360986522 |
| cache.r6g.8xlarge | 225000375228 | 22500037523 | 22500037523 |
| cache.r6g.12xlarge | 341206346547 | 34120634655 | 34120634655 |
| cache.r6g.16xlarge | 450000750456 | 45000075046 | 45000075046 |
| cache.r6gd.xlarge | 28261849702 | 2826184970 | 2826184970 |
| cache.r6gd.2xlarge | 56711183565 | 5671118356 | 5671118356 |
| cache.r6gd.4xlarge | 113609865216 | 11360986522 | 11360986522 |
| cache.r6gd.8xlarge | 225000375228 | 22500037523 | 22500037523 |
| cache.r6gd.12xlarge | 341206346547 | 34120634655 | 34120634655 |
| cache.r6gd.16xlarge | 450000750456 | 45000075046 | 45000075046 |
| cache.r7g.large | 14037181030 | 1403718103 | 1403718103 |
| cache.r7g.xlarge | 28261849702 | 2826184970 | 2826184970 |
| cache.r7g.2xlarge | 56711183565 | 5671118356 | 5671118356 |
| cache.r7g.4xlarge | 113609865216 | 11360986522 | 11360986522 |
| cache.r7g.8xlarge | 225000375228 | 22500037523 | 22500037523 |
| cache.r7g.12xlarge | 341206346547 | 34120634655 | 34120634655 |
| cache.r7g.16xlarge | 450000750456 | 45000075046 | 45000075046 |
| cache.m7g.large | 6854542746 | 685454275 | 685454275 |
| cache.m7g.xlarge | 13891921715 | 1389192172 | 1389192172 |
| cache.m7g.2xlarge | 27966669210 | 2796666921 | 2796666921 |
| cache.m7g.4xlarge | 56116178125 | 5611617812 | 5611617812 |
| cache.m7g.8xlarge | 111325552312 | 11132555231 | 11132555231 |
| cache.m7g.12xlarge | 168715971994 | 16871597199 | 16871597199 |
| cache.m7g.16xlarge | 225000375228 | 22500037523 | 22500037523 |
| cache.c7gn.large | 3317862236 | 1403718103 | 1403718103 |
| cache.c7gn.xlarge | 6854542746 | 2826184970 | 2826184970 |
| cache.c7gn.2xlarge | 13891921715 | 5671118356 | 5671118356 |
| cache.c7gn.4xlarge | 27966669210 | 11360986522 | 11360986522 |
| cache.c7gn.8xlarge | 56116178125 | 22500037523 | 22500037523 |
| cache.c7gn.12xlarge | 84357985997 | 34120634655 | 34120634655 |
| cache.c7gn.16xlarge | 113609865216 | 45000075046 | 45000075046 |
**注意**
默认情况下，所有最新一代实例类型将在 Amazon Virtual Private Cloud VPC 中创建。
T1 实例不支持多可用区。
T1 和 T2 实例不支持 Redis OSS AOF。
Redis OSS 版本 2.8.22 及更高版本不支持 Redis OSS 配置变量 `appendonly` 和 `appendfsync`。
## Memcached 特定的参数
**Memcached**
如果您没有为 Memcached 集群指定参数组，则将使用适合您引擎版本的默认参数组。您无法更改默认参数组中的任何参数的值。但是，您可以随时创建自定义参数组并将其分配给集群。有关更多信息，请参阅 [创建 ElastiCache 参数组](ParameterGroups.Creating.md)。
**Topics**
+ [Memcached 1.6.17 更改](#ParameterGroups.Memcached.1.6.17)
+ [Memcached 1.6.6 增加的参数](#ParameterGroups.Memcached.1-6-6)
+ [Memcached 1.5.10 参数更改](#ParameterGroups.Memcached.1-5-10)
+ [Memcached 1.4.34 增加的参数](#ParameterGroups.Memcached.1-4-34)
+ [Memcached 1.4.33 增加的参数](#ParameterGroups.Memcached.1-4-33)
+ [Memcached 1.4.24 增加的参数](#ParameterGroups.Memcached.1-4-24)
+ [Memcached 1.4.14 增加的参数](#ParameterGroups.Memcached.1-4-14)
+ [Memcached 1.4.5 支持的参数](#ParameterGroups.Memcached.1-4-5)
+ [Memcached 连接开销](#ParameterGroups.Memcached.Overhead)
+ [特定于 Memcached 节点类型的参数](#ParameterGroups.Memcached.NodeSpecific)
### Memcached 1.6.17 更改
从 Memcached 1.6.17 开始，我们不再支持以下管理命令：`lru_crawler`、`lru` 和 `slabs`。通过这些更改，您将无法 enable/disable `lru_crawler`在运行时通过命令进行操作。请 enable/disable `lru_crawler`修改您的自定义参数组。
### Memcached 1.6.6 增加的参数
对于 Memcached 1.6.6，不支持任何附加参数。
**参数组系列：**memcached1.6
### Memcached 1.5.10 参数更改
对于 Memcached 1.5.10，支持以下附加参数。
**参数组系列：**memcached1.5
| Name | Details | 说明 |
| --- | --- | --- |
| no\$1modern | 默认：1 类型：布尔值 可修改：是 允许的值：0,1 更改生效：启动时 | 用于禁用 `slab_reassign`、`lru_maintainer_thread`、`lru_segmented` 和 `maxconns_fast` 命令的别名。 使用 Memcached 1.5 及更高版本时，`no_modern` 还会将哈希算法设置为 `jenkins`。 此外，在使用 Memcached 1.5.10 时，`inline_ascii_reponse` 由参数 `parallelly` 控制。这意味着 `no_modern` 被禁用，那么 `inline_ascii_reponse` 也会被禁用。从 Memcached 引擎 1.5.16 起，`inline_ascii_response` 参数不再适用，因此启用或禁用 `no_modern` 对 `inline_ascii_reponse` 没有影响。 如果 `no_modern` 内禁用，则 `slab_reassign`、`lru_maintainer_thread`、`lru_segmented` 和 `maxconns_fast` 将启用。由于 `slab_automove` 和 `hash_algorithm` 参数不是 SWITCH 参数，它们的设置将基于参数组中的配置。 如果要禁用 `no_modern` 并恢复到 `modern`，您必须配置一个自定义参数组来禁用该参数，然后重新启动以使这些更改生效。 自 2021 年 8 月 20 日起，此参数的原定设置配置值已从 0 改为 1。2021 年 8 月 20 日之后，每个地区的新ElastiCache 用户将自动选择更新的默认值。2021 年 8 月 20 日之前所在地区的现有 ElastiCache 用户需要手动修改其自定义参数组才能接受这一新更改。 |
| inline\$1ascii\$1resp | 默认：0 类型：布尔值 可修改：是 允许的值：0,1 更改生效：启动时 | 存储项中的 `VALUE` 响应的数字，最多使用 24 个字节。ASCII `get` 和 `faster` 集的速度较慢。 |
对于 Memcached 1.5.10，删除了以下参数。
| Name | Details | 说明 |
| --- | --- | --- |
| expirezero\$1does\$1not\$1evict | 默认：0 类型：布尔值 可修改：是 允许的值：0,1 更改生效：启动时 | 在此版本中不再受支持。 |
| modern | 默认：1 类型：布尔值 可修改：是（如果设置为 `no_modern`，则需要重新启动） 允许的值：0,1 更改生效：启动时 | 在此版本中不再受支持。从此版本开始，默认情况下，每次启动或重新启动时都会启用 `no-modern`。 |
### Memcached 1.4.34 增加的参数
对于 Memcached 1.4.34，不支持任何附加参数。
**参数组系列：** memcached1.4
### Memcached 1.4.33 增加的参数
对于 Memcached 1.4.33，支持以下附加参数。
**参数组系列：** memcached1.4
| Name | Details | 说明 |
| --- | --- | --- |
| modern | 默认值：启用 类型：布尔值 可修改：是 更改生效：启动时 | 访问多项功能的别名。启用 `modern` 等同于启用以下命令并使用 murmur3 哈希算法：`slab_reassign`、`slab_automove`、`lru_crawler`、`lru_maintainer`、`maxconns_fast` 和 `hash_algorithm=murmur3`。 |
| watch | 默认值：启用 类型：布尔值 可修改：是 更改生效：立即 在用户达到其 `watcher_logbuf_size` 和 `worker_logbuf_size` 限制时可以删除日志。 | 日志提取、移出或更改。例如，在用户启用 `watch` 时，出现 `get`、`set`、`delete` 或 `update` 的情况下可以查看日志。 |
| idle\$1timeout | 默认值：0（禁用） 类型：整数 可修改：是 更改生效：启动时 | 在要求关闭客户端之前，允许客户端保持空闲的最短秒数。取值范围：0 到 86400。 |
| track\$1sizes | 默认值：禁用 类型：布尔值 可修改：是 更改生效：启动时 | 显示每个 slab 组已用的大小。 启用 `track_sizes` 可让您运行 `stats sizes` 而无需运行 `stats sizes_enable`， |
| watcher\$1logbuf\$1size | 默认值：256 (KB) 类型：整数 可修改：是 更改生效：启动时 | `watch` 命令启用 Memcached 的流日志记录。但是，在移出、更改或提取速率足够高而导致了日志记录缓冲区满填满时，`watch` 可以删除日志。在这些情况下，用户可以增加缓冲区大小以减少日志丢失的可能性。 |
| worker\$1logbuf\$1size | 默认值：64 (KB) 类型：整数 可修改：是 更改生效：启动时 | `watch` 命令启用 Memcached 的流日志记录。但是，在移出、更改或提取速率足够高而导致了日志记录缓冲区满填满时，`watch` 可以删除日志。在这些情况下，用户可以增加缓冲区大小以减少日志丢失的可能性。 |
| slab\$1chunk\$1max | 默认值：524288 (字节) 类型：整数 可修改：是 更改生效：启动时 | 指定 slab 的最大大小。设置较小的 slab 大小可以更有效地使用内存。大于 `slab_chunk_max` 的项目将拆分为多个 slab。 |
| lru\$1crawler metadump [all\$11\$12\$13] | 默认值：禁用 类型：布尔值 可修改：是 更改生效：立即 | 如果启用了 lru\$1crawler，则此命令会转储所有键。 `all\|1\|2\|3` - 所有 slab，或者指定特定 slab 编号 |
### Memcached 1.4.24 增加的参数
对于 Memcached 1.4.24，支持以下附加参数。
**参数组系列：** memcached1.4
| Name | Details | 说明 |
| --- | --- | --- |
| disable\$1flush\$1all | 默认值：0（禁用） 类型：布尔值 可修改：是 更改生效：启动时 | 添加参数 (`-F`) 以禁用 flush\$1all。如果您再也不想在生产实例上运行完全刷新，则这样做会很有用。 值：0，1（当值为 0 时，用户可以执行 `flush_all`）。 |
| hash\$1algorithm | 默认值：jenkins 类型：字符串 可修改：是 更改生效：启动时 | 要使用的哈希算法。允许的值：murmur3 和 jenkins。 |
| lru\$1crawler | 默认值：0（禁用） 类型：布尔值 可修改：是 更改生效：重新启动后 您可在运行时通过命令行临时启用 `lru_crawler`。有关更多信息，请参阅“描述”列。 | 清除已过期的项目的 Slab 类。此过程在后台运行，并且产生的影响很小。目前要求使用手动命令来启用网络爬取。 要临时启用网络爬取，请在命令行处运行 `lru_crawler enable`。 `lru_crawler 1,3,5` 对 Slab 类 1、3 和 5 进行网络爬取，以查找要添加到空闲列表的过期项目。 值：0，1 在命令行处启用 `lru_crawler` 将启用爬网程序，直到在命令行处或下次重启时将其禁用。要永久性启用爬网程序，您必须修改参数值。有关更多信息，请参阅 [修改 ElastiCache 参数组](ParameterGroups.Modifying.md)。 |
| lru\$1maintainer | 默认值：0（禁用） 类型：布尔值 可修改：是 更改生效：启动时 | 一个后台线程，用于在达到容量时在 LRUs 之间随机播放项目。值：0，1。 |
| expirezero\$1does\$1not\$1evict | 默认值：0（禁用） 类型：布尔值 可修改：是 更改生效：启动时 | 在与 `lru_maintainer` 一起使用时，使过期时间为 0 的项目不可收回。 这可以挤出内存以供其他可收回项目使用。 可以设置为忽略 `lru_maintainer`。 |
### Memcached 1.4.14 增加的参数
对于 Memcached 1.4.14，支持以下附加参数。
**参数组系列：** memcached1.4
**Memcached 1.4.14 中添加的参数**
| Name | Details | 说明 |
| --- | --- | --- |
| config\$1max | 默认值：16 类型：整数 可修改：否 | ElastiCache 配置条目的最大数量。 |
| config\$1size\$1max | 默认值：65536 类型：整数 可修改：否 | 配置条目的最大大小（单位：字节）。 |
| hashpower\$1init | 默认值：16 类型：整数 可修改：否 | ElastiCache 哈希表的初始大小，以二的乘数表示。默认值为 16 (2^16) 或 65536 长度的密钥。 |
| maxconns\$1fast | 默认值：0 (false) 类型：布尔值 可修改：是 更改生效：重新启动后 | 在达到最大连接限制时，请更改处理新连接请求的方式。如果将此参数设为 0（即零），新连接将被添加至缓冲区队列，并将等待直到其他连接已关闭。如果参数设置为 1，则向客户端 ElastiCache 发送错误并立即关闭连接。 |
| slab\$1automove | 默认：0 类型：整数 可修改：是 更改生效：重新启动后 | 调整 Slab 自动移动算法：如果将此参数设为 0（即零），自动移动算法将禁用。如果将参数设为 1，ElastiCache 便会采用一种缓慢而保守的方法来自动移动 Slab。如果将其设置为 2，则每当有人驱逐时，都会 ElastiCache 积极移动石板。（建议不要使用此模式，测试用途除外）。 |
| slab\$1reassign | 默认值：0 (false) 类型：布尔值 可修改：是 更改生效：重新启动后 | 启用或禁用 Slab 重新分配。如果将此参数设为 1，您可以使用“Slab 重新分配”命令来手动重新分配内存。 |
### Memcached 1.4.5 支持的参数
**参数组系列：** memcached1.4
对于 Memcached 1.4.5，支持以下参数。
**Memcached 1.4.5 中添加的参数**
| Name | Details | 说明 |
| --- | --- | --- |
| backlog\$1queue\$1limit | 默认值：1024 类型：整数 可修改：否 | 积压队列限制。 |
| binding\$1protocol | 默认值：auto 类型：字符串 可修改：是 更改生效：重新启动后 | 绑定协议。允许的值为：`ascii` 和 `auto`。 有关修改 `binding_protocol` 的值的指南，请参阅[修改 ElastiCache 参数组](ParameterGroups.Modifying.md)。 |
| cas\$1disabled | 默认值：0 (false) 类型：布尔值 可修改：是 更改生效：重新启动后 | 如果为 1 (true)，则检查和设置 (CAS) 操作将禁用，存储的项目消耗的字节将比启用 CAS 时消耗的字节少 8 字节。 |
| chunk\$1size | 默认值：48 类型：整数 可修改：是 更改生效：重新启动后 | 为最小项目的密钥、值和标志分配的最小空间量（以字节为单位）。 |
| chunk\$1size\$1growth\$1factor | 默认值：1.25 类型：浮点数 可修改：是 更改生效：重新启动后 | 控制各个连续 Memcached 区块的大小的增长系数；每个区块将比前一个区块大 chunk\$1size\$1growth\$1factor 倍。 |
| error\$1on\$1memory\$1exhausted | 默认值：0 (false) 类型：布尔值 可修改：是 更改生效：重新启动后 | 如果 1（为真），当没有更多的内存用于存储项目时，Memcached 将返回一个错误，而非移出项目。 |
| large\$1memory\$1pages | 默认值：0 (false) 类型：布尔值 可修改：否 | 如果 1 (true)， ElastiCache 将尝试使用较大的内存页。 |
| lock\$1down\$1paged\$1memory | 默认值：0 (false) 类型：布尔值 可修改：否 | 如果 1 (true)， ElastiCache 将锁定所有分页内存。 |
| max\$1item\$1size | 默认值：1048576 类型：整数 可修改：是 更改生效：重新启动后 | 可以存储在集群中的最大项目的大小（单位：字节）。 |
| max\$1simultaneous\$1connections | 默认值：65000 类型：整数 可修改：否 | 最大同时连接数。 |
| maximize\$1core\$1file\$1limit | 默认值：0 (false) 类型：布尔值 可修改: 更改生效：重新启动后 | 如果 1 (true)， ElastiCache 将最大化核心文件限制。 |
| memcached\$1connections\$1overhead | 默认值：100 类型：整数 可修改：是 更改生效：重新启动后 | 为 Memcached 连接和其他杂项开支预留的内存量。有关此参数的信息，请参阅[Memcached 连接开销](#ParameterGroups.Memcached.Overhead)。 |
| requests\$1per\$1event | 默认值：20 类型：整数 可修改：否 | 每个事件请求获取给定连接的最大数量。此限制需要防止资源匮乏。 |
### Memcached 连接开销
每个节点上可用于存储项目的内存计算方式为：此节点上的总可用内存（存储于 `max_cache_memory` 参数中）减去连接和其他开支所占用的内存（存储于 `memcached_connections_overhead` 参数中）。例如，`cache.m1.small` 类型的节点的 `max_cache_memory` 为 1300MB。`memcached_connections_overhead` 的默认值为 100MB，Memcached 进程可用于存储项目的内存则为 1200MB。
`memcached_connections_overhead` 参数的默认值满足大多数用例；然而，分配给连接开支的必需量会因多种因素（包括请求率、有效负载大小和连接数）而异。
您可以更改 `memcached_connections_overhead` 的值，以更好地满足您的应用程序的需求。例如，增大 `memcached_connections_overhead` 参数的值将减少用于存储项目的内存量，并为连接开销提供更大的缓冲区。减小 `memcached_connections_overhead` 参数的值将为您提供更多的内存来存储项目，但可能会增加使用交换分区和性能下降的风险。如果您发现交换分区使用情况和性能降低，请尝试增加 `memcached_connections_overhead` 参数的值。
**重要**
对于 `cache.t1.micro` 节点类型，`memcached_connections_overhead` 的值是通过以下方式决定：
如果您的集群使用默认参数组，则 ElastiCache 会将的值设置`memcached_connections_overhead`为 13MB。
如果您的集群使用的是您自己创建的参数组，那么您可以将 `memcached_connections_overhead` 的值设置为您选定的值。
### 特定于 Memcached 节点类型的参数
虽然大多数参数具有单个值，但是某些参数根据使用的节点类型具有不同的值。下表显示了每种节点类型的 `max_cache_memory` 和 `num_threads` 参数的默认值。无法修改这些参数的值。
| 节点类型 | max\$1cache\$1memory（单位：MB） | num\$1threads |
| --- | --- | --- |
| cache.t1.micro | 213 | 1 |
| cache.t2.micro | 555 | 1 |
| cache.t2.small | 1588 | 1 |
| cache.t2.medium | 3301 | 2 |
| cache.t3.micro | 512 | 2 |
| cache.t3.small | 1402 | 2 |
| cache.t3.medium | 3364 | 2 |
| cache.t4g.micro | 512 | 2 |
| cache.t4g.small | 1402 | 2 |
| cache.t4g.medium | 3164 | 2 |
| cache.m1.small | 1301 | 1 |
| cache.m1.medium | 3350 | 1 |
| cache.m1.large | 7100 | 2 |
| cache.m1.xlarge | 14600 | 4 |
| cache.m2.xlarge | 33800 | 2 |
| cache.m2.2xlarge | 30412 | 4 |
| cache.m2.4xlarge | 68000 | 16 |
| cache.m3.medium | 2850 | 1 |
| cache.m3.large | 6200 | 2 |
| cache.m3.xlarge | 13600 | 4 |
| cache.m3.2xlarge | 28600 | 8 |
| cache.m4.large | 6573 | 2 |
| cache.m4.xlarge | 11496 | 4 |
| cache.m4.2xlarge | 30412 | 8 |
| cache.m4.4xlarge | 62234 | 16 |
| cache.m4.10xlarge | 158355 | 40 |
| cache.m5.large | 6537 | 2 |
| cache.m5.xlarge | 13248 | 4 |
| cache.m5.2xlarge | 26671 | 8 |
| cache.m5.4xlarge | 53516 | 16 |
| cache.m5.12xlarge | 160900 | 48 |
| cache.m5.24xlarge | 321865 | 96 |
| cache.m6g.large | 6537 | 2 |
| cache.m6g.xlarge | 13248 | 4 |
| cache.m6g.2xlarge | 26671 | 8 |
| cache.m6g.4xlarge | 53516 | 16 |
| cache.m6g.8xlarge | 107000 | 32 |
| cache.m6g.12xlarge | 160900 | 48 |
| cache.m6g.16xlarge | 214577 | 64 |
| cache.c1.xlarge | 6600 | 8 |
| cache.r3.large | 13800 | 2 |
| cache.r3.xlarge | 29100 | 4 |
| cache.r3.2xlarge | 59600 | 8 |
| cache.r3.4xlarge | 120600 | 16 |
| cache.r3.8xlarge | 120600 | 32 |
| cache.r4.large | 12590 | 2 |
| cache.r4.xlarge | 25652 | 4 |
| cache.r4.2xlarge | 51686 | 8 |
| cache.r4.4xlarge | 103815 | 16 |
| cache.r4.8xlarge | 208144 | 32 |
| cache.r4.16xlarge | 416776 | 64 |
| cache.r5.large | 13387 | 2 |
| cache.r5.xlarge | 26953 | 4 |
| cache.r5.2xlarge | 54084 | 8 |
| cache.r5.4xlarge | 108347 | 16 |
| cache.r5.12xlarge | 325400 | 48 |
| cache.r5.24xlarge | 650869 | 96 |
| cache.r6g.large | 13387 | 2 |
| cache.r6g.xlarge | 26953 | 4 |
| cache.r6g.2xlarge | 54084 | 8 |
| cache.r6g.4xlarge | 108347 | 16 |
| cache.r6g.8xlarge | 214577 | 32 |
| cache.r6g.12xlarge | 325400 | 48 |
| cache.r6g.16xlarge | 429154 | 64 |
| cache.c7gn.large | 3164 | 2 |
| cache.c7gn.xlarge | 6537 | 4 |
| cache.c7gn.2xlarge | 13248 | 8 |
| cache.c7gn.4xlarge | 26671 | 16 |
| cache.c7gn.8xlarge | 53516 | 32 |
| cache.c7gn.12xlarge | 325400 | 48 |
| cache.c7gn.16xlarge | 108347 | 64 |
**注意**
所有 T2 实例都是在 Amazon Virtual Private Cloud (Amazon VPC) 中创建的。