重置 Amazon DocumentDB 集群参数组

重置 Amazon DocumentDB 集群参数组

您可以使用 Amazon DocumentDB或 AWS 管理控制台（AWS Command Line Interface）重置集群参数组，从而将部分或全部 AWS CLI 集群参数组的参数值重置为其默认值。

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

重置集群参数组的参数值

通过以下网址登录 AWS 管理控制台并打开 Amazon DocumentDB 控制台：https://console.aws.amazon.com/docdb。
在控制台左侧的导航窗格中，选择 Parameter groups （参数组）。
在 Cluster parameter groups （集群参数组） 窗格中，选择要重置的集群参数组的名称。
选择 Actions （操作），然后选择 Reset （重置） 以重置该参数组。
在生成的 Cluster parameter group reset confirmation （集群参数组重置确认） 页面上，确认您要将该参数组的所有集群参数重置为其默认值。然后选择 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