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

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

重置 Amazon DocumentDB 集群参数组

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

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

重置集群参数组的参数值

  1. 通过以下网址登录 AWS 管理控制台并打开 Amazon DocumentDB 控制台:https://console.amazonaws.cn/docdb

  2. 在控制台左侧的导航窗格中,选择 Parameter groups (参数组)

  3. Cluster parameter groups (集群参数组) 窗格中,选择要重置的集群参数组的名称。

  4. 选择 Actions (操作),然后选择 Reset (重置) 以重置该参数组。

  5. 在生成的 Cluster parameter group reset confirmation (集群参数组重置确认) 页面上,确认您要将该参数组的所有集群参数重置为其默认值。然后选择 Reset (重置) 以重置参数组。您还可以选择 Cancel (取消) 以放弃更改。

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

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

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