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

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. É possível 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. É possível usar Console de gerenciamento da AWS ou a operação describe-db-cluster-parameter-groups AWS CLI para verificar se o grupo de parâmetros de cluster foi criado. Para obter mais informações, consulte Descrever os grupos de parâmetros de cluster do Amazon DocumentDB.

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

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon DocumentDB em https://console.aws.amazon.com/emr/clusters.

  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. Nome do grupo de parâmetros do novo 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 Amazon DocumentDB 4.0, use a operação AWS CLI create-db-cluster-parameter-group 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"
    }
}