Criar um grupo de parâmetros do cluster de banco de dados no Amazon Aurora

Você pode criar um novo grupo de parâmetros de cluster de banco de dados usando o AWS Management Console, a AWS CLI ou a API do RDS.

Depois de criar um grupo de parâmetros de cluster de banco de dados, você deve esperar pelo menos 5 minutos antes de criar seu primeiro cluster que usa esse grupo de parâmetros de cluster de banco de dados. Isso permite que o Amazon RDS conclua totalmente a criação do grupo de parâmetros antes que seja usado pelo novo cluster de banco de dados. É possível usar a página Parameter Groups (Grupos de parâmetros) do console do Amazon RDS ou o comando describe-db-cluster-parameters para verificar se o seu grupo de parâmetros de cluster de banco de dados foi criado.

As seguintes limitações se aplicam ao nome do grupo de parâmetros do cluster de banco de dados:

• O nome deve ter de 1 a 255 letras, números ou hifens.

  Os nomes de grupos de parâmetros padrão podem incluir um ponto, como default.aurora-mysql5.7. No entanto, nomes de grupos de parâmetros personalizados não podem incluir um ponto.

• O primeiro caractere deve ser uma letra.

• O nome não pode terminar com hífen nem conter dois hífens consecutivos.

Console

Para criar um grupo de parâmetros de cluster de banco de dados

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

2. No painel de navegação, selecione Parameter groups.

3. Escolha Create parameter group (Criar grupo de parâmetros).

   A janela Create parameter group (Criar grupo de parâmetros) é exibida.

4. Selecione uma família de grupos de parâmetros de banco de dados na lista Parameter group family (Família de grupos de parâmetros)

5. Na lista Tipo, selecione Grupo de parâmetros de cluster de banco de dados.

6. Insira o nome do novo grupo de parâmetros de cluster de banco de dados na caixa Group name (Nome do grupo).

7. Insira uma descrição para o novo grupo de parâmetros de cluster de banco de dados na caixa Description (Descrição).

8. Escolha Create (Criar).

AWS CLI

Para criar um grupo de parâmetros de cluster de banco de dados, use o comando da AWS CLI create-db-cluster-parameter-group.

O exemplo a seguir cria um grupo de parâmetros de cluster de banco de dados chamado mydbclusterparametergroup para o Aurora MySQL versão 5.7 com a descrição "My new parameter group” (Meu novo grupo de parâmetros).

Inclua os seguintes parâmetros necessários:

• --db-cluster-parameter-group-name

• --db-parameter-group-family

• --description

Para listar todas as famílias de grupos de parâmetros disponíveis, use o comando a seguir:

aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"

nota

A saída contém duplicatas.

exemplo

Para Linux, macOS ou Unix:

aws rds create-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --db-parameter-group-family aurora-mysql5.7 \
    --description "My new cluster parameter group"

Para Windows:

aws rds create-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --db-parameter-group-family aurora-mysql5.7 ^
    --description "My new cluster parameter group"

O comando gerará uma saída semelhante à seguinte:

{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "mydbclusterparametergroup",
        "DBParameterGroupFamily": "aurora-mysql5.7",
        "Description": "My new cluster parameter group",
        "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
    }
}

API do RDS

Para criar um grupo de parâmetros de cluster de banco de dados, use a ação da API do RDS CreateDBClusterParameterGroup.

Inclua os seguintes parâmetros necessários:

• DBClusterParameterGroupName

• DBParameterGroupFamily

• Description