描述 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，然後在 https://console.aws.amazon.com/docdb 開啟 Amazon DocumentDB 主控台。

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

   提示

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

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

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

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

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

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

Using the AWS CLI

您可以使用此describe-db-cluster-parameter-groupsAWS 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"
              }
          ]
}

以下程式碼列出 sample-parameter-group 的 ARN、系列、說明和名稱。

若為 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，然後在 https://console.aws.amazon.com/docdb 開啟 Amazon DocumentDB 主控台。

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"
       ]
]