描述 Amazon DocumentDB 集群參數組

當您在新區域中建立第一個 default Amazon DocumentDB 叢集或使用新引擎時，會自動建立叢集參數群組。在相同區域中建立且具有相同引擎版本的後續叢集會使用default叢集參數群組建立。

描述 Amazon DocumentDB 集群參數組的詳細信息

若要描述指定叢集參數群組的詳細資訊，請使用 AWS Management Console 或 AWS Command Line Interface (AWS CLI) 完成下列步驟。

Using the AWS Management Console

1. 登入 AWS Management Console，然後在 /docdb 開啟亞馬遜文件資料庫主控台。https://console.aws.amazon.com

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

   提示

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

3. 在 Cluster parameter groups (叢集參數群組) 窗格中，選取您想要查看詳細資訊的參數群組名稱。

4. 產生的頁面會顯示參數群組的參數、最近的活動和標籤。

   • 在 Cluster parameters (叢集參數) 下，您可以看到參數名稱、目前值、允許值、參數是否可修改、套用類型、資料類型和說明。您可以選取參數，然後在叢集參數段落中選擇編輯來修改個別參數。如需詳細資訊，請參閱修改 Amazon DocumentDB 叢集參數。

   • 在 Recent events (最近的事件) 中，您可以查看此參數群組的最近事件。您可以使用本節中的搜尋列來篩選這些事件。如需詳細資訊，請參閱Amazon DocumentDB 事件範例事件管理。

   • 在 Tags (標籤)，您可以查看在此叢集參數群組上的標籤。您可以在「標籤」區段中選擇 「編輯」來新增或移除標籤。如需詳細資訊，請參閱標記 Amazon DocumentDB 資源。

Using the AWS CLI

您可以使用此describe-db-cluster-parameter-groups AWS CLI 命令來檢視 Amazon 資源名稱 (ARN)、系列、說明和單一叢集參數群組的名稱，或您擁有的 Amazon DocumentDB 所有叢集參數群組的名稱。您也可以使用命describe-db-cluster-parameters AWS CLI 令來檢視單一叢集參數群組內的參數及其詳細資訊。

• --describe-db-cluster-parameter-groups— 查看所有叢集參數群組及其詳細資料的清單。

  • --db-cluster-parameter-group-name-可選。您想要說明的叢集參數群組名稱。如果省略這個參數，所有叢集參數群組會加上說明。

• --describe-db-cluster-parameters— 列出參數群組內的所有參數及其值。

  • --db-cluster-parameter-group name – 必要。您想要說明的叢集參數群組名稱。

下列程式碼列出最多 100 個叢集參數群組及其ARN、族群、描述和名稱。

aws docdb describe-db-cluster-parameter-groups

此操作的輸出看起來像下面的（JSON格式）。

{
          "DBClusterParameterGroups": [
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:default.docdb4.0",
                  "DBParameterGroupFamily": "docdb4.0",
                  "Description": "Default cluster parameter group for docdb4.0",
                  "DBClusterParameterGroupName": "default.docdb4.0"
              },
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:sample-parameter-group",
                  "DBParameterGroupFamily": "docdb4.0",
                  "Description": "Custom docdb4.0 parameter group",
                  "DBClusterParameterGroupName": "sample-parameter-group"
              }
          ]
}

下列程式碼列示的ARN、族群、描述和名稱sample-parameter-group。

若為 Linux、macOS 或 Unix：

aws docdb describe-db-cluster-parameter-groups \
          --db-cluster-parameter-group-name sample-parameter-group

針對 Windows：

aws docdb describe-db-cluster-parameter-groups ^
          --db-cluster-parameter-group-name sample-parameter-group

此操作的輸出看起來像下面的（JSON格式）。

{
          "DBClusterParameterGroups": [
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group",
                  "Description": "Custom docdb4.0 parameter group",
                  "DBParameterGroupFamily": "docdb4.0",
                  "DBClusterParameterGroupName": "sample-parameter-group"
              }
          ]
}

以下程式碼列出 sample-parameter-group 中參數的值。

若為 Linux、macOS 或 Unix：

aws docdb describe-db-cluster-parameters \
    --db-cluster-parameter-group-name sample-parameter-group
                  

針對 Windows：

aws docdb describe-db-cluster-parameters ^
    --db-cluster-parameter-group-name sample-parameter-group
                  

此操作的輸出看起來像下面的（JSON格式）。

{
   "Parameters": [
         {
            "ParameterName": "audit_logs",
            "ParameterValue": "disabled",
            "Description": "Enables auditing on cluster.",
            "Source": "system",
            "ApplyType": "dynamic",
            "DataType": "string",
            "AllowedValues": "enabled,disabled",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot"
         },
         {
            "ParameterName": "change_stream_log_retention_duration",
            "ParameterValue": "17777",
            "Description": "Duration of time in seconds that the change stream log is retained and can be consumed.",
            "Source": "user",
            "ApplyType": "dynamic",
            "DataType": "integer",
            "AllowedValues": "3600-86400",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot"
         }
   ]
}

確定 Amazon DocumentDB 集群的參數組

若要判斷哪個參數群組與特定叢集相關聯，請使用 AWS Management Console 或完成下列步驟 AWS CLI。

Using the AWS Management Console

1. 登入 AWS Management Console，然後在 /docdb 開啟亞馬遜文件資料庫主控台。https://console.aws.amazon.com

2. 在左側導覽窗格中選擇 Clusters (叢集)。

3. 在叢集的清單中，選取您有興趣之叢集的名稱。

4. 產生的頁面會顯示您所選取叢集的詳細資訊。向下捲動至 Cluster details (叢集詳細資訊)。在該區段底部的 Cluster parameter group (叢集參數群組) 下找到參數群組的名稱。

   

Using the AWS CLI

下列 AWS CLI 程式碼會決定管理叢集的參數群組sample-cluster。

aws docdb describe-db-clusters \
      --db-cluster-identifier sample-cluster \
      --query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]'      

此操作的輸出看起來像下面的（JSON格式）。

[
       [
           "sample-cluster",
           "sample-parameter-group"
       ]
]