Criando grupos de parâmetros de cluster do Amazon DocumentDB - Amazon DocumentDB

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Criando grupos de parâmetros de cluster do Amazon DocumentDB

Grupos de parâmetros de cluster padrão, como default.docdb5.0, default.docdb4.0, ou default.docdb3.6, são criados quando você cria um cluster com uma nova versão do mecanismo em uma nova região. Os clusters subsequentes criados nessa região com a mesma versão do mecanismo herdam o grupo de parâmetros do cluster default. Depois de criados, os grupos de parâmetros default não podem ser excluídos nem renomeados. Você pode modificar o comportamento do mecanismo das instâncias de cluster criando um grupo de parâmetros personalizado com valores de parâmetros preferenciais e anexando-o ao seu cluster do Amazon DocumentDB.

O procedimento a seguir orienta na criação de um grupo de parâmetros de cluster personalizado com base na família. Depois disso, é possível modificar os parâmetros desse grupo de parâmetros.

nota

Depois de modificar um grupo de parâmetros de cluster, é necessário esperar pelo menos 5 minutos antes de usar esse grupo de parâmetros em particular. Isso permite que o Amazon DocumentDB conclua a ação create integralmente antes que o grupo de parâmetros de cluster seja usado para um novo cluster. Você pode usar a describe-db-cluster-parameter-groups AWS CLI operação AWS Management Console ou a para verificar se o grupo de parâmetros do cluster foi criado. Para obter mais informações, consulte Descrever os grupos de parâmetros de cluster do Amazon DocumentDB.

Using the AWS Management Console
Para criar um grupos de parâmetros de cluster

  1. Faça login no e abra AWS Management Console o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.

  2. No painel de navegação, escolha Grupos de parâmetros.

    dica

    Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (Hamburger menu icon with three horizontal lines.) no canto superior esquerdo da página.

  3. No painel Grupos de parâmetros de cluster, escolha Criar.

  4. No painel Criar grupo de parâmetros do cluster insira o seguinte:

    1. Novo nome do grupo de parâmetros do cluster — Insira um nome para o grupo de parâmetros do cluster. Por exemplo, .sample-parameter-group Os grupos de parâmetros de cluster têm as seguintes restrições de nomenclatura:

      • O tamanho é de [1–255] caracteres alfanuméricos.

      • O primeiro caractere deve ser uma letra.

      • Não podem terminar com um hífen ou conter dois hífens consecutivos.

    2. Família — Escolha uma versão do DocumentDB que você pretende usar para seu cluster.

    3. Descrição — fornece uma descrição para este grupo de parâmetros de cluster.

  5. Para criar o grupo de parâmetro de cluster, escolha Criar. Para cancelar a operação, escolha Cancelar.

  6. Depois de escolher Criar, o texto a seguir será exibido na parte superior da página, para verificar se o grupo de parâmetros de cluster foi criado com êxito:

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

Para criar um novo grupo de parâmetros de cluster para clusters do Amazon DocumentDB 4.0, use a AWS CLI create-db-cluster-parameter-group operação com os seguintes parâmetros:

  • --db-cluster-parameter-group-name — o nome do grupo de parâmetros de cluster personalizado. Por exemplo, .sample-parameter-group

  • --db-cluster-parameter-group-family — a família do grupo de parâmetros de cluster usada como modelo para o grupo de parâmetros de cluster personalizado.

  • --description — a descrição fornecida pelo usuário para esse grupo de parâmetros de cluster. O exemplo a seguir usa "Custom docdb4.0 parameter group".

Para Linux, macOS ou Unix:

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

Para Windows:

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

A saída dessa operação é semelhante ao seguinte (formato JSON).

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