重設 Amazon DocumentDB 叢集參數群組 - Amazon DocumentDB

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

重設 Amazon DocumentDB 叢集參數群組

您可以使用或 AWS Command Line Interface (AWS CLI) 重設叢集參數群組，將部分 AWS Management Console 或全部 Amazon DocumentDB 叢集參數群組的參數值重設為預設值。

Using the AWS Management Console

請遵循這些步驟操作，將部分或全部叢集參數群組的參數值重設為預設值。

重設叢集參數群組的參數值

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

  2. 在主控台左側的導覽窗格中，選擇 Parameter groups (參數群組)。

  3. 在 Cluster parameter groups (叢集參數群組) 窗格中，選擇您想要重設的叢集參數群組名稱。

  4. 依序選擇 Actions (動作) 和 Reset (重設) 來重設該參數群組。

  5. 在產生的 Cluster parameter group reset confirmation (叢集參數群組重設確認) 頁面上，確認您想要將該參數群組的所有叢集參數重設為預設值。然後選擇 Reset (重設) 以重設您的參數群組。您也可以選擇 Cancel (取消) 以捨棄變更。

Using the AWS CLI

若要將部分或全部叢集參數群組的參數值重設為預設值，使用 reset-db-cluster-parameter-group 操作搭配下列參數。

  • --db-cluster-parameter-group-name – 必要。要重設之叢集參數群組的名稱。

  • --parameters-可選。叢集參數群組中要重設為預設值的 ApplyMethod 和 ParameterName 清單。靜態參數必須設定為 pending-reboot，才會在下一個執行個體重新啟動或 reboot-db-instance 請求時生效。您必須呼叫您希望將更新的靜態參數套用到其中的叢集中 reboot-db-instance 的每個執行個體。

    此參數和 --reset-all-parameters 互斥：您可以使用其中一個，但無法同時使用兩者。

  • --reset-all-parameters或 --no-reset-all-parameters-可選。指定是否要將所有參數 (--reset-all-parameters) 或僅一些參數 (--no-reset-all-parameters) 重設為預設值。--reset-all-parameters 參數和 --parameters 互斥：您可以使用其中一個，但無法同時使用兩者。

    重設整個群組時，動態參數會立即更新。靜態參數必須設定為 pending-reboot，才會在下一個執行個體重新啟動或 reboot-db-instance 請求時生效。您必須呼叫您希望將更新的靜態參數套用到其中的叢集中 reboot-db-instance 的每個執行個體。

範例 1：將所有參數重設為預設值

以下程式碼會將在叢集參數群組 sample-parameter-group 中的所有參數重設為預設值。

若為 Linux、macOS 或 Unix：

aws docdb reset-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group \
       --reset-all-parameters

針對 Windows：

aws docdb reset-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group ^
       --reset-all-parameters
範例 2：將指定參數重設為預設值

以下程式碼會將在叢集參數群組 sample-parameter-group 中的 tls 參數重設為預設值。

若為 Linux、macOS 或 Unix：

aws docdb reset-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group \
       --no-reset-all-parameters \
       --parameters ParameterName=tls,ApplyMethod=pending-reboot

針對 Windows：

aws docdb reset-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group ^
       --no-reset-all-parameters ^
       --parameters ParameterName=tls,ApplyMethod=pending-reboot

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

{
       "DBClusterParameterGroupName": "sample-parameter-group"
   }
重新啟動叢集執行個體

在靜態參數的值變更前，必須將叢集執行個體重新開機。在您希望將更新靜態參數套用到其中的叢集中重新啟動每個執行個體。

若為 Linux、macOS 或 Unix：

aws docdb reboot-db-instance \
       --db-instance-identifier sample-cluster-instance

針對 Windows：

aws docdb reboot-db-instance ^
       --db-instance-identifier sample-cluster-instance