创建 Amazon DocumentDB 集群参数组

Amazon DocumentDB 提供了 3.6 和 4.0 版本控制的集群参数组。您可以基于名为 docdb4.0 的 default.docdb4.0 系列创建默认集群参数组。 在这两种版本中，您无法直接修改 default.docdb4.0 或 default.docdb3.6 集群参数组。要在集群参数组中自定义参数并将其与您的 Amazon DocumentDB 集群关联，您必须先创建新的非默认集群参数组。然后，您可以修改该新的自定义参数组中的参数，并将其与您的 Amazon DocumentDB 集群关联。

以下过程将指导您根据 docdb4.0 系列创建自定义集群参数组。然后，您可以修改该参数组中的参数。

注意

创建集群参数组后，您应至少等待 5 分钟，再使用该特定参数组。这样，在将集群参数组用于新集群之前，Amazon DocumentDB 可以完成全部 create 操作。您可以使用 AWS 管理控制台 或 describe-db-cluster-parameter-groups AWS CLI 操作来验证是否已创建集群参数组。有关更多信息，请参阅描述 Amazon DocumentDB 集群参数组。

要创建集群参数组

  1. 通过以下网址登录 AWS 管理控制台并打开 Amazon DocumentDB 控制台：https://console.aws.amazon.com/docdb。

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

    提示

    如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (创建集群参数组 - 图1)。

  3. 在 Cluster parameter groups （集群参数组） 窗格中，选择 Create （创建）。

  4. 在 Create cluster parameter group （创建集群参数组） 窗格中，输入以下内容：

    1. 组名称 为集群参数组输入名称。—例如，sample-parameter-group。 集群参数组具有以下命名约束：

      • 长度为 [1–255] 个字母数字字符。

      • 第一个字符必须是字母。

      • 不能以连字符结束或包含两个连续连字符。

    2. 描述 — 提供此集群参数组的描述。

  5. 要创建集群参数组，请选择创建。要取消操作，请选择取消。

  6. 选择 Create （创建） 后，将在页面顶部显示以下文本以验证您的集群参数组是否已成功创建：

    1. Successfully created cluster parameter group 'sample-parameter-group'.

要为 Amazon DocumentDB 4.0 集群创建新的集群参数组，请使用带以下参数的 AWS CLI create-db-cluster-parameter-group 操作：

  • --db-cluster-parameter-group-name — 自定义集群参数组的名称。例如：sample-parameter-group。

  • --db-cluster-parameter-group-family — 作为自定义集群参数组模板的集群参数组系列。目前，必须为 docdb4.0。

  • --description — 用户提供的集群参数组描述。以下示例使用“Custom docdb4.0 parameter group”。

对于 Linux、macOS 或 Unix:

  1. aws docdb create-db-cluster-parameter-group \
  2.  --db-cluster-parameter-group-name sample-parameter-group \
  3.  --db-parameter-group-family docdb4.0 \
  4.  --description "Custom docdb4.0 parameter group"

对于 Windows:

  1. aws docdb create-db-cluster-parameter-group ^
  2.  --db-cluster-parameter-group-name sample-parameter-group ^
  3.  --db-parameter-group-family docdb4.0 ^
  4.  --description "Custom docdb4.0 parameter group"

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

  1. {
  2.     "DBClusterParameterGroup": {
  3.         "DBClusterParameterGroupName": "sample-parameter-group",
  4.         "DBParameterGroupFamily": "docdb4.0",
  5.         "Description": "Custom docdb4.0 parameter group",
  6.         "DBClusterParameterGroupArn": "sample-parameter-group-arn"
  7.     }
  8. }