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

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

修改亚马逊 DocumentDB 集群参数组

本节介绍如何修改自定义亚马逊 DocumentDB 参数组。在亚马逊 DocumentDB 中，您无法修改default集群参数组，是在您首次在新区域使用新引擎版本创建集群时创建的。如果您的 Amazon DocumentDB 集群使用的是默认集群参数组，并且您想要修改其中的值，则必须先修改其中的值创建新的参数组要么复制现有的参数组，对其进行修改，然后将修改后的参数组应用于您的集群。

完成以下步骤以修改自定义集群参数组。修改操作可能需要一段时间才能传播。请等待修改后的集群参数组可用，然后再将其附加到您的集群。你可以使用Amazon Web Services Management Console或者Amazon CLI describe-db-cluster-parameters操作以验证您的集群参数组是否已被修改。有关更多信息，请参阅描述集群参数组：

Using the Amazon Web Services Management Console

按照以下步骤修改自定义 Amazon DocumentDB 参数组。你无法修改default参数组。如果要修改中的值default参数组，你可以复制默认集群参数组，对其进行修改，然后将修改后的参数组应用于您的集群。有关将参数组应用于集群的更多信息，请参阅修改 AAmazon DocumentDB men。

修改自定义集群参数组

  1. 登录Amazon Web Services Management Console，然后打开亚马逊 DocumentDB 控制台，网址为https://console.aws.amazon.com/docdb。

  2. 在控制台左侧的导航窗格中，选择参数组。在参数组列表中，选择要修改的参数组的名称。

    提示

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

  3. 对于要修改的参数组中的每个参数，执行以下操作：

    1. 找到要修改的参数，并通过检查其是否被列为，来验证该参数是否可以修改true在下面可修改专栏。

    2. 如果可以修改，请选择参数并选择编辑从控制台页面的右上角。

    3. 在修改 <parameter-name> 对话框中，进行所需的更改。然后，选择 Modify cluster parameter (修改集群参数) 或选择 Cancel (取消) 以放弃更改。

Using the Amazon CLI

你可以修改ParameterValue，Description，或ApplyMethod使用自定义 Amazon DocumentDB 集群参数组中的任何可修改参数Amazon CLI。您不能直接对默认集群参数组进行修改。

要修改自定义集群参数组的参数，请使用modify-db-cluster-parameter-group使用以下参数进行操作。

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

  • --parameters – 必需。您正在修改的参数。有关适用于 Amazon DocumentDB 集群中所有实例的参数列表，请参阅亚马逊文档数据库集群参数参考。每个参数条目必须包含以下内容：

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

    • ParameterValue— 此参数的新值。

    • ApplyMethod— 您希望如何应用对此参数的更改。允许的值为 immediate 和 pending-reboot。

      注意

      带 static 的 ApplyType 参数必须具有 pending-reboot 的 ApplyMethod。

例 -修改参数的值

在此示例中，您列出了的参数值sample-parameter-group并修改tls参数。然后，等待 5 分钟后，再次列出 sample-parameter-group 的参数值以查看更改后的参数值。

  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因为ApplyType是static。

    对于 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以验证tls参数已修改。

    对于 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": [
           {
               "ParameterValue": "false",
               "ParameterName": "enable_audit_logs",
               "ApplyType": "dynamic",
               "DataType": "string",
               "Description": "Enables auditing on cluster.",
               "AllowedValues": "true,false",
               "Source": "system",
               "IsModifiable": true,
               "ApplyMethod": "pending-reboot"
           },
           {
               "ParameterValue": "disabled",
               "ParameterName": "tls",
               "ApplyType": "static",
               "DataType": "string",
               "Description": "Config to enable/disable TLS",
               "AllowedValues": "disabled,enabled",
               "Source": "system",
               "IsModifiable": true,
               "ApplyMethod": "pending-reboot"
           }
       ]
}