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

# 使用參數群組設定引擎參數
<a name="parametergroups"></a>

MemoryDB 使用參數來控制節點和叢集的執行期屬性。一般而言，更新的引擎版本會包含額外參數，可支援更新的功能。如需參數表，請參閱 [引擎特定參數](parametergroups.redis.md)。

如您所預期的，有些參數值 (例如 `maxmemory`) 會由引擎與節點類型決定。如需根據節點類型的參數值表，請參閱 [MemoryDB 節點類型特定參數](parametergroups.redis.md#parametergroups.redis.nodespecific)。

**Topics**
+ [

# 參數管理
](parametergroups.management.md)
+ [

# 參數群組層
](parametergroups.tiers.md)
+ [

# 建立參數群組
](parametergroups.creating.md)
+ [

# 依名稱列出參數群組
](parametergroups.listingGroups.md)
+ [

# 列出參數群組的值
](parametergroups.listingValues.md)
+ [

# 修改參數群組
](parametergroups.modifying.md)
+ [

# 刪除參數群組
](parametergroups.deleting.md)
+ [

# 引擎特定參數
](parametergroups.redis.md)

# 參數管理
<a name="parametergroups.management"></a>

參數會分組為具名參數群組，以便更輕鬆地管理參數。參數群組代表啟動期間傳遞至引擎軟體之參數的特定值組合。這些值會決定每個節點上的引擎程序在執行時間的行為。特定參數群組上的參數值會套用至與群組相關聯的所有節點，無論其所屬叢集為何。

若要微調叢集的效能，您可以修改一些參數值或變更叢集的參數群組。
+ 您無法修改或刪除預設參數群組。如果您需要自訂參數值，則必須建立自訂參數群組。
+ 參數群組系列和您要指派給它的叢集必須相容。例如，如果您的叢集執行 Redis OSS 第 6 版，您只能使用 memorydb\$1redis6 系列的預設或自訂參數群組。
+ 當您變更叢集的參數時，變更會立即套用至叢集。無論您是變更叢集的參數群組本身，還是叢集參數群組中的參數值，都是如此。

# 參數群組層
<a name="parametergroups.tiers"></a>

*MemoryDB 參數群組層*

**全域預設**

區域中所有 MemoryDB 客戶的頂層根參數群組。

全域預設參數群組：
+ 保留給 MemoryDB，客戶無法使用。

**客戶預設**

建立供客戶使用的全域預設參數群組複本。

Customer Default 參數群組：
+ 由 MemoryDB 建立和擁有。
+ 可供客戶做為執行此參數群組所支援引擎版本的任何叢集的參數群組使用。
+ 客戶無法對其進行編輯。

**客戶自有**

Customer Default 參數群組的副本。每當客戶建立參數群組時，就會建立客戶擁有的參數群組。

Customer Owned 參數群組：
+ 由客戶建立及擁有。
+ 可指派給任何客戶的相容叢集。
+ 可由客戶修改以建立自訂參數群組。 ‡

  並非所有參數值皆可修改。如需詳細資訊，請參閱[引擎特定參數](parametergroups.redis.md)。

# 建立參數群組
<a name="parametergroups.creating"></a>

若您希望修改不同於預設值的一或多個參數值，便需要建立新的參數群組。您可以使用 MemoryDB 主控台、 AWS CLI或 MemoryDB API 建立參數群組。

## 建立參數群組 (主控台)
<a name="parametergroups.creatingclusters.viewdetails"></a>

下列程序說明如何使用 MemoryDB 主控台建立參數群組。

**使用 MemoryDB 主控台建立參數群組**

1. 登入 AWS 管理主控台並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。

1. 若要查看所有可用參數群組的清單，請從左側的導覽窗格中，選擇 **Parameter Groups (參數群組)**。

1. 若要建立參數群組，請選擇**建立參數群組**。

   **建立參數群組**頁面隨即出現。

1. 在 **Name (名稱)** 方塊中，輸入此參數群組的唯一名稱。

   建立叢集或修改叢集的參數群組時，您便會根據其名稱選擇參數群組。因此，我們建議選擇附帶資訊且能以某種方式識別參數群組系列的名稱。

   參數群組命名限制條件如下：
   + 必須以 ASCII 字母開頭。
   + 它只能包含 ASCII 字母、數字和連字符號。
   + 長度必須介於 1 至 255 個字元之間。
   + 不能連續包含兩個連字號。
   + 結尾不能是連字號。

1. 在 **Description (描述)** 方塊中，輸入參數群組的描述。

1. 在引擎版本相容性方塊中，選擇此參數群組對應的引擎版本。

1. 在**標籤**中，選擇性地新增標籤，以搜尋和篩選參數群組或追蹤AWS成本。

1. 若要建立參數群組，請選擇 **Create (建立)**。

   若要終止程序而不建立參數群組，請選擇 **Cancel (取消)**。

1. 建立參數群組時，它會擁有系列的預設值。若要變更預設值，您必須修改參數群組。如需詳細資訊，請參閱[修改參數群組](parametergroups.modifying.md)。

## 建立參數群組 (AWSCLI)
<a name="parametergroups.creating.cli"></a>

若要使用 建立參數群組AWS CLI，請使用 命令`create-parameter-group`搭配這些參數。
+ `--parameter-group-name` - 參數群組的名稱。

  參數群組命名限制條件如下：
  + 必須以 ASCII 字母開頭。
  + 它只能包含 ASCII 字母、數字和連字符號。
  + 長度必須介於 1 至 255 個字元之間。
  + 不能連續包含兩個連字號。
  + 結尾不能是連字號。
+ `--family` - 參數群組的引擎和版本系列。
+ `--description` - 使用者提供的參數群組說明。

**Example**  
下列範例使用 memorydb\$1redis6 系列作為範本，建立名為 *myRedis6x* 的參數群組。  
針對 Linux、macOS 或 Unix：  

```
aws memorydb create-parameter-group \
    --parameter-group-name myRedis6x  \
    --family memorydb_redis6 \
    --description "My first parameter group"
```
針對 Windows：  

```
aws memorydb create-parameter-group ^
    --parameter-group-name myRedis6x  ^
    --family memorydb_redis6 ^
    --description "My first parameter group"
```
此命令的輸出看起來會與以下內容相似。  

```
{
    "ParameterGroup": {
        "Name": "myRedis6x", 
        "Family": "memorydb_redis6",
        "Description": "My first parameter group",
        "ARN": "arn:aws:memorydb:us-east-1:012345678912:parametergroup/myredis6x"
    }
}
```

建立參數群組時，它會擁有系列的預設值。若要變更預設值，您必須修改參數群組。如需詳細資訊，請參閱[修改參數群組](parametergroups.modifying.md)。

如需詳細資訊，請參閱[https://docs.aws.amazon.com/cli/latest/reference/memorydb/create-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/memorydb/create-parameter-group.html)。

## 建立參數群組 (MemoryDB API)
<a name="parametergroups.creating.api"></a>

若要使用 MemoryDB API 建立參數群組，請使用 `CreateParameterGroup`動作搭配這些參數。
+ `ParameterGroupName` - 參數群組的名稱。

  參數群組命名限制條件如下：
  + 必須以 ASCII 字母開頭。
  + 它只能包含 ASCII 字母、數字和連字符號。
  + 長度必須介於 1 至 255 個字元之間。
  + 不能連續包含兩個連字號。
  + 結尾不能是連字號。
+ `Family` - 參數群組的引擎和版本系列。例如 `memorydb_redis6`。
+ `Description` - 使用者提供的參數群組說明。

**Example**  
下列範例會使用 memorydb\$1redis6 系列作為範本，建立名為 *myRedis6x* 的參數群組。  

```
https://memory-db.us-east-1.amazonaws.com/
   ?Action=CreateParameterGroup
   &Family=memorydb_redis6
   &ParameterGroupName=myRedis6x
   &Description=My%20first%20parameter%20group
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20210802T192317Z
   &Version=2021-01-01
   &X-Amz-Credential=<credential>
```
此動作的回應看起來會與以下內容相似。  

```
<CreateParameterGroupResponse xmlns="http://memory-db.us-east-1.amazonaws.com/doc/2021-01-01/">
  <CreateParameterGroupResult>
    <ParameterGroup>
      <Name>myRedis6x</Name>
      <Family>memorydb_redis6</Family>
      <Description>My first parameter group</Description>
      <ARN>arn:aws:memorydb:us-east-1:012345678912:parametergroup/myredis6x</ARN>
    </ParameterGroup>
  </CreateParameterGroupResult>
  <ResponseMetadata>
    <RequestId>d8465952-af48-11e0-8d36-859edca6f4b8</RequestId>
  </ResponseMetadata>
</CreateParameterGroupResponse>
```

建立參數群組時，它會擁有系列的預設值。若要變更預設值，您必須修改參數群組。如需詳細資訊，請參閱[修改參數群組](parametergroups.modifying.md)。

如需詳細資訊，請參閱[https://docs.aws.amazon.com/memorydb/latest/APIReference/API_CreateParameterGroup.html](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_CreateParameterGroup.html)。

# 依名稱列出參數群組
<a name="parametergroups.listingGroups"></a>

您可以使用 MemoryDB 主控台、 AWS CLI或 MemoryDB API 列出參數群組。

## 依名稱列出參數群組 (主控台)
<a name="parametergroups.listingGroupsclusters.viewdetails"></a>

下列程序說明如何使用 MemoryDB 主控台檢視參數群組的清單。

**使用 MemoryDB 主控台列出參數群組**

1. 登入 AWS 管理主控台並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。

1. 若要查看所有可用參數群組的清單，請從左側的導覽窗格中，選擇 **Parameter Groups (參數群組)**。

## 依名稱列出參數群組 (AWSCLI)
<a name="parametergroups.listingGroups.cli"></a>

若要使用 產生參數群組清單AWS CLI，請使用 命令 `describe-parameter-groups`。若您提供參數群組的名稱，便只會列出該參數群組。若您沒有提供參數群組的名稱，最多會列出 `--max-results` 個參數群組。在任一種情況下，都會列出參數群組的名稱、系列和描述。

**Example**  
下列範例程式碼列出參數群組 *myRedis6x*。  
針對 Linux、macOS 或 Unix：  

```
aws memorydb describe-parameter-groups \
    --parameter-group-name myRedis6x
```
針對 Windows：  

```
aws memorydb describe-parameter-groups ^
    --parameter-group-name myRedis6x
```
此命令的輸出看起來會與以下內容相似，列出參數群組的名稱、系列和描述。  

```
{
    "ParameterGroups": [
	    {
	        "Name": "myRedis6x", 
	        "Family": "memorydb_redis6",
	        "Description": "My first parameter group",
                "ARN": "arn:aws:memorydb:us-east-1:012345678912:parametergroup/myredis6x"
	    }
    ]
}
```

**Example**  
下列範例程式碼列出在 Valkey 或 Redis OSS 引擎 5.0.6 版之後執行之參數群組的參數群組 *myRedis6x*。  
針對 Linux、macOS 或 Unix：  

```
aws memorydb describe-parameter-groups \
    --parameter-group-name myRedis6x
```
針對 Windows：  

```
aws memorydb describe-parameter-groups ^
    --parameter-group-name myRedis6x
```
此命令的輸出看起來會像這樣，列出參數群組的名稱、系列和描述。  

```
{
    "ParameterGroups": [
	    {
	        "Name": "myRedis6x", 
	        "Family": "memorydb_redis6",
	        "Description": "My first parameter group",
                "ARN": "arn:aws:memorydb:us-east-1:012345678912:parametergroup/myredis6x"
	    }
    ]
}
```

**Example**  
下列範例程式碼最多列出 20 個參數群組。  

```
aws memorydb describe-parameter-groups --max-results 20
```
此命令的 JSON 輸出看起來會像這樣，列出每個參數群組的名稱、系列和描述。  

```
{
    "ParameterGroups": [
        {
            "ParameterGroupName": "default.memorydb-redis6",
            "Family": "memorydb_redis6",
            "Description": "Default parameter group for memorydb_redis6",
            "ARN": "arn:aws:memorydb:us-east-1:012345678912:parametergroup/default.memorydb-redis6"
        }, 
        ...
    ]
}
```

如需詳細資訊，請參閱[https://docs.aws.amazon.com/cli/latest/reference/memorydb/describe-parameter-groups.html](https://docs.aws.amazon.com/cli/latest/reference/memorydb/describe-parameter-groups.html)。

## 依名稱列出參數群組 (MemoryDB API)
<a name="parametergroups.listingGroups.api"></a>

若要使用 MemoryDB API 產生參數群組清單，請使用 `DescribeParameterGroups`動作。若您提供參數群組的名稱，便只會列出該參數群組。若您沒有提供參數群組的名稱，最多會列出 `MaxResults` 個參數群組。在任一種情況下，都會列出參數群組的名稱、系列和描述。

**Example**  
下列範例程式碼最多列出 20 個參數群組。  

```
https://memory-db.us-east-1.amazonaws.com/
   ?Action=DescribeParameterGroups
   &MaxResults=20
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20210802T192317Z
   &Version=2021-01-01
   &X-Amz-Credential=<credential>
```
此動作的回應看起來會像這樣，列出每個參數群組在 memorydb\$1redis6 的情況下的名稱、系列和描述。  

```
<DescribeParameterGroupsResponse xmlns="http://memory-db.us-east-1.amazonaws.com/doc/2021-01-01/">
  <DescribeParameterGroupsResult>
    <ParameterGroups>
      <ParameterGroup>
        <Name>myRedis6x</Name>
        <Family>memorydb_redis6</Family>
        <Description>My custom Redis OSS 6 parameter group</Description>
        <ARN>arn:aws:memorydb:us-east-1:012345678912:parametergroup/myredis6x</ARN>
      </ParameterGroup>     
       <ParameterGroup>
        <Name>default.memorydb-redis6</Name>
        <Family>memorydb_redis6</Family>
        <Description>Default parameter group for memorydb_redis6</Description>
        <ARN>arn:aws:memorydb:us-east-1:012345678912:parametergroup/default.memorydb-redis6</ARN>
      </ParameterGroup>
    </ParameterGroups>
  </DescribeParameterGroupsResult>
  <ResponseMetadata>
    <RequestId>3540cc3d-af48-11e0-97f9-279771c4477e</RequestId>
  </ResponseMetadata>
</DescribeParameterGroupsResponse>
```

**Example**  
下列範例程式碼列出參數群組 *myRedis6x*。  

```
https://memory-db.us-east-1.amazonaws.com/
   ?Action=DescribeParameterGroups
   &ParameterGroupName=myRedis6x
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20210802T192317Z
   &Version=2021-01-01
   &X-Amz-Credential=<credential>
```
此動作的回應看起來會與以下內容相似，列出名稱、系列和描述。  

```
<DescribeParameterGroupsResponse xmlns="http://memory-db.us-east-1.amazonaws.com/doc/2021-01-01/">
  <DescribeParameterGroupsResult>
    <ParameterGroups>
      <ParameterGroup>
        <Name>myRedis6x</Name>
        <Family>memorydb_redis6</Family>
        <Description>My custom Redis OSS 6 parameter group</Description>
        <ARN>arn:aws:memorydb:us-east-1:012345678912:parametergroup/myredis6x</ARN>
      </ParameterGroup>
    </ParameterGroups>
  </DescribeParameterGroupsResult>
  <ResponseMetadata>
    <RequestId>3540cc3d-af48-11e0-97f9-279771c4477e</RequestId>
  </ResponseMetadata>
</DescribeParameterGroupsResponse>
```

如需詳細資訊，請參閱[https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DescribeParameterGroups.html](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DescribeParameterGroups.html)。

# 列出參數群組的值
<a name="parametergroups.listingValues"></a>

您可以使用 MemoryDB 主控台、 AWS CLI或 MemoryDB API 列出參數群組的參數及其值。

## 列出參數群組的值 (主控台)
<a name="parametergroups.listingValuesclusters.viewdetails"></a>

下列程序說明如何使用 MemoryDB 主控台列出參數群組的參數及其值。

**使用 MemoryDB 主控台列出參數群組的參數及其值**

1. 登入 AWS 管理主控台並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。

1. 若要查看所有可用參數群組的清單，請從左側的導覽窗格中，選擇 **Parameter Groups (參數群組)**。

1. 透過選擇參數群組名稱的名稱 （而非其旁邊的方塊），選擇要列出參數和值的參數群組。

   參數及其值會在畫面底部列出。根據參數的數量，您可能需要向上或向下捲動來尋找您想要的參數。

## 列出參數群組的值 (AWSCLI)
<a name="parametergroups.listingValues.cli"></a>

若要使用 列出參數群組的參數及其值AWS CLI，請使用 命令 `describe-parameters`。

**Example**  
下列範例程式碼會列出參數群組 *myRedis6x* 的所有參數及其值。  
針對 Linux、macOS 或 Unix：  

```
aws memorydb describe-parameters \
    --parameter-group-name myRedis6x
```
針對 Windows：  

```
aws memorydb describe-parameters ^
    --parameter-group-name myRedis6x
```

如需詳細資訊，請參閱[https://docs.aws.amazon.com/cli/latest/reference/memorydb/describe-parameters.html](https://docs.aws.amazon.com/cli/latest/reference/memorydb/describe-parameters.html)。

## 列出參數群組的值 (MemoryDB API)
<a name="parametergroups.listingValues.api"></a>

若要使用 MemoryDB API 列出參數群組的參數及其值，請使用 `DescribeParameters`動作。

如需詳細資訊，請參閱[https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DescribeParameters.html](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DescribeParameters.html)。

# 修改參數群組
<a name="parametergroups.modifying"></a>

**重要**  
您無法修改任何預設參數群組。

您可以修改參數群組中的某些參數值。這些參數值都會套用到與參數群組相關聯的叢集。如需參數值變更套用到參數群組時間的詳細資訊，請參閱 [引擎特定參數](parametergroups.redis.md)。

## 修改參數群組 (主控台)
<a name="parametergroups.modifyingclusters.viewdetails"></a>

下列程序說明如何使用 MemoryDB 主控台變更參數的值。您會使用相同的程序來變更任何參數的值。

**使用 MemoryDB 主控台變更參數的值**

1. 登入 AWS 管理主控台並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。

1. 若要查看所有可用參數群組的清單，請從左側的導覽窗格中，選擇 **Parameter Groups (參數群組)**。

1. 選擇參數群組名稱左側的選項按鈕，以選擇您要修改的參數群組。

   選擇**動作**，然後選擇**檢視詳細資訊**。或者，您也可以選擇要前往詳細資訊頁面的參數群組名稱。

1. 若要修改 參數，請選擇**編輯**。所有可編輯的參數都會啟用編輯。您可能需要跨頁面移動，才能找到要變更的參數。或者，您可以在搜尋方塊中依名稱、值或類型來搜尋參數。

1. 進行任何必要的參數修改。

1. 若要儲存您所做的變更，請選擇 **Save changes (儲存變更)**。

1. 如果您修改了頁數的參數值，您可以選擇**預覽變更來檢閱所有變更**。若要確認變更，請選擇**儲存變更**。若要進行更多修改，請選擇**返回**。

1. **參數詳細資訊**頁面也可讓您選擇重設為預設值。若要重設為預設值，請選擇**重設為預設值**。核取方塊會出現在所有參數的左側。您可以選擇要重設的項目，然後選擇**繼續重設**以確認。

   選擇**確認**以確認對話方塊上的重設動作。

1. 參數詳細資訊頁面可讓您設定想要在每個頁面上看到的參數數目。使用右側的齒輪進行這些變更。您也可以在詳細資訊頁面上啟用/停用您想要的資料欄。這些變更會持續到 主控台的工作階段。

   若要尋找您變更的參數名稱，請參閱 [引擎特定參數](parametergroups.redis.md)。



## 修改參數群組 (AWSCLI)
<a name="parametergroups.modifying.cli"></a>

若要使用 變更參數的值AWS CLI，請使用命令 `update-parameter-group`。

若要尋找您欲變更的參數名稱及允許值，請參閱 [引擎特定參數](parametergroups.redis.md)

如需詳細資訊，請參閱 [update-parameter-group](https://docs.aws.amazon.com//cli/latest/reference/memorydb/update-parameter-group.html)。

## 修改參數群組 (MemoryDB API)
<a name="parametergroups.modifying.api"></a>

若要使用 MemoryDB API 變更參數群組的參數值，請使用 `UpdateParameterGroup`動作。

若要尋找您欲變更的參數名稱及允許值，請參閱 [引擎特定參數](parametergroups.redis.md)

如需詳細資訊，請參閱[https://docs.aws.amazon.com/memorydb/latest/APIReference/API_UpdateParameterGroup.html](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_UpdateParameterGroup.html)。

# 刪除參數群組
<a name="parametergroups.deleting"></a>

您可以使用 MemoryDB 主控台、 或 MemoryDB API AWS CLI刪除自訂參數群組。

若參數群組已和任何叢集相關聯，您便無法刪除參數群組。您也無法刪除任何預設參數群組。

## 刪除參數群組 (主控台)
<a name="parametergroups.deletingclusters.viewdetails"></a>

下列程序說明如何使用 MemoryDB 主控台刪除參數群組。

**使用 MemoryDB 主控台刪除參數群組**

1. 登入 AWS 管理主控台並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。

1. 若要查看所有可用參數群組的清單，請從左側的導覽窗格中，選擇 **Parameter Groups (參數群組)**。

1. 選擇參數群組名稱左側的選項按鈕，以選擇您要刪除的參數群組。

   選擇 **Actions (動作)**，然後選擇 **Delete (刪除 VPC)**。

1. **Delete Parameter Group (刪除參數群組)** 確認畫面隨即出現。

1. 若要刪除參數群組，請在確認文字方塊中輸入**刪除**。

   若要保留參數群組，請選擇 **Cancel (取消)**。

## 刪除參數群組 (AWSCLI)
<a name="parametergroups.deleting.cli"></a>

若要使用 刪除參數群組AWS CLI，請使用命令 `delete-parameter-group`。針對要刪除的參數群組，以 `--parameter-group-name` 指定的參數群組不能有任何與其相關聯的叢集，也不能是預設參數群組。

下列範例程式碼會刪除 *myRedis6x* 參數群組。

**Example**  
針對 Linux、macOS 或 Unix：  

```
aws memorydb delete-parameter-group \
    --parameter-group-name myRedis6x
```
針對 Windows：  

```
aws memorydb delete-parameter-group ^
    --parameter-group-name myRedis6x
```

如需詳細資訊，請參閱 [delete-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/memorydb/delete-parameter-group.html)。

## 刪除參數群組 (MemoryDB API)
<a name="parametergroups.deleting.api"></a>

若要使用 MemoryDB API 刪除參數群組，請使用 `DeleteParameterGroup`動作。針對要刪除的參數群組，以 `ParameterGroupName` 指定的參數群組不能有任何與其相關聯的叢集，也不能是預設參數群組。

**Example**  
下列範例程式碼會刪除 *myRedis6x* 參數群組。  

```
https://memory-db.us-east-1.amazonaws.com/
   ?Action=DeleteParameterGroup
   &ParameterGroupName=myRedis6x
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20210802T192317Z
   &Version=2021-01-01
   &X-Amz-Credential=<credential>
```

如需詳細資訊，請參閱[https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DeleteParameterGroup.html](https://docs.aws.amazon.com/memorydb/latest/APIReference/API_DeleteParameterGroup.html)。

# 引擎特定參數
<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 中建立。