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

# 建立 Amazon DocumentDB 叢集參數群組
<a name="cluster_parameter_groups-create"></a>

當您使用新引擎版本和新區域建立叢集時`default.docdb3.6`，會建立預設叢集參數群組，例如 `default.docdb5.0``default.docdb4.0`、 或 。在此區域中建立且具有相同引擎版本的後續叢集會繼承`default`叢集參數群組。建立後，即無法刪除或重新命名`default`參數群組。您可以建立具有偏好參數值的自訂參數群組，並將其連接至 Amazon DocumentDB 叢集，藉此修改叢集執行個體的引擎行為。

下列程序會引導您建立自訂叢集參數群組。您接著可[在該參數群組中修改參數](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-modify.html)。

**注意**  
建立叢集參數群組後，您應等待至少 5 分鐘，然後再使用該特定參數群組。這可讓 Amazon DocumentDB 在叢集參數群組用於新叢集之前完全完成`create`動作。您可以使用 AWS 管理主控台 或 `describe-db-cluster-parameter-groups` AWS CLI 操作來驗證叢集參數群組是否已建立。如需詳細資訊，請參閱[描述 Amazon DocumentDB 叢集參數群組](cluster_parameter_groups-describe.md)。

------
#### [ Using the AWS 管理主控台 ]

**建立叢集參數群組**

1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) 開啟 Amazon DocumentDB 主控台。

1. 在導覽窗格中，選擇 **Parameter groups** (參數群組)。
**提示**  
如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。

1. 在 **Cluster parameter groups (叢集參數群組)** 窗格中，選擇 **Create (建立)**。

1. 在 **Create cluster parameter group (建立叢集參數群組)** 窗格中，輸入以下項目：

   1. **新的叢集參數群組名稱** — 輸入叢集參數群組的名稱。例如 `sample-parameter-group`。叢集參數群組具有以下命名限制：
      + 長度為 [1-255] 個英數字元。
      + 第一個字元必須是字母。
      + 不能以連字號結尾，或包含兩個連續連字號。

   1. **系列** — 選擇您要用於叢集的 DocumentDB 版本。

   1. **描述** — 提供此叢集參數群組的描述。

1. 若要建立叢集參數群組，請選擇 **Create (建立)**。若要取消操作，請選擇 **Cancel (取消)**。

1. 選擇 **Create (建立)** 之後，頁面頂端會顯示下列文字，以確認您的叢集參數群組是否已成功建立：

   ```
   Successfully created cluster parameter group 'sample-parameter-group'.
   ```

------
#### [ Using the AWS CLI ]

若要為 Amazon DocumentDB 4.0 叢集建立新的叢集參數群組，請使用 AWS CLI `create-db-cluster-parameter-group`操作搭配下列參數：
+ **--db-cluster-parameter-group-name** — 自訂叢集參數群組的名稱。例如 `sample-parameter-group`。
+ **--db-cluster-parameter-group-family** — 做為自訂叢集參數群組範本的叢集參數群組系列。
+ **--description** — 此叢集參數群組的使用者提供描述。以下範例使用 "`Custom docdb4.0 parameter group`"。

針對 Linux、macOS 或 Unix：

**Example**  

```
aws docdb create-db-cluster-parameter-group \
 --db-cluster-parameter-group-name sample-parameter-group \
 --db-parameter-group-family docdb5.0 \
 --description "Custom docdb5.0 parameter group"
```
針對 Windows：  

```
aws docdb create-db-cluster-parameter-group ^
 --db-cluster-parameter-group-name sample-parameter-group ^
 --db-parameter-group-family docdb5.0 ^
 --description "Custom docdb5.0 parameter group"
```
此操作的輸出將會如下所示 (JSON 格式)。  

```
{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "sample-parameter-group",
        "DBParameterGroupFamily": "docdb5.0",
        "Description": "Custom docdb4.0 parameter group",
        "DBClusterParameterGroupArn": "sample-parameter-group-arn"
    }
}
```

------