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

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

创建 Amazon DocumentDB 集群参数组

当您使用新引擎版本和在新区域创建集群时创建的默认集群参数组,例如 default.docdb5.0default.docdb4.0default.docdb3.6。在此区域创建且具有相同引擎版本的后续集群将继承 default 集群参数组。一经创建,default 参数组就无法删除或重命名。您可以通过创建带有首选参数值的自定义参数组并将其附加到 Amazon DocumentDB 集群来修改集群实例的引擎行为。

以下过程指导您完成集群参数组的创建。然后,您可以修改该参数组中的参数

注意

创建一个集群参数组之后,您应至少等 5 分钟,再使用特定的集群参数组。这样,在将集群参数组用于新集群之前,Amazon DocumentDB 可以完成全部 create 操作。您可以使用 Amazon Web Services Management Consoledescribe-db-cluster-parameter-groups 或 Amazon CLI 操作来验证您的集群参数组是否已创建。有关更多信息,请参阅描述 Amazon DocumentDB 集群参数组

Using the Amazon Web Services Management Console
要创建集群参数组
  1. 登录到 Amazon Web Services Management Console 并打开 Amazon DocumentDB 控制台,网址:https://console.aws.amazon.com/docdb

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

    提示

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

  3. 集群参数组窗格中,选择创建

  4. 创建集群参数组窗格中,输入以下内容:

    1. 组名称 — 为集群参数组输入一个名称。例如,sample-parameter-group。集群参数组具有以下命名限制:

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

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

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

    2. 描述 — 为此集群参数组提供一个描述。

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

  6. 选择创建后,以下文本将显示于页面顶部,以验证集群参数组是否已成功创建:

    Successfully created cluster parameter group 'sample-parameter-group'.
Using the Amazon CLI

要为 Amazon DocumentDB 4.0 集群创建一个新的集群参数组,可借助以下参数使用 Amazon 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:

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

对于 Windows:

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

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

{ "DBClusterParameterGroup": { "DBClusterParameterGroupName": "sample-parameter-group", "DBParameterGroupFamily": "docdb4.0", "Description": "Custom docdb4.0 parameter group", "DBClusterParameterGroupArn": "sample-parameter-group-arn" } }