修改 Amazon DocumentDB 叢集參數群組 - Amazon DocumentDB

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

修改 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 (參數群組)。在參數群組清單中，選擇您要修改看的參數群組名稱。

    提示

    如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (Hamburger menu icon with three horizontal lines.)。

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