View a markdown version of this page

建立 Amazon DocumentDB 叢集參數群組 - Amazon DocumentDB

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

建立 Amazon DocumentDB 叢集參數群組

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

下列程序會引導您建立自訂叢集參數群組。您接著可在該參數群組中修改參數。

注意

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

Using the AWS 管理主控台
建立叢集參數群組

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

  2. 在導覽窗格中，選擇 Parameter groups (參數群組)。

    提示

    如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (Menu button.)。

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

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

    1. 新的叢集參數群組名稱 — 輸入叢集參數群組的名稱。例如 sample-parameter-group。叢集參數群組具有以下命名限制：

      • 長度為 [1-255] 個英數字元。

      • 第一個字元必須是字母。

      • 不能以連字號結尾，或包含兩個連續連字號。

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

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

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

  6. 選擇 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：

範例
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"
    }
}