重置 Amazon DocumentDB 集群参数组 - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

重置 Amazon DocumentDB 集群参数组

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

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

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

  1. 登录到Amazon Web Services Management Console，然后在以下位置打开 Amazon DocumentDB 控制台https://console.aws.amazon.com/docdb.

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

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

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

  5. 在结果上集群参数组重置确认页面中，确认您要将该参数组的所有集群参数重置为默认值。然后选择 。Reset以重置你的参数组。您还可以选择Cancel放弃更改。

要将部分或全部集群参数组的参数值重置为其默认值，请使用带有以下参数的 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：将指定的参数重置为其默认值

以下代码重置tls集群参数组中的参数sample-parameter-group设置为默认值。

对于 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