创建 Amazon DocumentDB 集群参数组 - Amazon DocumentDB

创建 Amazon DocumentDB 集群参数组

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

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

注意

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

Using the AWS Management Console
要创建集群参数组

  1. 登录到 AWS Management Console 并打开 Amazon DocumentDB 控制台，网址：https://console.aws.amazon.com/docdb。

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

    提示

    如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (Hamburger menu icon with three horizontal lines.)。

  3. 在集群参数组窗格中，选择创建。

  4. 在创建集群参数组窗格中，输入以下内容：

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

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

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

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

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

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

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

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

要为 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：

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"
    }
}