修改 Amazon DocumentDB 叢集參數群組

本節說明如何修改自訂的 Amazon DocumentDB 參數群組。在 Amazon DocumentDB 中，您無法修改在新區default域中第一次使用新引擎版本建立叢集時所建立的叢集參數群組。如果 Amazon DocumentDB 叢集使用預設叢集參數群組，而您想要修改其中的值，則必須先建立新參數群組或複製現有參數群組、修改它，然後將修改後的參數群組套用至叢集。

若要修改自訂叢集參數群組，請完成下列步驟。修改動作可能需要一段時間才能傳播。請等待已修改的叢集參數群組可用，然後再將它附加到叢集。您可以使用 AWS Management Console 或 AWS CLI describe-db-cluster-parameters作業來驗證叢集參數群組是否已修改。如需詳細資訊，請參閱描述叢集參數群組。

Using the AWS Management Console

請依照下列步驟修改自訂的 Amazon DocumentDB 參數群組。您無法修改 default 參數群組。如果您想要修改 default 參數群組中的值，可以複製預設叢集參數群組並加以修改，接著將修改的參數群組套用到叢集。如需將參數群組套用到叢集的詳細資訊，請參閱修改 Amazon DocumentDB 叢集。

修改自訂叢集參數群組

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

2. 在主控台左側的導覽窗格中，選擇 Parameter groups (參數群組)。在參數群組清單中，選擇您要修改看的參數群組名稱。

   提示

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

3. 對於您要修改之參數群組中的每個參數，請執行下列動作：

   1. 找出您要修改的參數，並檢查「可修改」欄true下是否列示該參數，以確認該參數是否可修改。

   2. 如果可以修改，請選取參數並從主控台頁面的右上角選擇 Edit (編輯)。

   3. 在修改 <parameter-name> 對話方塊中，進行所需的變更。然後，選擇 Modify cluster parameter (修改叢集參數)，或選擇 Cancel (取消) 以捨棄變更。

Using the AWS CLI

您可以使用ParameterValue修改自訂 Amazon DocumentDB 叢集參數群組中任何可修改參數ApplyMethod的Description、或。 AWS CLI您無法直接修改預設叢集參數群組。

若要修改自訂叢集參數群組的參數，請使用 modify-db-cluster-parameter-group 操作搭配下列參數。

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

• --parameters – 必要。您要修改的參數。如需適用於 Amazon DocumentDB 叢集中所有執行個體的參數清單，請參閱. Amazon DocumentDB 群集參數參考 每個參數項目必須包括下列：

  • ParameterName— 您要修改的參數名稱。

  • ParameterValue— 此參數的新值。

  • ApplyMethod— 套用此參數變更的方式。允許值為 immediate 和 pending-reboot。

    注意

    static 必須擁有使用 ApplyType 的參數 ApplyMethod pending-reboot。

範例 - 修改參數值

在此範例中，您列出 sample-parameter-group 的參數值和修改 tls 參數。接著，在等待 5 分鐘後，您會再次列出 sample-parameter-group 的參數值，以查看變更的參數值。

1. 列出參數和其 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": [
              {
                  "Source": "system",
                  "ApplyType": "static",
                  "AllowedValues": "disabled,enabled",
                  "ParameterValue": "enabled",
                  "ApplyMethod": "pending-reboot",
                  "DataType": "string",
                  "ParameterName": "tls",
                  "IsModifiable": true,
                  "Description": "Config to enable/disable TLS"
              },
              {
                  "Source": "user",
                  "ApplyType": "dynamic",
                  "AllowedValues": "disabled,enabled",
                  "ParameterValue": "enabled",
                  "ApplyMethod": "pending-reboot",
                  "DataType": "string",
                  "ParameterName": "ttl_monitor",
                  "IsModifiable": true,
                  "Description": "Enables TTL Monitoring"
              }
          ]
   }

2. 修改 tls 參數，讓其值為 disabled。

   您無法修改 ApplyMethod，因為 ApplyType 是 static。

   若為 Linux、macOS 或 Unix：

   aws docdb modify-db-cluster-parameter-group \
          --db-cluster-parameter-group-name sample-parameter-group \
          --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot

   針對 Windows：

   aws docdb modify-db-cluster-parameter-group ^
          --db-cluster-parameter-group-name sample-parameter-group ^
          --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot

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

   {
          "DBClusterParameterGroupName": "sample-parameter-group"
      }

3. 等待至少 5 分鐘。

4. 列出 sample-parameter-group 的參數值，來確認 tls 參數已經過修改。

   若為 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": [
              {
                  "ParameterValue": "false",
                  "ParameterName": "enable_audit_logs",
                  "ApplyType": "dynamic",
                  "DataType": "string",
                  "Description": "Enables auditing on cluster.",
                  "AllowedValues": "true,false",
                  "Source": "system",
                  "IsModifiable": true,
                  "ApplyMethod": "pending-reboot"
              },
              {
                  "ParameterValue": "disabled",
                  "ParameterName": "tls",
                  "ApplyType": "static",
                  "DataType": "string",
                  "Description": "Config to enable/disable TLS",
                  "AllowedValues": "disabled,enabled",
                  "Source": "system",
                  "IsModifiable": true,
                  "ApplyMethod": "pending-reboot"
              }
          ]
   }