Como trabalhar com grupos de parâmetros de banco de dados em uma instância de banco de dados

As instâncias de banco de dados usam grupos de parâmetros de banco de dados. As seções a seguir descrevem a configuração e o gerenciamento de grupos de parâmetros de instância de banco de dados.

Criar um grupo de parâmetros de banco de dados

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

As seguintes limitações se aplicam ao nome do grupo de parâmetros 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.mysql8.0. 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 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, escolha Parameter groups (Grupos de parâmetros).

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, se aplicável, selecione Grupo de parâmetros do banco de dados.

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

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

8. Escolha Create (Criar).

AWS CLI

Para criar um grupo de parâmetros de banco de dados, use o comando AWS CLI create-db-parameter-groupda . O exemplo a seguir cria um grupo de parâmetros de banco de dados chamado mydbparametergroup para o 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-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-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --db-parameter-group-family MySQL8.0 \
    --description "My new parameter group"

Para Windows:

aws rds create-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --db-parameter-group-family MySQL8.0 ^
    --description "My new parameter group"

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

DBPARAMETERGROUP  mydbparametergroup  mysql8.0  My new parameter group

API do RDS

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

Inclua os seguintes parâmetros necessários:

• DBParameterGroupName

• DBParameterGroupFamily

• Description

Associando um grupo de parâmetros de banco de dados a uma instância de banco de dados

Você pode criar seus próprios grupos de parâmetros de banco de dados com configurações personalizadas. Você pode associar um grupo de parâmetros de banco de dados a uma instância de banco de dados usando a AWS Management Console, a AWS CLI ou a API do RDS. Você pode fazer isso ao criar ou modificar uma instância de banco de dados.

Para obter mais informações sobre como criar um grupo de parâmetros de banco de dados, consulte Criar um grupo de parâmetros de banco de dados. Para obter informações sobre como criar uma instância de banco de dados, consulte Criar uma instância de banco de dados do Amazon RDS. Para ter mais informações sobre como modificar uma instância de banco de dados , consulte Modificar uma instância de banco de dados do Amazon RDS.

nota

Ao associar um novo grupo de parâmetros de banco de dados a uma instância de banco de dados, os parâmetros estáticos e dinâmicos modificados serão aplicados somente após a reinicialização da instância de banco de dados. No entanto, se você modificar parâmetros dinâmicos no grupo de parâmetros de banco de dados depois de associá-lo à instância de banco de dados, essas alterações serão aplicadas imediatamente sem uma reinicialização.

Console

Para associar um grupo de parâmetros de banco de dados a uma instância 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, escolha Databases (Bancos de dados) e a instância de banco de dados que você deseja modificar.

3. Selecione Modify. A página Modify DB instance (Modificar instância de banco de dados) será exibida.

4. Altere a configuração do grupo de parâmetros de banco de dados.

5. Escolha Continue (Continuar) e verifique o resumo de modificações.

6. (Opcional) Escolha Apply immediately (Aplicar imediatamente) para aplicar as alterações imediatamente. Escolher essa opção pode causar uma interrupção em alguns casos. Para obter mais informações, consulte Usar a configuração Aplicar imediatamente.

7. Na página de confirmação, revise suas alterações. Se estiverem corretas, escolha Modify DB Instance (Modificar instância de banco de dados) para salvar suas alterações.

   Ou escolha Back (Voltar) para editar as alterações ou Cancel (Cancelar) para cancelar as alterações.

AWS CLI

Para associar um grupo de parâmetros de banco de dados a uma instância de banco de dados, use o comando da AWS CLI modify-db-instance com as seguintes opções:

• --db-instance-identifier

• --db-parameter-group-name

O exemplo a seguir associa o grupo de parâmetros de banco de dados mydbpg à instância de banco de dados database-1. As alterações são aplicadas imediatamente usando --apply-immediately. Use --no-apply-immediately para aplicar alterações durante a próxima janela de manutenção. Para obter mais informações, consulte Usar a configuração Aplicar imediatamente.

exemplo

Para Linux, macOS ou Unix:

aws rds modify-db-instance \
    --db-instance-identifier database-1 \
    --db-parameter-group-name mydbpg \
    --apply-immediately

Para Windows:

aws rds modify-db-instance ^
    --db-instance-identifier database-1 ^
    --db-parameter-group-name mydbpg ^
    --apply-immediately

API do RDS

Para associar um grupo de parâmetros de banco de dados a uma instância de banco de dados, use a operação da API ModifyDBInstance do RDS com os seguintes parâmetros:

• DBInstanceName

• DBParameterGroupName

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

Você pode modificar valores de parâmetros em um grupo de parâmetros de banco de dados criado pelo cliente, mas não pode alterar os valores dos parâmetros em um grupo de parâmetros de banco de dados padrão. As alterações em parâmetros em um grupo de parâmetros de banco de dados criado pelo cliente são aplicadas a todas as instâncias de bancos de dados que estão associadas a esse grupo de parâmetros.

As alterações em alguns parâmetros são aplicadas à instância de banco de dados imediatamente sem uma reinicialização. As alterações feitas em outros parâmetros só serão aplicadas depois que a instância de banco de dados no cluster de banco de dados for reinicializada. O console do RDS mostra o status do grupo de parâmetros de banco de dados associado a uma instância de banco de dados na guia Configuration (Configuração). Por exemplo, suponha que a instância de banco de dados não esteja usando as últimas alterações do grupo de parâmetros de banco de dados associado. Se sim, o console do RDS mostrará o grupo de parâmetros de banco de dados com o status pending-reboot. Para aplicar as alterações de parâmetro mais recentes a essa instância de banco de dados, reinicialize-a manualmente.

Console

Para modificar um grupo de parâmetros 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. Na lista, escolha o grupo de parâmetros que você deseja modificar.

4. Em Parameter group actions (Ações do grupo de parâmetros), escolha Edit (Editar).

5. 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.

6. Escolha Save changes (Salvar alterações).

AWS CLI

Para copiar um grupo de parâmetros de banco de dados, use o comando AWS CLImodify-db-parameter-group com as seguintes opções obrigatórias:

• --db-parameter-group-name

• --parameters

O exemplo a seguir modifica os valores max_connections e max_allowed_packet no grupo de parâmetros de banco de dados chamado mydbparametergroup.

exemplo

Para Linux, macOS ou Unix:

aws rds modify-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" \
                 "ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"

Para Windows:

aws rds modify-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" ^
                 "ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"

O comando produz uma saída como a seguinte:

DBPARAMETERGROUP  mydbparametergroup

API do RDS

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

• DBParameterGroupName

• Parameters

Redefinir parâmetros em um grupo de parâmetros de banco de dados para seus valores padrão

Você pode redefinir valores de parâmetro em um grupo de parâmetros de banco de dados criado pelo cliente para seus valores padrão. As alterações em parâmetros em um grupo de parâmetros de banco de dados criado pelo cliente são aplicadas a todas as instâncias de bancos de dados que estão associadas a esse grupo de parâmetros.

Ao usar o console, você pode redefinir parâmetros específicos como seus valores padrão. No entanto, não é possível redefinir facilmente todos os parâmetros no grupo de parâmetros de banco de dados de uma só vez. Ao usar A AWS CLI ou a API do RDS, você pode redefinir parâmetros específicos como seus valores padrão. Você também pode redefinir todos os parâmetros no grupo de parâmetros de banco de dados de uma só vez.

As alterações em alguns parâmetros são aplicadas à instância de banco de dados imediatamente sem uma reinicialização. As alterações feitas em outros parâmetros só serão aplicadas depois que a instância de banco de dados no cluster de banco de dados for reinicializada. O console do RDS mostra o status do grupo de parâmetros de banco de dados associado a uma instância de banco de dados na guia Configuration (Configuração). Por exemplo, suponha que a instância de banco de dados não esteja usando as últimas alterações do grupo de parâmetros de banco de dados associado. Se sim, o console do RDS mostrará o grupo de parâmetros de banco de dados com o status pending-reboot. Para aplicar as alterações de parâmetro mais recentes a essa instância de banco de dados, reinicialize-a manualmente.

nota

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

Console

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

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. Na lista, escolha o grupo de parâmetros.

4. Em Parameter group actions (Ações do grupo de parâmetros), escolha Edit (Editar).

5. 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.

6. Escolha Reset (Redefinir) e, em seguida, confirme escolhendo Reset parameters (Redefinir parâmetros).

AWS CLI

Para redefinir alguns ou todos os parâmetros em um grupo de parâmetros de banco de dados, use o comando AWS CLI da reset-db-parameter-group com a seguinte opção necessária: --db-parameter-group-name.

Para redefinir todos os parâmetros no grupo de parâmetros 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-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --reset-all-parameters

Para Windows:

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

O exemplo a seguir redefine as pções max_connections e max_allowed_packet para seus valores padrão no grupo de parâmetros de banco de dados chamado mydbparametergroup.

exemplo

Para Linux, macOS ou Unix:

aws rds reset-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --parameters "ParameterName=max_connections,ApplyMethod=immediate" \
                 "ParameterName=max_allowed_packet,ApplyMethod=immediate"

Para Windows:

aws rds reset-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --parameters "ParameterName=max_connections,ApplyMethod=immediate" ^
                 "ParameterName=max_allowed_packet,ApplyMethod=immediate"

O comando produz uma saída como a seguinte:

DBParameterGroupName  mydbparametergroup

API do RDS

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

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

Copiar um grupo de parâmetros de banco de dados

Você pode copiar os grupos de parâmetros de banco de dados personalizados que criou. Copiar um grupo de parâmetros pode ser uma solução conveniente. Um exemplo é quando você criou um grupo de parâmetros de banco de dados e quer incluir a maioria de seus parâmetros e valores personalizados em um novo grupo de parâmetros de banco de dados. Você pode copiar um grupo de parâmetros de banco de dados usando o AWS Management Console. Também é possível usar o comando copy-db-parameter-group da AWS CLI ou a operação da API CopyDBParameterGroup do RDS.

Depois de copiar um grupo de parâmetros de banco de dados, você deve esperar pelo menos 5 minutos antes de criar sua primeira instância de banco de dados que usa esse grupo de parâmetros de banco de dados como o padrão. Isso permite que o Amazon RDS conclua completamente a ação de cópia antes que o grupo de parâmetros seja usado. Isso é especialmente importante para parâmetros que são críticos ao criar o banco de dados padrão para uma instância de banco de dados. Um exemplo é o conjunto de caracteres para o banco de dados padrão definido pelo parâmetro character_set_database. Use opção Parameter Groups (Grupos de parâmetros) do console do Amazon RDS ou o comando describe-db-parameters para verificar se o seu grupo de parâmetros 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 banco de dados para uma Conta da AWS ou Região da AWS diferente.

Console

Para copiar um grupo de parâmetros 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. Na lista, escolha o grupo de parâmetros personalizado que você deseja copiar.

4. Em Parameter group actions (Ações do grupo de parâmetros), escolha Copy (Copiar).

5. 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.

6. Em Description (Descrição), digite uma descrição para o novo grupo de parâmetros.

7. Escolha Copiar.

AWS CLI

Para copiar um grupo de parâmetros de banco de dados, use o comando da AWS CLI copy-db-parameter-group com as seguintes opções obrigatórias:

• --source-db-parameter-group-identifier

• --target-db-parameter-group-identifier

• --target-db-parameter-group-description

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

exemplo

Para Linux, macOS ou Unix:

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

Para Windows:

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

API do RDS

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

• SourceDBParameterGroupIdentifier

• TargetDBParameterGroupIdentifier

• TargetDBParameterGroupDescription

Listar grupos de parâmetros de banco de dados

Você pode listar os grupos de parâmetros 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 template de parâmetro padrão quando você cria uma instância 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.

Console

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

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.

   Os grupos de parâmetros de banco de dados aparecem em uma lista.

AWS CLI

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

exemplo

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

aws rds describe-db-parameter-groups

O comando retorna uma resposta como a seguinte:

DBPARAMETERGROUP  default.mysql8.0     mysql8.0  Default parameter group for MySQL8.0
DBPARAMETERGROUP  mydbparametergroup   mysql8.0  My new parameter group

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

Para Linux, macOS ou Unix:

aws rds describe-db-parameter-groups \
    --db-parameter-group-name mydbparamgroup1

Para Windows:

aws rds describe-db-parameter-groups ^
    --db-parameter-group-name mydbparamgroup1

O comando retorna uma resposta como a seguinte:

DBPARAMETERGROUP  mydbparametergroup1  mysql8.0  My new parameter group

API do RDS

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

Visualizar valores de parâmetros para um grupo de parâmetros de banco de dados

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

Console

Para visualizar os valores de parâmetros para um grupo de parâmetros 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.

   Os grupos de parâmetros de banco de dados aparecem em uma lista.

3. Escolha o nome do grupo de parâmetros para ver sua lista de parâmetros.

AWS CLI

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

• --db-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 banco de dados chamado mydbparametergroup.

aws rds describe-db-parameters --db-parameter-group-name mydbparametergroup

O comando retorna uma resposta como a seguinte:

DBPARAMETER  Parameter Name            Parameter Value  Source           Data Type  Apply Type  Is Modifiable
DBPARAMETER  allow-suspicious-udfs                      engine-default   boolean    static      false
DBPARAMETER  auto_increment_increment                   engine-default   integer    dynamic     true
DBPARAMETER  auto_increment_offset                      engine-default   integer    dynamic     true
DBPARAMETER  binlog_cache_size         32768            system           integer    dynamic     true
DBPARAMETER  socket                    /tmp/mysql.sock  system           string     static      false

API do RDS

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

• DBParameterGroupName

Excluir um grupo de parâmetros de banco de dados

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

Console

Como excluir um grupo de parâmetros 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.

   Os grupos de parâmetros de banco de dados aparecem em uma lista.

3. Escolha o nome dos grupos de parâmetros a serem excluídos.

4. Escolha Ações e então Excluir.

5. Revise os nomes dos grupos de parâmetros e escolha Excluir.

AWS CLI

Para excluir um grupo de parâmetros de banco de dados, use o comando delete-db-parameter-group da AWS CLI com o parâmetro exigido a seguir.

• --db-parameter-group-name

exemplo

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

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

API do RDS

Para excluir um grupo de parâmetros de banco de dados, use o comando DeleteDBParameterGroup da API do RDS com o parâmetro exigido a seguir.

• DBParameterGroupName