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.
Tópicos
- Criar um grupo de parâmetros de banco de dados
- Associando um parameter group de banco de dados a uma instância de banco de dados
- Modificar parâmetros em um grupo de parâmetros de banco de dados
- Redefinir parâmetros em um grupo de parâmetros de banco de dados para seus valores padrão
- Copiar um grupo de parâmetros de banco de dados
- Listar grupos de parâmetros de banco de dados
- Visualizar valores de parâmetros para um grupo de parâmetros 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.
Para criar um parameter group 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.
-
Escolha Create parameter group (Criar parameter group).
A janela Create parameter group (Criar parameter group) é exibida.
-
Selecione uma família de parameter groups de banco de dados na lista Parameter group family (Família de parameter groups).
-
Na lista Type (Tipo), selecione DB Parameter Group (Parameter group de banco de dados).
-
Insira o nome do novo grupo de parâmetros de banco de dados na caixa Group name (Nome do grupo).
-
Insira uma descrição para o novo grupo de parâmetros de banco de dados na caixa Description (Descrição).
-
Escolha Create (Criar).
Para criar um parameter group de banco de dados, use o comando AWS CLI create-db-parameter-group
da . 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"
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-familyMySQL5.6
\ --description"My new parameter group"
Para Windows:
aws rds create-db-parameter-group ^ --db-parameter-group-name
mydbparametergroup
^ --db-parameter-group-familyMySQL5.6
^ --description"My new parameter group"
O comando gerará uma saída semelhante à seguinte:
DBPARAMETERGROUP mydbparametergroup mysql5.6 My new parameter group
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.
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.
Para associar um parameter group de banco de dados a uma instância 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 Databases (Bancos de dados) e a instância de banco de dados que você deseja modificar.
-
Selecione Modify. A página Modify DB Instance (Modificar instância de banco de dados) é exibida.
-
Altere a configuração do grupo de parâmetros de banco de dados.
-
Selecione Continue (Continuar) e verifique o resumo de modificações.
-
(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.
-
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.
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-namemydbpg
\--apply-immediately
Para Windows:
aws rds modify-db-instance ^ --db-instance-identifier
database-1
^ --db-parameter-group-namemydbpg
^--apply-immediately
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.

Para modificar um parameter group 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.
-
Selecione Save changes.
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
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.

Em um grupo de parâmetros de banco de dados padrão, os parâmetros são sempre definidos para seus valores padrão.
Para redefinir parâmetros em um grupo de parâmetros 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).
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
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
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.
Para copiar um parameter group 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 parameter group do banco de dados), digite um nome para o novo parameter group.
-
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 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-identifiermygroup2
\ --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-identifiermygroup2
^ --target-db-parameter-group-description"DB parameter group 2"
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.
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.
Para listar todos os grupos de parâmetros 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 banco de dados aparecem em uma lista.
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
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.
Para visualizar os valores de parâmetros para um parameter group 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 parameter groups de banco de dados aparecem em uma lista.
-
Escolha o nome do grupo de parâmetros para ver sua lista de parâmetros.
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
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