重置 Amazon DocumentDB 集群参数组 - Amazon DocumentDB

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

重置 Amazon DocumentDB 集群参数组

您可以使用或 AWS Command Line Interface (AWS CLI) 重置集群参数组，将 Amazon DocumentDB 集群参数组的部分 AWS Management Console 或全部参数值重置为默认值。

Using the AWS Management Console

按照以下步骤将将部分或全部集群参数组的参数值重置为默认值。

要重置集群参数组的参数值

  1. 登录 AWS Management Console，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com

  2. 在控制台左侧的导航窗格中，选择参数组。

  3. 在集群参数组窗格中，选择要对其复置的集群参数组的名称。

  4. 选择操作，然后选择重置以重置该参数组。

  5. 在所得的集群参数组重置确认页面上，确认您想要将该参数组的所有集群参数重置为默认值。然后，选择重置以重置您的参数组。您也可以选择取消以放弃所做更改。

Using the AWS CLI

要将部分或全部集群参数组的参数值重置为其默认值，请使用带有以下参数的 reset-db-cluster-parameter-group 操作。

  • --db-cluster-parameter-group-name – 必需。要重置的集群参数组的名称。

  • --parameters — 可选。集群参数组中要重置为其默认值的 ParameterName 和 ApplyMethod 列表。静态参数必须设置成 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