Trabalhar com grupos de parâmetros 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 parameter group de banco de dados usando o AWS Management Console, a AWS CLI ou a API do RDS.

Console

Para criar um parameter group 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 parameter group).

   A janela Create parameter group (Criar parameter group) é exibida.

4. Selecione uma família de parameter groups de banco de dados na lista Parameter group family (Família de parameter groups).

5. Na lista Type (Tipo), selecione DB Parameter Group (Parameter group de 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 parameter group de banco de dados, use o comando AWS CLI create-db-parameter-groupda . O exemplo a seguir cria um parameter group de banco de dados chamado mydbparametergroup para o MySQL versão 5.6 com a descrição "My new parameter group (Meu novo parameter group)".

Inclua os seguintes parâmetros necessários:

• --db-parameter-group-name

• --db-parameter-group-family

• --description

Para listar todas as famílias de parameter groups 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 MySQL5.6 \
    --description "My new parameter group"

Para Windows:

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

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

DBPARAMETERGROUP  mydbparametergroup  mysql5.6  My new parameter group

API do RDS

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

Inclua os seguintes parâmetros necessários:

• DBParameterGroupName

• DBParameterGroupFamily

• Description

Associando um parameter group de banco de dados a uma instância de banco de dados

Você pode criar seus próprios parameter groups de banco de dados com configurações personalizadas. Você pode associar um parameter group 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 parameter group 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 mais informações sobre a modificação de 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 recém-associado, essas alterações serão aplicadas imediatamente sem uma reinicialização.

Console

Para associar um parameter group 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) é exibida.

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

5. Selecione 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 selecione 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 mydbpg parameter group de banco de dados à instância de database-1 banco de dados. 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 do RDS ModifyDBInstance 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 parameter group 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 parameter group.

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 parameter group de banco de dados associado a uma instância de banco de dados na guia Configuration (Configuração). Por exemplo, se a instância de banco de dados não estiver usando as últimas alterações do grupo de parâmetros de banco de dados associado, o console do RDS mostrará o grupo de parâmetros de banco de dados com um status de pending-reboot (reinicialização pendente). 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 parameter group 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. Selecione Save changes.

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 parameter group 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 do RDS ModifyDBParameterGroup 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 parameter group 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 parameter group.

Quando você usa o console, você pode redefinir parâmetros específicos para seus valores padrão, mas não pode redefinir facilmente todos os parâmetros no grupo de parâmetros de banco de dados de uma só vez. Quando você usa a AWS CLI ou a API do RDS, você pode redefinir parâmetros específicos para seus valores padrão e você 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 parameter group de banco de dados associado a uma instância de banco de dados na guia Configuration (Configuração). Por exemplo, se a instância de banco de dados não estiver usando as últimas alterações do grupo de parâmetros de banco de dados associado, o console do RDS mostrará o grupo de parâmetros de banco de dados com um status de pending-reboot (reinicialização pendente). 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 parameter groups de banco de dados personalizados que criou. Copiar um parameter group é uma solução conveniente quando você já criou um parameter group de banco de dados e deseja incluir a maioria dos parâmetros e valores personalizados desse grupo em um novo parameter group de banco de dados. É possível copiar um grupo de parâmetros de banco de dados usando o AWS Management Console, o comando da AWS CLI copy-db-parameter-group ou a operação da API do RDS CopyDBParameterGroup.

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 parameter group padrão. No entanto, é possível criar um parameter group com base em um parameter group padrão.

No momento, você não pode copiar um grupo de parâmetros para uma região da AWS diferente.

Console

Para copiar um parameter group 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 parameter group do banco de dados), digite um nome para o novo parameter group.

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 parameter group de banco de dados chamado mygroup2 que é uma cópia do parameter group 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

Parameter groups 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 parameter group 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 parameter groups 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.mysql5.6     mysql5.6  Default parameter group for MySQL5.6
DBPARAMETERGROUP  mydbparametergroup   mysql5.6  My new parameter group

O exemplo a seguir descreve o parameter group 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  mysql5.6  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 parameter group de banco de dados e seus valores.

Console

Para visualizar os valores de parâmetros para um parameter group 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 parameter groups 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 parameter group 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 parameter group 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