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

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

修改 Amazon DocumentDB 集群参数

在 Amazon DocumentDB 中,集群参数组parameters,这样,应用于您在集群中创建的所有实例。对于自定义集群参数组,您可以随时修改参数值,也可以将所有参数值重置为其默认值。本节介绍如何查看构成 Amazon DocumentDB 集群参数组的参数及其值,以及如何更改或更新这些值。

参数可以是动态静态的。当您更改动态参数并保存集群参数组时,将立即应用更改,而不管Apply Immediately设置。当您更改静态参数并保存集群参数组时,参数更改仅在您手动重启实例后生效。

查看 Amazon DocumentDB 集群参数组的参数

您可以使用查看 Amazon DocumentDB 集群的参数及其值。Amazon Web Services Management Console或者Amazon CLI.

要查看集群参数组的详细信息

  1. 登录到Amazon Web Services Management Console,然后打开 Amazon DocumentDB 控制台https://console.aws.amazon.com/docdb.

  2. 在导航窗格中,选择参数组

    提示

    如果您在屏幕左侧没有看到导航窗格,请在页面左上角选择菜单图标 ()。

  3. Parameter groups (参数组) 窗格中,选择要查看其详细信息的集群参数组的名称。

  4. 生成的页面显示每个参数的以下值:参数的名称、当前值、允许的值、参数是否可修改、应用类型、数据类型和描述。

    
                           屏幕截图: 参数名称和值。

要查看集群参数组的参数及其值,请使用带有以下参数的 describe-db-cluster-parameters 操作。

  • --db-cluster-parameter-group-name – 必需。您想要详细参数列表的集群参数组的名称。

  • --source— 可选。如果提供特定源,仅返回参数。参数源可以是 engine-defaultsystemuser

以下代码列出了 custom3-6-param-grp 参数组的所有参数及其值。有关参数组的更多信息,请省略--query行。有关所有参数组的信息,请省略--db-cluster-parameter-group-name行。

对于 Linux、macOS 或 Unix:

aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name custom3-6-param-grp \ --query 'Parameters[*].[ParameterName,ParameterValue]'

对于 Windows:

aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name custom3-6-param-grp ^ --query 'Parameters[*].[ParameterName,ParameterValue]'

此操作的输出将类似于下文(JSON 格式)。

[ [ "audit_logs", "disabled" ], [ "tls", "enabled" ], [ "ttl_monitor", "enabled" ] ]

修改 Amazon DocumentDB 集群参数组的参数

您可以使用修改参数组的参数,Amazon Web Services Management Console或者Amazon CLI.

要更新集群参数组的参数,请执行以下操作:

  1. 登录到Amazon Web Services Management Console,然后打开 Amazon DocumentDB 控制台https://console.aws.amazon.com/docdb.

  2. 在导航窗格中,选择参数组

    提示

    如果您在屏幕左侧没有看到导航窗格,请在页面左上角选择菜单图标 ()。

  3. 参数组窗格中,选择您要更新其参数的集群参数组。

  4. 生成的页面将显示此集群参数组的参数及其相应的详细信息。选择要更新的参数。

  5. 在页面右上角,选择编辑以更改参数的值。有关集群参数的类型的更多信息,请参阅,Amazon DocumentDB 集群参数参考.

  6. 进行更改,然后选择修改集群参数保存更改。要放弃更改,请选择Cancel.

要修改集群参数组的参数,请使用带以下参数的 modify-db-cluster-parameter-group 操作:

  • --db-cluster-parameter-group-name – 必需。您正在修改的集群参数组的名称。

  • --parameters – 必需。您正在修改的参数。每个参数条目必须包含以下内容:

    • ParameterName— 您正在修改的参数的名称。

    • ParameterValue— 此参数的新值。

    • ApplyMethod— 您希望如何对应用的参数进行更改。允许的值为 immediatepending-reboot

      注意

      staticApplyType 参数必须具有 pending-rebootApplyMethod

要更改集群参数组的参数值 (Amazon CLI)

以下示例将更改 tls 参数。

  1. 列出的参数及其值 sample-parameter-group

    对于 Linux、macOS 或 Unix:

    aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group

    对于 Windows:

    aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group

    此操作的输出将类似于下文(JSON 格式)。

    { "Parameters": [ { "Source": "system", "ApplyType": "static", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "tls", "IsModifiable": true, "Description": "Config to enable/disable TLS" }, { "Source": "user", "ApplyType": "dynamic", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "ttl_monitor", "IsModifiable": true, "Description": "Enables TTL Monitoring" } ] }
  2. 修改 tls 参数,以便其值为 disabled。您无法修改ApplyMethod由于ApplyTypestatic.

    对于 Linux、macOS 或 Unix:

    aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --parameters "ParameterName"=tls,ParameterValue=disabled,ApplyMethod=pending-reboot"

    对于 Windows:

    aws docdb modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --parameters "ParameterName=tls,ParameterValue=disabled,ApplyMethod=pending-reboot"

    此操作的输出将类似于下文(JSON 格式)。

    { "DBClusterParameterGroupName": "sample-parameter-group" }
  3. 等待至少 5 分钟。

  4. 列出的参数值sample-parameter-group.

    对于 Linux、macOS 或 Unix:

    aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group

    对于 Windows:

    aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group

    此操作的输出将类似于下文(JSON 格式)。

    { "Parameters": [ { "ParameterName": "audit_logs", "ParameterValue": "disabled", "Description": "Enables auditing on cluster.", "Source": "system", "ApplyType": "dynamic", "DataType": "string", "AllowedValues": "enabled,disabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, { "ParameterName": "tls", "ParameterValue": "disabled", "Description": "Config to enable/disable TLS", "Source": "user", "ApplyType": "static", "DataType": "string", "AllowedValues": "disabled,enabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" } ] }