Criar um grupo de parâmetros de cluster de banco de dados Modificar parâmetros em um grupo de parâmetros de cluster de banco de dados Como redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados Copiar um grupo de parâmetros de cluster de banco de dados Listagem de grupos de parâmetros de cluster de banco de dados Visualizar valores de parâmetros de um grupo de parâmetros do cluster de banco de dados Excluir um grupo de parâmetros de cluster

Trabalhar com grupos de parâmetros de clusters de banco de dados multi-AZ

Clusters de banco de dados multi-AZ usam grupos de parâmetros de cluster de banco de dados As seções a seguir descrevem a configuração e o gerenciamento de grupos de parâmetros de cluster de banco de dados.

Tópicos

Criar um grupo de parâmetros de cluster de banco de dados
Modificar parâmetros em um grupo de parâmetros de cluster de banco de dados
Como redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados
Copiar um grupo de parâmetros de cluster de banco de dados
Listagem de grupos de parâmetros de cluster de banco de dados
Visualizar valores de parâmetros de um grupo de parâmetros do cluster de banco de dados
Excluir um grupo de parâmetros de cluster

Criar um grupo de parâmetros de cluster de banco de dados

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.

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

Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.
No painel de navegação, escolha Parameter groups (Grupos de parâmetros).
Escolha Create parameter group (Criar grupo de parâmetros).

A janela Create parameter group (Criar grupo de parâmetros) é exibida.
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)
Na lista Tipo, selecione Grupo de parâmetros de cluster de banco de dados.
Insira o nome do novo grupo de parâmetros de cluster de banco de dados na caixa Group name (Nome do grupo).
Insira uma descrição para o novo grupo de parâmetros de cluster de banco de dados na caixa Description (Descrição).
Escolha Create (Criar).

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 RDS para MySQL versão 8.0 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 mysql8.0 \
    --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 mysql8.0 ^
    --description "My new cluster parameter group"

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


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

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

Modificar parâmetros em um grupo de parâmetros de cluster de banco de dados

É possível modificar valores de parâmetros em um grupo de parâmetros do cluster de banco de dados criado pelo cliente. Não é possível alterar os valores de parâmetros em um grupo de parâmetros do cluster de banco de dados padrão. As alterações dos parâmetros em um grupo de parâmetros de cluster de banco de dados criado pelo cliente são aplicadas a todos os clusters de bancos de dados que estão associados a esse grupo de parâmetros de cluster de banco de dados.

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

Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.
No painel de navegação, selecione Parameter groups.
Na lista, escolha o grupo de parâmetros que você deseja modificar.
Em Parameter group actions (Ações do grupo de parâmetros), escolha Edit (Editar).
Altere os valores dos parâmetros que você deseja modificar. Você pode percorrer os parâmetros usando as teclas de seta no canto superior direito da caixa de diálogo.

Não altere valores em um grupo de parâmetros padrão.
Escolha Save changes (Salvar alterações).
Reinicialize a instância de banco de dados primária (de gravador) no cluster para aplicar as alterações a ela.
Depois, reinicialize as instâncias de banco de dados de leitor para aplicar as alterações a elas.

Para modificar um grupo de parâmetros de cluster de banco de dados, use o comando da AWS CLI modify-db-cluster-parameter-group com os seguintes parâmetros obrigatórios:

--db-cluster-parameter-group-name
--parameters

O exemplo a seguir modifica os valores server_audit_logging e server_audit_logs_upload no grupo de parâmetros de cluster de banco de dados chamado mydbclusterparametergroup.

exemplo

Para Linux, macOS ou Unix:


aws rds modify-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" \
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

Para Windows:


aws rds modify-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

O comando produz uma saída como a seguinte:


DBCLUSTERPARAMETERGROUP  mydbclusterparametergroup

Para modificar um grupo de parâmetros de cluster de banco de dados, use o comando da API do RDS ModifyDBClusterParameterGroup com os seguintes parâmetros obrigatórios:

DBClusterParameterGroupName
Parameters

Como redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados

Você pode redefinir parâmetros para seus valores padrão em um grupo de parâmetro de cluster de banco de dados criado pelo cliente. As alterações dos parâmetros em um grupo de parâmetros de cluster de banco de dados criado pelo cliente são aplicadas a todos os clusters de bancos de dados que estão associados a esse grupo de parâmetros de cluster de banco de dados.

nota

Em um grupo de parâmetro de cluster de banco de dados padrão, os parâmetros são sempre definidos como seus valores padrão.

Para redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados para seus valores padrão

Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.
No painel de navegação, selecione Parameter groups.
Na lista, escolha o grupo de parâmetros.
Em Parameter group actions (Ações do grupo de parâmetros), escolha Edit (Editar).
Escolha os parâmetros que você deseja redefinir para os valores padrão. Você pode percorrer os parâmetros usando as teclas de seta no canto superior direito da caixa de diálogo.

Não redefina os valores em um grupo de parâmetros padrão.
Escolha Reset (Redefinir) e, em seguida, confirme escolhendo Reset parameters (Redefinir parâmetros).
Reinicialize a instância do banco de dados primário no cluster do banco de dados para aplicar as alterações a todas as instâncias de banco de dados no cluster do banco de dados.

Para redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados para seus valores padrão, use o comando da AWS CLI reset-db-cluster-parameter-group com a seguinte opção obrigatória: --db-cluster-parameter-group-name.

Para redefinir todos os parâmetros no grupo de parâmetro do cluster de banco de dados, especifique a opção --reset-all-parameters. Para redefinir parâmetros específicos, especifique a opção --parameters.

O exemplo a seguir redefine todos os parâmetros no grupo de parâmetros de banco de dados chamado mydbparametergroup para seus valores padrão.

exemplo

Para Linux, macOS ou Unix:


aws rds reset-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbparametergroup \
    --reset-all-parameters

Para Windows:


aws rds reset-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbparametergroup ^
    --reset-all-parameters

O exemplo a seguir redefine os valores padrão server_audit_logging e server_audit_logs_upload no grupo de parâmetro de cluster de banco de dados chamado mydbclusterparametergroup.

exemplo

Para Linux, macOS ou Unix:


aws rds reset-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --parameters "ParameterName=server_audit_logging,ApplyMethod=immediate" \
                 "ParameterName=server_audit_logs_upload,ApplyMethod=immediate"

Para Windows:


aws rds reset-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

O comando produz uma saída como a seguinte:


DBClusterParameterGroupName  mydbclusterparametergroup

Para redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados para seus valores padrão, use o comando da API do RDS de ResetDBClusterParameterGroup com o seguinte parâmetro necessário: DBClusterParameterGroupName.

Para redefinir todos os parâmetros no grupo de parâmetros do cluster de banco de dados, defina o parâmetro ResetAllParameters para true. Para redefinir parâmetros específicos, especifique o parâmetro Parameters.

Copiar um grupo de parâmetros de cluster de banco de dados

Você pode copiar os grupos de parâmetros de cluster de banco de dados personalizados que criou. Copiar um grupo de parâmetros é uma solução conveniente quando você já criou um grupo de parâmetros de cluster de banco de dados e deseja incluir a maioria dos parâmetros e valores personalizados desse grupo em um novo grupo de parâmetros de cluster de banco de dados. É possível copiar um grupo de parâmetros de cluster de banco de dados usando o comando AWS CLI copy-db-cluster-parameter-group ou a operação da API do RDS CopyDBClusterParameterGroup.

Depois de copiar 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 cópia 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.

nota

Não é possível copiar um grupo de parâmetros padrão. No entanto, é possível criar um grupo de parâmetros com base em um grupo de parâmetros padrão.

Não é possível copiar um grupo de parâmetros de cluster de banco de dados para uma Conta da AWS ou Região da AWS diferente.

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

Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.
No painel de navegação, selecione Parameter groups.
Na lista, escolha o grupo de parâmetros personalizado que você deseja copiar.
Em Parameter group actions (Ações do grupo de parâmetros), escolha Copy (Copiar).
Em New DB parameter group identifier (Novo identificador do grupo de parâmetros do banco de dados), digite um nome para o novo grupo de parâmetros.
Em Description (Descrição), digite uma descrição para o novo grupo de parâmetros.
Escolha Copiar.

Para copiar um grupo de parâmetros de cluster de banco de dados, use o comando da AWS CLI copy-db-cluster-parameter-group com os seguintes parâmetros obrigatórios:

--source-db-cluster-parameter-group-identifier
--target-db-cluster-parameter-group-identifier
--target-db-cluster-parameter-group-description

O exemplo a seguir cria um novo grupo de parâmetros de cluster de banco de dados chamado mygroup2 que é uma cópia do grupo de parâmetros de cluster de banco de dados mygroup1.

exemplo

Para Linux, macOS ou Unix:


aws rds copy-db-cluster-parameter-group \
    --source-db-cluster-parameter-group-identifier mygroup1 \
    --target-db-cluster-parameter-group-identifier mygroup2 \
    --target-db-cluster-parameter-group-description "DB parameter group 2"

Para Windows:


aws rds copy-db-cluster-parameter-group ^
    --source-db-cluster-parameter-group-identifier mygroup1 ^
    --target-db-cluster-parameter-group-identifier mygroup2 ^
    --target-db-cluster-parameter-group-description "DB parameter group 2"

Para copiar um grupo de parâmetros de cluster de banco de dados, use a operação da API do RDS CopyDBClusterParameterGroup com os seguintes parâmetros obrigatórios:

SourceDBClusterParameterGroupIdentifier
TargetDBClusterParameterGroupIdentifier
TargetDBClusterParameterGroupDescription

Listagem de grupos de parâmetros de cluster de banco de dados

Você pode listar os grupos de parâmetros do cluster de banco de dados que criou para sua conta da AWS.

nota

Grupos de parâmetros padrão são criados automaticamente a partir de um modelo de parâmetro padrão quando você cria um cluster de banco de dados para um mecanismo e uma versão de banco de dados específicos. Esses grupos de parâmetros padrão contêm configurações de parâmetros preferenciais e não podem ser modificados. Quando você cria um grupo de parâmetros personalizado, pode modificar as configurações desses parâmetros.

Para listar todos os grupos de parâmetros do cluster de banco de dados para uma conta da AWS

Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.
No painel de navegação, selecione Parameter groups.

Os parameter groups de cluster de banco de dados são exibidos na lista com DB cluster parameter group (Parameter group de cluster de banco de dados) para o Type (Tipo).

Para listar todos os grupos de parâmetros de cluster de banco de dados de uma conta da AWS, use o comando da AWS CLI describe-db-cluster-parameter-groups.

exemplo

O exemplo a seguir lista todos os grupos de parâmetros de cluster de banco de dados de uma conta da AWS.


aws rds describe-db-cluster-parameter-groups

O exemplo a seguir descreve o grupo de parâmetros mydbclusterparametergroup.

Para Linux, macOS ou Unix:


aws rds describe-db-cluster-parameter-groups \
    --db-cluster-parameter-group-name mydbclusterparametergroup

Para Windows:


aws rds describe-db-cluster-parameter-groups ^
    --db-cluster-parameter-group-name mydbclusterparametergroup

O comando retorna uma resposta como a seguinte:


{
    "DBClusterParameterGroups": [
        {
            "DBClusterParameterGroupName": "mydbclusterparametergroup2",
            "DBParameterGroupFamily": "mysql8.0",
            "Description": "My new cluster parameter group",
            "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
        }
    ]
}

Para listar todos os grupos de parâmetros de cluster de banco de dados de uma conta da AWS, use a ação da API do RDS DescribeDBClusterParameterGroups.

Visualizar valores de parâmetros de um grupo de parâmetros do cluster de banco de dados

Você pode obter uma lista de todos os parâmetros em um grupo de parâmetros de cluster de banco de dados e seus valores.

Para visualizar os valores de parâmetros para um grupo de parâmetros de cluster de banco de dados

Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.
No painel de navegação, selecione Parameter groups.

Os grupos de parâmetros de cluster de banco de dados são exibidos na lista com DB cluster parameter group (Grupo de parâmetros de cluster de banco de dados) para o Type (Tipo).
Escolha o nome do grupo de parâmetros de cluster de banco de dados para ver sua lista de parâmetros.

Para visualizar os valores de parâmetros para um grupo de parâmetros de cluster de banco de dados, use o comando da AWS CLI describe-db-cluster-parameters com o parâmetro obrigatório a seguir.

--db-cluster-parameter-group-name

exemplo

O exemplo a seguir lista os parâmetros e os valores de parâmetros para um grupo de parâmetros de cluster de banco de dados chamado mydbclusterparametergroup, no formato JSON.

O comando retorna uma resposta como a seguinte:


aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name mydbclusterparametergroup


{
    "Parameters": [
        {
            "ParameterName": "activate_all_roles_on_login",
            "ParameterValue": "0",
            "Description": "Automatically set all granted roles as active after the user has authenticated successfully.",
            "Source": "engine-default",
            "ApplyType": "dynamic",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },
        {
            "ParameterName": "allow-suspicious-udfs",
            "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
            "Source": "engine-default",
            "ApplyType": "static",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": false,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },
...

Para visualizar os valores de parâmetros para um grupo de parâmetros de cluster de banco de dados, use o comando DescribeDBClusterParameters da API do RDS com o seguinte parâmetro necessário.

DBClusterParameterGroupName

Em alguns casos, os valores permitidos para um parâmetro não são mostrados. São sempre parâmetros em que a origem é o padrão do mecanismo de banco de dados.

Para visualizar os valores desses parâmetros, você pode executar as seguintes instruções SQL:

MySQL:


-- Show the value of a particular parameter
mysql$ SHOW VARIABLES LIKE '%parameter_name%';

-- Show the values of all parameters
mysql$ SHOW VARIABLES;

PostgreSQL:


-- Show the value of a particular parameter
postgresql=> SHOW parameter_name;

-- Show the values of all parameters
postgresql=> SHOW ALL;

Excluir um grupo de parâmetros de cluster

É possível excluir um grupo de parâmetros de cluster de banco de dados usando o AWS Management Console, a AWS CLI ou a API do RDS. Um grupo de parâmetros do cluster de banco de dados será elegível para exclusão somente se não estiver associado a um cluster de banco de dados.

Para excluir um grupo de parâmetros

Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.
No painel de navegação, escolha Parameter groups (Grupos de parâmetros).

Os grupos de parâmetros aparecem em uma lista.
Escolha o nome dos grupos de parâmetros do cluster de banco de dados a serem excluídos.
Escolha Ações e então Excluir.
Revise os nomes dos grupos de parâmetros e escolha Excluir.

Para excluir um grupo de parâmetros de cluster de banco de dados, use o comando delete-db-cluster-parameter-group da AWS CLI com os parâmetros obrigatórios a seguir.

--db-parameter-group-name

exemplo

O exemplo a seguir exclui um grupo de parâmetros do cluster de banco de dados chamado mydbparametergroup.


aws rds delete-db-cluster-parameter-group --db-parameter-group-name mydbparametergroup

Para excluir um grupo de parâmetros de cluster de banco de dados, use o comando DeleteDBClusterParameterGroup da API do RDS com os parâmetros obrigatórios a seguir.

DBParameterGroupName

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Trabalhar com grupos de parâmetros de banco de dados

Comparação de grupos de parâmetros de banco de dados