修改 Amazon DocumentDB 集群参数组

本部分介绍如何修改自定义 Amazon DocumentDB 参数组。在 Amazon DocumentDB 中，您无法直接修改 default.docdb4.0 集群参数组。如果您的 Amazon DocumentDB 集群使用默认集群参数组，并且您想要修改其中的值，则必须先创建新的参数组或复制现有参数组，修改它，然后将修改后的参数组应用于您的集群。

完成以下步骤可修改非默认集群参数组。修改集群参数组之后，您应至少等待 5 分钟，然后才能使用它。这样，在使用集群参数组之前，Amazon DocumentDB 可以完成全部 modify 操作。您可以使用 AWS 管理控制台 或 AWS CLI describe-db-cluster-parameters 操作来验证集群参数组是否已修改。有关更多信息，请参阅描述集群参数组。

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

修改自定义集群参数组

  1. 通过以下网址登录 AWS 管理控制台并打开 Amazon DocumentDB 控制台：https://console.aws.amazon.com/docdb。
  2. 在控制台左侧的导航窗格中，选择 Parameter groups （参数组）。在参数组列表中，选择要修改的参数组的名称。

提示

如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (修改集群参数组 - 图1)。 3. 对于要修改的参数组中的每个参数，执行以下操作：

  1. 找到要修改的参数，然后通过检查该参数是否在 trueModifiable （可修改） 列下作为 列列出，验证它是否可修改。
  2. 如果可以修改，请选择参数，然后从控制台页面的右上角选择 Edit （编辑）。
  3. 在修改 <parameter-name> 对话框中，进行所需的更改。然后，选择 Modify cluster parameter (修改集群参数) 或选择 Cancel (取消) 以放弃更改。

您可以使用 ParameterValue 修改自定义 Description 集群参数组中任何可修改的参数 ApplyMethod、Amazon DocumentDB 或 AWS CLI。您无法直接修改默认集群参数组。

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

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

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

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

  • ParameterValue — 此参数的新值。

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

    注意

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

例 - 修改参数值

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

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

对于 Linux、macOS 或 Unix:

```

  1. aws docdb describe-db-cluster-parameters \
  2. --db-cluster-parameter-group-name sample-parameter-group ```

对于 Windows:

```

  1. aws docdb describe-db-cluster-parameters ^
  2. --db-cluster-parameter-group-name sample-parameter-group ```

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

```

  1. {
  2. "Parameters": [
  3. {
  4. "Source": "system",
  5. "ApplyType": "static",
  6. "AllowedValues": "disabled,enabled",
  7. "ParameterValue": "enabled",
  8. "ApplyMethod": "pending-reboot",
  9. "DataType": "string",
  10. "ParameterName": "tls",
  11. "IsModifiable": true,
  12. "Description": "Config to enable/disable TLS"
  13. },
  14. {
  15. "Source": "user",
  16. "ApplyType": "dynamic",
  17. "AllowedValues": "disabled,enabled",
  18. "ParameterValue": "enabled",
  19. "ApplyMethod": "pending-reboot",
  20. "DataType": "string",
  21. "ParameterName": "ttl_monitor",
  22. "IsModifiable": true,
  23. "Description": "Enables TTL Monitoring"
  24. }
  25. ]
  26. } ```
  27. 修改 tls 参数，使其值为 disabled。

您无法修改 ApplyMethod，因为 ApplyType 是 static。

对于 Linux、macOS 或 Unix:

```

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

对于 Windows:

```

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

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

```

  1. {
  2. "DBClusterParameterGroupName": "sample-parameter-group"
  3. } ```
  4. 等待至少 5 分钟。
  5. 列出 sample-parameter-group 的参数值，以验证 tls 参数是否已修改。

对于 Linux、macOS 或 Unix:

```

  1. aws docdb describe-db-cluster-parameters \
  2. --db-cluster-parameter-group-name sample-parameter-group ```

对于 Windows:

```

  1. aws docdb describe-db-cluster-parameters ^
  2. --db-cluster-parameter-group-name sample-parameter-group ```

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

```

  1. {
  2. "Parameters": [
  3. {
  4. "ParameterValue": "false",
  5. "ParameterName": "enable_audit_logs",
  6. "ApplyType": "dynamic",
  7. "DataType": "string",
  8. "Description": "Enables auditing on cluster.",
  9. "AllowedValues": "true,false",
  10. "Source": "system",
  11. "IsModifiable": true,
  12. "ApplyMethod": "pending-reboot"
  13. },
  14. {
  15. "ParameterValue": "disabled",
  16. "ParameterName": "tls",
  17. "ApplyType": "static",
  18. "DataType": "string",
  19. "Description": "Config to enable/disable TLS",
  20. "AllowedValues": "disabled,enabled",
  21. "Source": "system",
  22. "IsModifiable": true,
  23. "ApplyMethod": "pending-reboot"
  24. }
  25. ]
  26. } ```