本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 引擎特定參數
**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 參數變更
**參數群組系列：**valkey8
**注意**
Valkey 8.2 參數變更不適用於 Valkey 8.1
Valkey 8.0 及更高版本參數群組與 Redis OSS 7.2.4 不相容。
在 Valkey 8.2 中，下列命令不適用於無伺服器快取：`commandlog`、`commandlog get`、`commandlog len`、 `commandlog help`和 `commandlog reset.`
**Valkey 8.2 中的新參數群組**
| Name | 詳細資訊 | Description |
| --- | --- | --- |
| search-fanout-target-mode （在 8.2 中新增） | 預設：用戶端 類型：字串 可修改：是 變更生效：立即 | search-fanout-target-mode 組態參數可控制搜尋查詢在 Valkey 叢集環境中跨節點分佈的方式。此設定接受兩個值：「輸送量」，其透過隨機在所有叢集節點間分配搜尋查詢來最佳化最大輸送量，無論用戶端類型或 READONLY 狀態為何，以及「用戶端」，其透過僅將非 REDONLY 用戶端路由至主要節點、僅將複本連線上的 READONLY 用戶端路由至複本節點，以及在所有節點間隨機轉接主要連線上的 READONLY 用戶端。 預設行為是「用戶端」模式，表示系統會遵守用戶端連線類型和 READONLY 狀態，以進行查詢路由決策。將輸送量模式用於需要最大叢集資源使用率的大量搜尋工作負載，以及您想要維持讀取/寫入分離和遵守應用程式層級 READONLY 連線模式的用戶端模式。 |
| search-default-timeout-ms | 預設：50000 允許的值：1 到 60000 類型：整數 可修改：是 變更生效：立即 | 預設的 Valkey 搜尋查詢逾時 （以毫秒為單位）。 |
| search-enable-partial-results | 預設：是 允許的值：是、否 類型：布林值 可修改：是 變更生效：立即 | 設定 Valkey 搜尋的查詢失敗行為。啟用時，如果一個或多個碎片發生逾時，搜尋查詢將傳回部分結果。停用時，任何碎片逾時都會導致整個搜尋查詢失敗並傳回錯誤。 |
### Valkey 8.1 參數變更
**參數群組系列：**valkey8
**注意**
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 | 詳細資訊 | Description |
| --- | --- | --- |
| 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 參數變更
**參數群組系列：**valkey8
**注意**
Redis OSS 7.2.4 與 Valkey 8 及更高版本參數群組不相容。
**Valkey 8.0 中的特定參數變更**
| Name | 詳細資訊 | Description |
| --- | --- | --- |
| repl-backlog-size | 預設：10485760 類型：整數 可修改：是 變更生效：立即 | 主要節點待處理項目緩衝區的大小 (位元組)。待處理項目會用於記錄主要節點資料的更新。當僅供讀取複本連線至主要節點時，它會嘗試執行部分同步 (psync)，其中會套用來自待處理項目的資料來跟上主要節點的進度。如果 psync 失敗，則需要完整同步。 此參數的最小值為 16384。 注意：從 Redis OSS 2.8.22 開始，此參數適用於主要叢集和僅供讀取複本。 |
| maxmemory-samples | 預設：3 允許的值：1 到 64 類型：整數 可修改：是 變更生效：立即 | 針對使用時間最遠 (least-recently-used, LRU) 及存活時間 (TTL) 計算，此參數表示要檢查鍵的樣本大小。根據預設，Redis OSS 會選擇 3 個金鑰，並使用最近最少使用的金鑰。 |
**Valkey 8.0 中的新參數群組**
| Name | 詳細資訊 | Description |
| --- | --- | --- |
| extended-redis-compatibility | 允許的值：是、否 預設：是 類型：布林值 可修改：是 變更生效：立即生效 | 延伸 Redis OSS 相容性模式可讓 Valkey 假名成為 Redis OSS 7.2。只有在工具或用戶端發生問題時，才啟用此選項。 面向客戶的影響： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/AmazonElastiCache/latest/dg/ParameterGroups.Engine.html) |
**已移除 Valkey 8.0 中的參數群組**
| Name | 詳細資訊 | Description |
| --- | --- | --- |
| lazyfree-lazy-eviction | 允許的值：是、否 預設：否 類型：布林值 可修改：是 變更生效：立即生效 | 在移出時執行非同步刪除。 |
| lazyfree-lazy-expire | 允許的值：是、否 預設：否 類型：布林值 可修改：是 變更生效：立即生效 | 在過期鍵上執行非同步刪除。 |
| lazyfree-lazy-server-del | 允許的值：是、否 預設：否 類型：布林值 可修改：是 變更生效：立即生效 | 針對更新數值的命令執行非同步刪除。 |
| lazyfree-lazy-user-del | 預設：否 類型：字串 可修改：是 變更生效：直接套用至叢集中所有節點。 | 當值設定為是時，DEL 命令的作用與 UNLINK 相同。 |
| replica-lazy-flush | 預設：是 類型：布林值 可修改：否 先前的名稱：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 | 詳細資訊 | Description |
| --- | --- | --- |
| cluster-allow-pubsubshard-when-down | 允許的值：`yes`、`no` 預設：`yes` 類型：字串 可修改：是 變更生效：直接套用至叢集中所有節點。 | 當預設值為 yes 時，只要叢集認定自身擁有槽，就會允許節點在叢集處於停用狀態時提供 pubsub 碎片流量。 |
| cluster-preferred-endpoint-type | 允許的值：`ip`、`tls-dynamic` 預設：`tls-dynamic` 類型：字串 可修改：是 變更生效：直接套用至叢集中所有節點。 | 此值可控制針對 MOVED/ASHING 要求傳回的端點，以及 `CLUSTER SLOTS` 和 `CLUSTER SHARDS` 的端點欄位。當該值設定為 ip 時，節點會公告其 IP 地址。當值設定為 tls-dynamic 時，節點會在啟用傳輸中加密時公告主機名稱或 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 | 詳細資訊 | Description |
| --- | --- | --- |
| activerehashing | 可修改：`no`。在 Redis OSS 7 中，預設會隱藏並啟用此參數。為了將其停用，您需要建立一個[支援案例](https://console.aws.amazon.com/support/home)。 | 「可修改」先前為「是」。 |
在 Redis OSS 7 中移除的參數如下所示。
| Name | 詳細資訊 | Description |
| --- | --- | --- |
| 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 政策。
如需詳細資訊，請參閱[適用於 Redis OSS 的 ElastiCache 6.2 版 （增強版）](engine-versions.md#redis-version-6.2)及[適用於 Redis OSS 的 ElastiCache 6.0 版 （增強版）](engine-versions.md#redis-version-6.0)。
在 Redis OSS 6.x 中新增的參數如下所示。
| 詳細資訊 | Description |
| --- | --- |
| acl-pubsub-default (added in 6.2) | 允許的值：`resetchannels`、`allchannels` 預設：`allchannels` 類型：字串 可修改：是 變更生效：與叢集相關聯的現有 Redis OSS 使用者將繼續擁有現有的許可。更新使用者或重新啟動叢集以更新現有的 Redis OSS 使用者。 | 部署到此叢集的 ACL 使用者的預設發佈訂閱頻道許可。 |
| cluster-allow-reads-when-down (added in 6.0) | 預設：否 類型：字串 可修改：是 變更生效：直接套用至叢集中所有節點。 | 設定為是時，即使節點無法達到基本人數，Redis OSS （啟用叢集模式） 複寫群組仍會繼續處理讀取命令。 當設定為預設值 no 時，複寫群組會拒絕所有命令。如果您使用的叢集少於三個節點群組，或者您的應用程式可以安全處理過時的讀取作業，建議您將此值設定為 yes。 |
| tracking-table-max-keys (added in 6.0) | 預設值：1,000,000 類型：數字 可修改：是 變更生效：直接套用至叢集中所有節點。 | 為了協助用戶端快取，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 會較高，且延遲也可能更高。除非您發現記憶體使用量很高，且可以容忍 CPU 使用率的增加，否則建議您使用值 1。 |
| lazyfree-lazy-user-del (added in 6.0) | 預設：否 類型：字串 可修改：是 變更生效：直接套用至叢集中所有節點。 | 將值設定為 yes 時，`DEL` 命令的作用與 `UNLINK` 相同。 |
在 Redis OSS 6.x 中移除的參數如下所示。
| Name | 詳細資訊 | Description |
| --- | --- | --- |
| lua-replicate-commands | 允許值：是/否 預設：是 類型：布林值 可修改：是 變更生效：立即生效 | 是否一律在 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 | 詳細資訊 | Description |
| --- | --- | --- |
| rename-commands | 預設：none 類型：字串 可修改：是 變更生效：直接套用至叢集中所有節點。 | 重新命名 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` |
如需詳細資訊，請參閱[適用於 Redis OSS 的 ElastiCache 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 | 詳細資訊 | Description |
| --- | --- | --- |
| 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 | 允許值：是/否 預設：是 類型：布林值 可修改：是 變更生效：立即生效 | 是否一律在 Lua 指令碼中啟用 Lua 效果複寫 |
| replica-ignore-maxmemory | 預設：是 類型：布林值 可修改：否 | 不從主要複本獨立移出項目，決定複本是否要忽略 maxmemory 設定 |
Redis OSS 已重新命名引擎 5.0 版中的多個參數，以回應社群意見回饋。如需詳細資訊，請參閱 [Redis OSS 5 中的最新消息？](https://aws.amazon.com/redis/Whats_New_Redis5/)。下表列出新名稱以及它們與舊版的對應方式。
**在 Redis OSS 5.0 中重新命名的參數**
| Name | 詳細資訊 | Description |
| --- | --- | --- |
| replica-lazy-flush | 預設：是 類型：布林值 可修改：否 先前的名稱：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 | 預設：否 類型：字串 可修改：否 先前的名稱：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 | 預設：是 類型：布林值 可修改：是 先前的名稱：close-on-slave-write 變更生效：立即 | 若啟用，則會中斷嘗試寫入僅供讀取複本的用戶端連線。 |
**在 Redis OSS 5.0 中移除的參數**
| Name | 詳細資訊 | Description |
| --- | --- | --- |
| 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 | 詳細資訊 | Description |
| --- | --- | --- |
| 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 最大記憶體政策。 |
**Redis OSS 4.0.10 中新增的參數**
| Name | 詳細資訊 | Description |
| --- |--- |--- |
| **非同步刪除參數** |
| --- |
| lazyfree-lazy-eviction | 允許值：是/否 預設：否 類型：布林值 可修改：是 變更生效：立即生效 | Performs an asynchronous delete on evictions. |
| lazyfree-lazy-expire | 允許值：是/否 預設：否 類型：布林值 可修改：是 變更生效：立即生效 | Performs an asynchronous delete on expired keys. |
| lazyfree-lazy-server-del | 允許值：是/否 預設：否 類型：布林值 可修改：是 變更生效：立即生效 | Performs an asynchronous delete for commands which update values. |
| slave-lazy-flush | 允許值：N/A 預設：否 類型：布林值 可修改：否 Changes take place: N/A | Performs an asynchronous flushDB during slave sync. |
| **LFU 參數** |
| --- |
| lfu-log-factor | 允許值：任何 > 0 的整數 預設：10 類型：整數 可修改：是 變更生效：立即生效 | Set the log factor, which determines the number of key hits to saturate the key counter. |
| lfu-decay-time | 允許值：任何整數 預設：1 類型：整數 可修改：是 變更生效：立即生效 | The amount of time in minutes to decrement the key counter. |
| **作用中磁碟重組參數** |
| --- |
| activedefrag | 允許值：是/否 預設：否 類型：布林值 可修改：是 變更生效：立即生效 | 啟用主動重組。 在 Valkey 和 Redis OSS 7.0 版及更高版本中，無論此設定為何，AWS可能會在操作上有需要時自動執行重組。 |
| active-defrag-ignore-bytes | 允許值：10485760-104857600 預設：104857600 類型：整數 可修改：是 變更生效：立即生效 | Minimum amount of fragmentation waste to start active defrag. |
| active-defrag-threshold-lower | 允許值：1 到 100 預設：10 類型：整數 可修改：是 變更生效：立即生效 | Minimum percentage of fragmentation to start active defrag. |
| active-defrag-threshold-upper | 允許值：1 到 100 預設：100 類型：整數 可修改：是 變更生效：立即生效 | Maximum percentage of fragmentation at which we use maximum effort. |
| active-defrag-cycle-min | 允許值：1 到 75 預設：25 類型：整數 可修改：是 變更生效：立即生效 | Minimal effort for defrag in CPU percentage. |
| active-defrag-cycle-max | 允許值：1 到 75 預設：75 類型：整數 可修改：是 變更生效：立即生效 | Maximal effort for defrag in CPU percentage. |
| **用戶端輸出緩衝區參數** |
| --- |
| client-query-buffer-limit | 允許值：1048576-1073741824 預設：1073741824 類型：整數 可修改：是 變更生效：立即生效 | Max size of a single client query buffer. |
| proto-max-bulk-len | 允許值：1048576-536870912 預設：536870912 類型：整數 可修改：是 變更生效：立即生效 | Max size of a single element request. |
### Redis OSS 3.2.10 參數變更
**參數群組系列：**redis3.2
ElastiCache for 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 | 詳細資訊 | Description |
| --- | --- | --- |
| list-max-ziplist-size | 預設值：-2 類型：整數 可修改：否 | 清單會以特別的方式進行編碼以節省空間。每個內部清單節點允許的項目數量可透過固定的大小上限或元素數量上限來指定。針對固定的大小上限，請使用 -5 到 -1，表示：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/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_tw/AmazonElastiCache/latest/dg/ParameterGroups.Engine.html) |
| cluster-enabled | 預設：否/是 \$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_tw/AmazonElastiCache/latest/dg/ParameterGroups.Engine.html). |
| cluster-require-full-coverage | 預設：否 類型：布林值 可修改：是 變更生效：立即 | 設為 時`yes`，如果叢集模式中的 Valkey 或 Redis OSS （啟用叢集模式） 節點偵測到至少有一個未覆蓋的雜湊槽 （沒有可用的節點提供服務），則會停止接受查詢。這會在叢集部分關閉時導致叢集無法使用。它會在所有位置再次受到涵蓋時重新恢復可用狀態。 但是，有時候您可能會希望一部分正常運作的叢集針對仍然涵蓋的 keyspace 部分繼續接受查詢。若要這麼做，只需將 `cluster-require-full-coverage` 選項設為 `no` 即可。 |
| hll-sparse-max-bytes | 預設：3000 類型：整數 可修改：是 變更生效：立即 | HyperLogLog 疏鬆表示位元組限制。限制包含 16 位元組的標頭。當使用疏鬆表示的 HyperLogLog 超過此限制時，便會轉換成密集表示。 不建議使用大於 16000 的值，因為屆時密集表示可以更有效率的使用記憶體。 我們建議使用約 3000 的值，來在有效率的使用空間進行編碼的同時不會導致 PFADD 的速度降低太多 (使用疏鬆編碼時)。若 CPU 不在考量範圍內，但空間為考量的項目之一，且資料集是由許多基數介於 0 到 15000 範圍間的 HyperLogLog 組成時，則可以將此值提升到約 10000。 |
| reserved-memory-percent | 預設：25 類型：整數 可修改：是 變更生效：立即 | 為非資料用途預留的節點記憶體百分比。根據預設，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 | 詳細資訊 | 變更 |
| --- | --- | --- |
| 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 | 詳細資訊 | Description |
| --- | --- | --- |
| close-on-slave-write | 預設：是 類型：字串 (是/否) 可修改：是 變更生效：立即 | 若啟用，則會中斷嘗試寫入僅供讀取複本的用戶端連線。 |
#### close-on-slave-write 的運作方式
Amazon ElastiCache 引進了 `close-on-slave-write` 參數，在將僅供讀取複本提升為主節點，導致主節點和僅供讀取複本節點交換角色時，可讓您進一步控制叢集回應的方式。
![\[圖片：close-on-replica-write，一切都運作正常\]](http://docs.aws.amazon.com/zh_tw/AmazonElastiCache/latest/dg/images/ElastiCache-close-on-slave-write-01.png)
若僅供讀取複本叢集因啟用異地同步備份的複寫群組容錯移轉之外的任何原因提升為主要節點，則用戶端會繼續嘗試寫入端點 A。因為端點 A 已成為僅供讀取複本的端點，因此寫入會失敗。這是 ElastiCache 引入之前 Redis OSS 的行為，`close-on-replica-write`以及停用 時的行為`close-on-replica-write`。
![\[圖片：close-on-slave-write，寫入失敗\]](http://docs.aws.amazon.com/zh_tw/AmazonElastiCache/latest/dg/images/ElastiCache-close-on-slave-write-02.png)
啟用 `close-on-replica-write` 時，每一次當用戶端嘗試寫入僅供讀取複本時，便會關閉用戶端對叢集的連線。您的應用程式邏輯應偵測中斷連線、檢查 DNS 表，並重新連線至主要端點 (此時已是端點 B)。
![\[圖片：close-on-slave-write，寫入新的主要叢集\]](http://docs.aws.amazon.com/zh_tw/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 | 詳細資訊 | Description |
| --- | --- | --- |
| 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_tw/AmazonElastiCache/latest/dg/ParameterGroups.Engine.html) 您可以任意組合這些事件類型。例如，*AKE* 表示 Redis OSS 可以發佈所有事件類型的通知。 請不要使用任何以上列出字元以外的字元。嘗試執行此作業會導致錯誤訊息。 根據預設，此參數會設為空字串，表示停用 keyspace 事件通知。 |
| 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_tw/AmazonElastiCache/latest/dg/ParameterGroups.Engine.html) |
### Redis OSS 2.6.13 參數
**參數群組系列：**redis2.6
Redis OSS 2.6.13 是 ElastiCache 支援的第一個 Redis OSS 版本。下表顯示 ElastiCache 支援的 Redis OSS 2.6.13 參數。
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/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` 參數無法修改。
| Node type | Maxmemory | Client-output-buffer-limit-slave-hard-limit | Client-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.r6g.4xlarge | 113609865216 | 11360986522 | 11360986522 |
| cache.r6g.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 版`appendonly`及更新版本`appendfsync`不支援 Redis OSS 組態變數和 。
## 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`。這些變更生效後，您就無法在執行期透過命令啟用/停用 `lru_crawler`。請透過修改自訂參數群組來啟用/停用 `lru_crawler`。
### Memcached 1.6.6 版新增參數
針對 Memcached 1.6.6，沒有支援任何額外參數。
**參數群組系列：**memcached1.6
### Memcached 1.5.10 參數變更
針對 Memcached 1.5.10 版，支援以下額外參數。
**參數群組系列：**memcached1.5
| Name | 詳細資訊 | Description |
| --- | --- | --- |
| no\$1modern | 預設：1 類型：布林值 可修改：是 允許的值：0、1 變更生效：啟動時 | 用於停用 `slab_reassign`、`lru_maintainer_thread`、 `lru_segmented`和`maxconns_fast` 命令的別名。 使用 Memcached 1.5 及更高版本時， `no_modern`也會將 hash\$1algorithm 設定為 `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`已停用，則會`maxconns_fast`啟用 `slab_reassign`、`lru_segmented`、 `lru_maintainer_thread`和 。由於 `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 | 詳細資訊 | Description |
| --- | --- | --- |
| 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 | 詳細資訊 | Description |
| --- | --- | --- |
| 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 | 詳細資訊 | Description |
| --- | --- | --- |
| 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 (停用) 類型：布林值 可修改：是 變更生效：啟動時 | 背景執行緒，可在到達容量時於 LRU 間隨機移動項目。數值：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 | 詳細資訊 | Description |
| --- | --- | --- |
| config\$1max | 預設：16 類型：整數 可修改：否 | ElastiCache 組態項目的數量上限。 |
| config\$1size\$1max | 預設：65536 類型：整數 可修改：否 | 組態項目的大小上限，單位為位元組。 |
| hashpower\$1init | 預設：16 類型：整數 可修改：否 | ElastiCache 雜湊表的初始大小，以 2 的乘冪表示。預設為 16 (2^16)，或 65536 個鍵。 |
| maxconns\$1fast | 預設值：0 (false) 類型：布林值 可修改：是 變更生效：重新啟動後 | 變更到達連線數量上限時處理新連線請求的方式。若將此參數設為 0 (零)，則新的連線會新增到待處理項目佇列，並等待其他連線關閉。若將此參數設為 1，ElastiCache 會將錯誤傳送至用戶端，並立即關閉連線。 |
| slab\$1automove | 預設：0 類型：整數 可修改：是 變更生效：重新啟動後 | 調整 Slab 自動移動演算法：若將此參數設為 0 (零)，則停用自動移動演算法。若設為 1，ElastiCache 會採取緩慢、保守的方式來自動移動 Slab。若設為 2，ElastiCache 會在發生移出時積極移動 Slab。(除非用於測試用途，否則不建議此模式。) |
| slab\$1reassign | 預設值：0 (false) 類型：布林值 可修改：是 變更生效：重新啟動後 | 啟用或停用 Slab 指派。若將此參數設為 1，您可以使用 "slabs reassign" 命令來手動重新指派記憶體。 |
### Memcached 1.4.5 版支援參數
**參數群組系列：**memcached1.4
針對 Memcached 1.4.5 版，支援以下參數。
**Memcached 1.4.5 版中新增的參數**
| Name | 詳細資訊 | Description |
| --- | --- | --- |
| backlog\$1queue\$1limit | 預設：1024 類型：整數 可修改：否 | 待處理佇列限制。 |
| binding\$1protocol | 預設：自動 類型：字串 可修改：是 變更生效：重新啟動後 | 繫結通訊協定。允許值：`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 (True)，則當沒有記憶體可存放項目時，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` 類型的節點具有 1300MB 的 `max_cache_memory`。使用預設 100MB 的 `memcached_connections_overhead` 值，Memcached 程序便會擁有 1200MB，可用於存放項目。
`memcached_connections_overhead` 參數的預設值足以滿足大多數的使用案例。但是，連線額外負荷所需要的配置數量可能會因多項因素而不同，包括請求率、承載大小，以及連線數量。
您可以變更 `memcached_connections_overhead` 的值來更進一步配合您應用程式的需求。例如，增加 `memcached_connections_overhead` 參數的值會減少可用於存放項目的記憶體數量，為連線額外負荷提供更大的緩衝區。減少 `memcached_connections_overhead` 參數的值可讓您擁有更多記憶體來存放項目，但可能會增加切換 (swap) 用量及降低效能。若您察覺切換 (swap) 用量及效能降低，請嘗試增加 `memcached_connections_overhead` 參數的值。
**重要**
針對 `cache.t1.micro` 節點類型，`memcached_connections_overhead` 的值會透過以下方式決定：
若您的叢集使用預設參數群組，ElastiCache 會將 `memcached_connections_overhead` 的值設為 13MB。
若您的叢集使用您自行建立的參數群組，您可以將 `memcached_connections_overhead` 的值設為您所選擇的值。
### Memcached 節點類型專用參數
雖然大多數的參數都只有單一值，有些參數則可能會根據所使用的節點類型而有不同的值。下表顯示每個節點類型 `max_cache_memory` 及 `num_threads` 參數的預設值。這些參數上的值都無法修改。
| Node type | 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) 中建立的。