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

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

重置 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— 可选。集群参数组中要重置为其默认值的 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