本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 引擎特定參數
<a name="parametergroups.redis"></a>

如果您未指定 Valkey 或 Redis OSS 叢集的參數群組，則會使用適合您引擎版本的預設參數群組。您無法變更預設參數群組中任何參數的值。但是，只要可條件式修改參數的值在兩個參數群組中都是相同的，您便可以建立自訂參數群組並隨時將其指派給您的叢集。如需詳細資訊，請參閱[建立參數群組](parametergroups.creating.md)。

**Topics**
+ [

## Valkey 7 和 Redis OSS 7 參數變更
](#ParameterGroups.Redis.7)
+ [

## Redis OSS 6 參數
](#parametergroups.redis.6-x)
+ [

## MemoryDB 節點類型特定參數
](#parametergroups.redis.nodespecific)

## Valkey 7 和 Redis OSS 7 參數變更
<a name="ParameterGroups.Redis.7"></a>

**注意**  
MemoryDB 推出[向量搜尋](https://docs.aws.amazon.com/memorydb/latest/devguide/vector-search.html)，其中包含新的不可變參數群組 `default.memorydb-valkey7.search`。此參數群組可在 MemoryDB 主控台中使用，以及使用 [create](https://docs.aws.amazon.com/cli/latest/reference/memorydb/create-cluster.html)vector-search-enabled的叢集時使用。預覽版可在下列AWS區域使用：美國東部 （維吉尼亞北部）、美國東部 （俄亥俄）、美國西部 （奧勒岡）、亞太區域 （東京） 和歐洲 （愛爾蘭）。

**參數群組系列：** memorydb\$1valkey7

在 Valkey 7 和 Redis OSS 7 中新增的參數如下所示。


|  Name  |  詳細資訊 |  Description  | 
| --- | --- | --- | 
| 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` 類型：整數 可修改：是 變更生效：直接套用至叢集中所有節點。 | 要壓縮資料集的雜湊有序集項目數目上限。  | 
| search-enabled |  允許的值：`yes, no` 預設：`no` 類型：字串 可修改：是 變更生效：僅適用於新叢集。 最低引擎版本：7.1  | 設定為是時，會啟用搜尋功能。  | 
| search-query-timeout-ms |  允許的值：`1 - 60,000` 預設：`10,000` 類型：整數 可修改：是 變更生效：直接套用至叢集中所有節點。 最低引擎版本：7.1  | 允許執行搜尋查詢的時間上限，以毫秒為單位。  | 

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` 來表示小雜湊編碼。  | 

## Redis OSS 6 參數
<a name="parametergroups.redis.6-x"></a>

**注意**  
在 Redis OSS 引擎 6.2 版中，當引進 r6gd 節點系列以搭配 使用時[資料分層](data-tiering.md)，r6gd 節點類型僅支援 `noeviction``volatile-lru`和 `allkeys-lru` 最大記憶體政策。

**參數群組系列：** memorydb\$1redis6

Redis OSS 6 中新增的參數如下。


|  Name  |  詳細資訊 |  Description  | 
| --- | --- | --- | 
|  maxmemory-policy  |  類型：STRING 允許的值：volatile-lru、allkeys-lru、volatile-lfu、allkeys-lfu、volatile-random、allkeys-random、volatile-ttl、noeviction 預設：noeviction  |  到達記憶體用量上限時，針對鍵的移出政策。如需使用 Valkey 或 Redis OSS 做為 LRU 快取的詳細資訊，請參閱[金鑰移出](https://valkey.io/topics/lru-cache)。  | 
|  list-compress-depth |  類型：INTEGER 允許的值：0- 預設：0 | 壓縮深度是來自清單每一端的快速清單 (quicklist) 壓縮清單 (ziplist) 節點數量，這些節點會從壓縮中排除。清單的前端和尾端一律不會進行壓縮，以進行快速的推送及彈出操作。設定如下：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/memorydb/latest/devguide/parametergroups.redis.html) | 
|  hll-sparse-max-bytes |  類型：INTEGER 允許的值：1-16000 預設：3000 |  HyperLogLog 疏鬆表示位元組限制。限制包含 16 位元組的標頭。當使用疏鬆表示的 HyperLogLog 超過此限制時，便會轉換成密集表示。 不建議使用大於 16000 的值，因為屆時密集表示可以更有效率的使用記憶體。 我們建議值約為 3000，以享有節省空間編碼的優點，而不會`PFADD`太慢，也就是使用稀疏編碼的 O(N)。若 CPU 不在考量範圍內，但空間為考量的項目之一，且資料集是由許多基數介於 0 到 15000 範圍間的 HyperLogLog 組成時，則可以將此值提升到約 10000。 | 
|  lfu-log-factor |  類型：INTEGER 允許的值：1- 預設：10 |  LFU 移出政策遞增索引鍵計數器的日誌因素。 | 
|  lfu-decay-time |  類型：INTEGER 允許的值：0- 預設：1 |  減少 LFU 移出政策之金鑰計數器的時間，以分鐘為單位。 | 
|  active-defrag-max-scan-fields |  類型：INTEGER 允許的值：1-1000000 預設：1000 |  在作用中重組期間，將從主要字典掃描處理的 set/hash/zset/list 欄位數目上限。 | 
|  active-defrag-threshold-upper |  類型：INTEGER 允許值：1 到 100 預設：100 |  進行最大程度投入量所需要的最高分散百分比。 | 
|  client-output-buffer-limit-pubsub-hard-limit |  類型：INTEGER 允許的值：0- 預設：33554432 |  對於 Redis OSS 發佈/訂閱用戶端：如果用戶端的輸出緩衝區達到指定的位元組數，用戶端將會中斷連線。 | 
|  client-output-buffer-limit-pubsub-soft-limit |  類型：INTEGER 允許的值：0- 預設：8388608 |  對於 Redis OSS 發佈/訂閱用戶端：如果用戶端的輸出緩衝區達到指定的位元組數，則用戶端會中斷連線，但前提是此條件仍存在 `client-output-buffer-limit-pubsub-soft-seconds.` | 
|  client-output-buffer-limit-pubsub-soft-seconds |  類型：INTEGER 允許的值：0- 預設：60 |  對於 Redis OSS 發佈/訂閱用戶端：如果用戶端的輸出緩衝區停留在`client-output-buffer-limit-pubsub-soft-limit`位元組超過此秒數，用戶端將會中斷連線。 | 
|  timeout |  類型：INTEGER 允許的值：0，20- 預設：0 |  節點在逾時前等待的秒數。數值為： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/memorydb/latest/devguide/parametergroups.redis.html)  | 
|  notify-keyspace-events |  類型：STRING 允許的值：NULL 預設：NULL | Redis OSS 要通知 Pub/Sub 用戶端的金鑰空間事件。預設會停用所有通知。 | 
|  maxmemory-samples |  類型：INTEGER 允許的值：1- 預設：3 |  對於最近least-recently-used `(LRU)`和 `time-to-live (TTL)`計算，此參數代表要檢查的金鑰大小範例。根據預設，Redis OSS 會選擇 3 個金鑰，並使用最近最少使用的金鑰。 | 
|  slowlog-max-len |  類型：INTEGER 允許的值：0- 預設：128 |  Redis OSS 慢速日誌的長度上限。此長度沒有限制。請注意，它會耗用記憶體。您可以使用 回收慢速日誌所使用的記憶體 `SLOWLOG RESET.` | 
|  activerehashing |  類型：STRING 允許的值：是、否 預設：是 |  主要雜湊表會每秒重新雜湊十次。每一次的重新雜湊操作都會使用 1 毫秒的 CPU 時間。 您可以在建立參數群組時設定此值。將新的參數群組指派給叢集時，此值在舊的及新的參數群組中都必須相同。 | 
|  client-output-buffer-limit-normal-hard-limit |  類型：INTEGER 允許的值：0- 預設：0 |  若用戶端的輸出緩衝區達到指定的位元組數，便會中斷用戶端連線。預設為零 (無硬式限制)。 | 
|  client-output-buffer-limit-normal-soft-limit |  類型：INTEGER 允許的值：0- 預設：0 |  若用戶端的輸出緩衝區達到指定的位元組數，便會中斷用戶端連線，但只有在此條件持續達 `client-output-buffer-limit-normal-soft-seconds` 時。預設為零 (無軟式限制)。 | 
|  client-output-buffer-limit-normal-soft-seconds |  類型：INTEGER 允許的值：0- 預設：0 |  若用戶端的輸出緩衝區維持在 `client-output-buffer-limit-normal-soft-limit` 位元組超過此秒數，便會中斷用戶端連線。預設為零 (無時間限制)。 | 
|  tcp-keepalive |  類型：INTEGER 允許的值：0- 預設：300 |  若將此設為非零值 (N)，節點用戶端便會每 N 秒輪詢一次，確保仍然持續連線。使用預設設定的 0，便步會發生任何輪詢。 | 
|  active-defrag-cycle-min |  類型：INTEGER 允許值：1 到 75 預設：5 |  用於磁碟重組的最小投入量 (CPU 百分比)。 | 
|  stream-node-max-bytes |  類型：INTEGER 允許的值：0- 預設：4096 |  串流資料結構是節點基數樹狀結構，它會在內部編碼多個項目。使用這個組態可指定基數樹狀結構中單一節點的最大大小 (以位元組為單位)。如果設為 0，則節點的大小沒有限制。 | 
|  stream-node-max-entries |  類型：INTEGER 允許的值：0- 預設：100 |  串流資料結構是節點基數樹狀結構，它會在內部編碼多個項目。使用此組態來指定在附加新串流項目時，切換至新節點之前，單一節點可包含的最大項目數。如果設定為 0，則樹狀節點中的項目數量不受限制。 | 
|  lazyfree-lazy-eviction |  類型：STRING 允許的值：是、否 預設：否 |  在移出時執行非同步刪除。 | 
|  active-defrag-ignore-bytes |  類型：INTEGER 允許的值：1048576- 預設：104857600 |  啟動主動磁碟重組所需要的最低分散廢棄物數量。 | 
|  lazyfree-lazy-expire |  類型：STRING 允許的值：是、否 預設：否 |  在過期的金鑰上執行非同步刪除。 | 
|  active-defrag-threshold-lower |  類型：INTEGER 允許值：1 到 100 預設：10 |  啟動主動磁碟重組所需要的最低分散百分比。 | 
|  active-defrag-cycle-max |  類型：INTEGER 允許值：1 到 75 預設：75 |  用於磁碟重組的最大投入量 (CPU 百分比)。 | 
|  lazyfree-lazy-server-del |  類型：STRING 允許的值：是、否 預設：否 |  針對更新數值的命令執行非同步刪除。 | 
|  slowlog-log-slower-than |  類型：INTEGER 允許的值：0- 預設：10000 |  命令由 Redis OSS `Slow Log`功能記錄所超過的最大執行時間，以微秒為單位。請注意，負數會停用慢速日誌，而零值會強制記錄每個命令。 | 
|  hash-max-ziplist-entries |  類型：INTEGER 允許的值：0- 預設：512 |  決定用於雜湊的記憶體數量。少於指定項目數的雜湊會使用特別的編碼存放，以節省空間。 | 
|  hash-max-ziplist-value |  類型：INTEGER 允許的值：0- 預設：64 |  決定用於雜湊的記憶體數量。項目小於指定位元組數的雜湊會使用特別的編碼存放，以節省空間。 | 
|  set-max-intset-entries |  類型：INTEGER 允許的值：0- 預設：512 |  決定要用於特定類型組 (基數為 10，介於 64 位元帶正負號整數範圍內整數的字串) 的記憶體數量。這類少於指定項目數的組會使用特別的編碼存放，以節省空間。 | 
|  zset-max-ziplist-entries |  類型：INTEGER 允許的值：0- 預設：128 |  決定用於排序組的記憶體數量。少於指定元素數的排序組會使用特別的編碼存放，以節省空間。 | 
|  zset-max-ziplist-value |  類型：INTEGER 允許的值：0- 預設：64 |  決定用於排序組的記憶體數量。項目小於指定位元組數的排序組會使用特別的編碼存放，以節省空間。 | 
|  tracking-table-max-keys |  類型：INTEGER 允許的值：1-100000000 預設：1000000 |  為了協助用戶端快取，Redis OSS 支援追蹤哪些用戶端已存取哪些金鑰。 追蹤的索引鍵有所修改時，會傳送失效訊息給所有用戶端，通知他們快取的值不再有效。此值可讓您指定此資料表的上限。 | 
|  acllog-max-len |  類型：INTEGER 允許的值：1-10000 預設：128 |  ACL 日誌中的項目數量上限。 | 
|  active-expire-effort |  類型：INTEGER 允許的值：1-10 預設：1 |  Redis OSS 會刪除已超過兩個機制存活時間的金鑰。一種機制是系統會存取一個索引鍵，並發現其過期。另一種機制則是定期任務對索引鍵進行取樣，而導致超過存留時間的索引鍵過期。此參數定義 Redis OSS 用來使定期任務中的項目過期的工作量。 預設值 1 會嘗試避免有超過 10% 的過期索引鍵仍存在於記憶體中。也會嘗試避免佔用總記憶體的 25% 以上以及為系統增加延遲。您最多可以將此值增加 10，以增加使索引鍵過期花費的工作量。缺點是 CPU 會較高，且延遲也可能更高。除非您發現記憶體使用量很高，且可以容忍 CPU 使用率的增加，否則建議您使用值 1。 | 
|  lazyfree-lazy-user-del |  類型：STRING 允許的值：是、否 預設：否 |  指定`DEL`命令的預設行為是否與 作用相同`UNLINK`。 | 
|  activedefrag |  類型：STRING 允許的值：是、否 預設：否 |  啟用作用中記憶體重組。 | 
|  maxclients |  類型：INTEGER 允許的值：65000 預設：65000 |  一次可連線的用戶端數量上限。不可修改。 | 
| client-query-buffer-limit |  類型：INTEGER 允許的值：1048576-1073741824 預設：1073741824  |  單一用戶端查詢緩衝區的大小上限。變更會立即發生。  | 
| proto-max-bulk-len |  類型：INTEGER 允許的值：1048576-536870912 預設：536870912  |  單一元素請求的大小上限。變更會立即發生。  | 

## MemoryDB 節點類型特定參數
<a name="parametergroups.redis.nodespecific"></a>

雖然大多數的參數都只有單一值，有些參數則可能會根據所使用的節點類型而有不同的值。下表顯示`maxmemory`每個節點類型的 預設值。`maxmemory` 的值為您在節點上可以用於資料及其他用途的位元組上限。


|  Node type  | Maxmemory  | 
| --- | --- | 
| db.r7g.large | 14037181030 | 
| db.r7g.xlarge | 28261849702 | 
| db.r7g.2xlarge | 56711183565 | 
| db.r7g.4xlarge | 113609865216 | 
| db.r7g.8xlarge | 225000375228 | 
| db.r7g.12xlarge | 341206346547 | 
| db.r7g.16xlarge | 450000750456 | 
| db.r6gd.xlarge | 28261849702 | 
| db.r6gd.2xlarge | 56711183565 | 
| db.r6gd.4xlarge | 113609865216 | 
| db.r6gd.8xlarge | 225000375228 | 
| db.r6g.large | 14037181030 | 
| db.r6g.xlarge | 28261849702 | 
| db.r6g.2xlarge | 56711183565 | 
| db.r6g.4xlarge | 113609865216 | 
| db.r6g.8xlarge | 225000375228 | 
| db.r6g.12xlarge | 341206346547 | 
| db.r6g.16xlarge | 450000750456 | 
| db.t4g.small | 1471026299 | 
| db.t4g.medium | 3317862236 | 

**注意**  
所有 MemoryDB 執行個體類型都必須在 Amazon Virtual Private Cloud VPC 中建立。