# Grupos de parâmetros para Amazon RDS
*Database parameters* (Parâmetros do banco de dados) especifica como o banco de dados é configurado. Por exemplo, os parâmetros do banco de dados podem especificar a quantidade de recursos, como memória, a serem alocados para um banco de dados.
Você gerencia a configuração do banco de dados associando suas instâncias e seus clusters de banco de dados multi-AZ com grupos de parâmetros. O Amazon RDS define grupos de parâmetros com configurações padrão. Você também pode definir seus próprios grupos de parâmetros com configurações personalizadas.
**nota**
Alguns mecanismos de banco de dados oferecem recursos adicionais que você pode adicionar ao seu banco de dados como opções em um grupo de opções. Para obter informações sobre grupos de opções, consulte [Trabalhar com grupos de opções](USER_WorkingWithOptionGroups.md).
**Topics**
+ [
# Visão geral dos grupos de parâmetros
](parameter-groups-overview.md)
+ [
# Grupos de parâmetros de banco de dados para instâncias de banco de dados do Amazon RDS
](USER_WorkingWithDBInstanceParamGroups.md)
+ [
# Trabalhar com grupos de parâmetros de clusters de banco de dados multi-AZ
](USER_WorkingWithDBClusterParamGroups.md)
+ [
# Comparação de grupos de parâmetros de banco de dados
](USER_WorkingWithParamGroups.Comparing.md)
+ [
# Especificação de parâmetros de banco de dados
](USER_ParamValuesRef.md)
# Visão geral dos grupos de parâmetros
Um *grupo de parâmetros de banco de dados* atua como um contêiner para valores de configuração de mecanismo que são aplicados a uma ou mais instâncias de bancos de dados.
*Grupos de parâmetros de cluster de banco de dados* se aplicam somente a clusters de banco de dados multi-AZ. As configurações do grupo de parâmetros de um cluster de banco de dados multi-AZ se aplicam a todas as instâncias de banco de dados contidas no cluster. O grupo de parâmetros de banco de dados padrão do mecanismo e da versão do mecanismo de banco de dados é usado para cada instância de banco de dados contida no cluster de banco de dados.
**Topics**
+ [
## Grupos de parâmetros padrão e personalizados
](#parameter-groups-overview.custom)
+ [
## Parâmetros estáticos e dinâmicos de instância de banco de dados
](#parameter-groups-overview.db-instance)
+ [
## Parâmetros estáticos e dinâmicos de cluster de banco de dados
](#parameter-groups-overview.maz)
+ [
## Parâmetros de conjunto de caracteres
](#parameter-groups-overview.char-sets)
+ [
## Parâmetros e valores de parâmetros compatíveis
](#parameter-groups-overview.supported)
## Grupos de parâmetros padrão e personalizados
Se você criar uma instância de banco de dados sem especificar um grupo de parâmetros de banco de dados, essa instância usará o grupo de parâmetros de banco de dados padrão. Da mesma forma, se você criar um cluster de banco de dados multi-AZ sem especificar um grupo de parâmetros de cluster de banco de dados, esse cluster usará um grupo de parâmetros de cluster de banco de dados padrão. Cada grupo de parâmetros de banco de dados padrão contém padrões de mecanismo de banco de dados e do sistema Amazon RDS com base no mecanismo, na classe de computação e no armazenamento alocado da instância.
Não é possível modificar as configurações de parâmetros de um grupo de parâmetros padrão. Em vez disso, você pode fazer o seguinte:
1. Crie um novo grupo de parâmetros.
1. Altere as configurações dos parâmetros desejados. Nem todos os parâmetros de mecanismo de banco de dados em um grupo de parâmetros podem ser modificados.
1. Modifique a instância de banco de dados ou o cluster de banco de dados para associar o novo grupo de parâmetros.
Ao associar um novo grupo de parâmetros de banco de dados a uma instância de banco de dados, a associação acontece imediatamente. Para obter informações sobre como modificar uma instância de banco de dados, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md). Para obter informações sobre como modificar clusters de banco de dados multi-AZ, consulte [Modificar um cluster de banco de dados multi-AZ para o Amazon RDS](modify-multi-az-db-cluster.md).
**nota**
Se você modificou sua instância de banco de dados para usar um grupo de parâmetros personalizado, e iniciar a instância de banco de dados, o RDS reinicializará automaticamente a instância de banco de dados como parte do processo de inicialização. Para instâncias multi-AZ do RDS para SQL Server com a opção “Sempre ativa” ou “Espelhamento” habilitada, um failover é esperado quando a instância é reiniciada após o processo de inicialização.
O RDS aplica os parâmetros estáticos e dinâmicos modificados a um grupo de parâmetros recém-associado somente depois que a instância de banco de dados é reinicializada. 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. Para obter mais informações sobre como alterar o grupo de parâmetros de banco de dados, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md).
Se você atualizar parâmetros dentro de um grupo de parâmetros de banco de dados, as alterações se aplicarão a todas as instâncias de banco de dados associadas a esse grupo de parâmetros. Da mesma forma, se você atualizar os parâmetros dentro de um grupo de parâmetros de cluster de banco de dados multi-AZ, as alterações se aplicarão a todos os clusters do Aurora que estiverem associados a esse grupo.
Se você não quiser criar um grupo de parâmetros do zero, poderá copiar um grupo de parâmetros existente com o comando [copy-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html) ou o comando [copy-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) da AWS CLI. Você pode perceber que copiar um grupo de parâmetros é útil em alguns casos. Por exemplo, talvez você queira incluir a maioria dos valores e parâmetros personalizados de um grupo de parâmetros de banco de dados existente em um novo grupo de parâmetros de banco de dados.
## Parâmetros estáticos e dinâmicos de instância de banco de dados
Os parâmetros de instância de banco de dados são estáticos ou dinâmicos. As diferenças são as seguintes:
+ Quando você altera um parâmetro estático e salva o grupo de parâmetros de banco de dados, a alteração entra em vigor depois que você reinicializa as instâncias de banco de dados manualmente. Para parâmetros estáticos, o console sempre usa `pending-reboot` para o `ApplyMethod`.
+ Quando você altera um parâmetro dinâmico, por padrão, a alteração de parâmetro entra em vigor imediatamente, sem a necessidade de reinicialização. Quando você usa o Console de gerenciamento da AWS para alterar os valores dos parâmetros da instância de banco de dados, ele sempre usa `immediate` para `ApplyMethod` para parâmetros dinâmicos. Para adiar a alteração do parâmetro até a finalização da reinicialização de uma instância de banco de dados associada, use a AWS CLI ou a API do RDS. Defina o `ApplyMethod` como `pending-reboot` para a alteração do parâmetro.
**nota**
O uso do `pending-reboot` com parâmetros dinâmicos no AWS CLI ou no API do RDS em instâncias de banco de dados do RDS for SQL Server gera um erro. Use `apply-immediately` no RDS for SQL Server.
Para obter mais informações sobre como usar a AWS CLI para alterar um valor de parâmetro, consulte [modify-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html). Para obter mais informações sobre como usar a API do RDS para alterar um valor de parâmetro, consulte [ModifyDBParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html).
Se uma instância de banco de dados não estiver usando as últimas alterações de seu grupo de parâmetros de banco de dados associado, o console mostrará o status **pending-reboot** para o grupo de parâmetros de banco de dados. Esse status não ocasionará uma reinicialização automática durante a próxima janela de manutenção. Para aplicar as alterações de parâmetro mais recentes a essa instância de banco de dados, reinicialize-a manualmente.
## Parâmetros estáticos e dinâmicos de cluster de banco de dados
Os parâmetros de cluster de banco de dados são estáticos ou dinâmicos. As diferenças são as seguintes:
+ Quando você altera um parâmetro estático e salva o grupo de parâmetros do cluster de banco de dados, a alteração do parâmetro entra em vigor depois que você reinicializa manualmente os clusters de banco de dados associados. Para parâmetros estáticos, o console sempre usa `pending-reboot` para o `ApplyMethod`.
+ Quando você altera um parâmetro dinâmico, por padrão, a alteração de parâmetro entra em vigor imediatamente, sem a necessidade de reinicialização. Quando você usa o Console de gerenciamento da AWS para alterar os valores dos parâmetros do cluster de banco de dados, ele sempre usa `immediate` para `ApplyMethod` para parâmetros dinâmicos. Para adiar a alteração do parâmetro até a reinicialização de um cluster de banco de dados, use a AWS CLI ou a API do RDS. Defina o `ApplyMethod` como `pending-reboot` para a alteração do parâmetro.
Para obter mais informações sobre como usar a AWS CLI para alterar um valor de parâmetro, consulte [modify-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html). Para obter mais informações sobre como usar a API do RDS para alterar um valor de parâmetro, consulte [ModifyDBClusterParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html).
## Parâmetros de conjunto de caracteres
Antes de criar uma instância de banco de dados ou um cluster de banco de dados multi-AZ, defina todos os parâmetros relacionados ao conjunto de caracteres ou ao agrupamento do seu banco de dados no grupo de parâmetros. Também faça isso antes de criar um banco de dados nele. Dessa forma, você garante que o banco de dados padrão e os novos bancos de dados usem o conjunto de caracteres e os valores de agrupamento que você especificar. Se você alterar o conjunto de caracteres ou os parâmetros de agrupamento, as alterações de parâmetros não serão aplicadas aos bancos de dados existentes.
Em mecanismos de bancos de dados, você pode alterar o conjunto de caracteres ou os valores de agrupamento para um banco de dados existente usando o comando `ALTER DATABASE`. Por exemplo:
```
ALTER DATABASE database_name CHARACTER SET character_set_name COLLATE collation;
```
Para obter mais informações sobre como alterar o conjunto de caracteres ou valores de agrupamento de um banco de dados, consulte a documentação referente ao seu mecanismo de banco de dados.
## Parâmetros e valores de parâmetros compatíveis
Para determinar os parâmetros compatíveis com seu mecanismo de banco de dados, visualize os parâmetros no grupo de parâmetros de banco de dados e no grupo de parâmetros do cluster de banco de dados utilizados pela instância ou pelo cluster de banco de dados. Para obter mais informações, consulte [Visualizar valores de parâmetros para um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Viewing.md) e [Visualizar valores de parâmetros de um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.ViewingCluster.md).
Em muitos casos, é possível especificar valores de parâmetros inteiros e boolianos usando expressões, fórmulas e funções. As funções podem incluir uma expressão matemática de log. No entanto, nem todos os parâmetros são compatíveis com expressões, fórmulas e funções para valores de parâmetros. Para obter mais informações, consulte [Especificação de parâmetros de banco de dados](USER_ParamValuesRef.md).
Definir incorretamente os parâmetros em um grupo de parâmetros pode causar efeitos adversos não intencionais, inclusive diminuição da performance e instabilidade no sistema. Sempre tenha cuidado ao modificar parâmetros de bancos de dados e faça backup dos dados antes de modificar um grupo de parâmetros. Faça testes com alterações de configuração de grupos de parâmetros em uma instância ou um cluster de banco de dados de teste antes de aplicar essas alterações de grupos de parâmetros a uma instância ou um cluster de banco de dados de produção.
# Grupos de parâmetros de banco de dados para instâncias de banco de dados do Amazon RDS
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.
**Topics**
+ [
# Criar um grupo de parâmetros de banco de dados no Amazon RDS
](USER_WorkingWithParamGroups.Creating.md)
+ [
# Associar um grupo de parâmetros de banco de dados a uma instância de banco de dados no Amazon RDS
](USER_WorkingWithParamGroups.Associating.md)
+ [
# Modificar parâmetros em um grupo de parâmetros de banco de dados no Amazon RDS
](USER_WorkingWithParamGroups.Modifying.md)
+ [
# Redefinir parâmetros em um grupo de parâmetros de banco de dados como seus valores padrão no Amazon RDS
](USER_WorkingWithParamGroups.Resetting.md)
+ [
# Copiar um grupo de parâmetros de banco de dados no Amazon RDS
](USER_WorkingWithParamGroups.Copying.md)
+ [
# Listar grupos de parâmetros de banco de dados no Amazon RDS
](USER_WorkingWithParamGroups.Listing.md)
+ [
# Visualizar valores de parâmetros para um grupo de parâmetros de banco de dados no Amazon RDS
](USER_WorkingWithParamGroups.Viewing.md)
+ [
# Excluir um grupo de parâmetros de banco de dados no Amazon RDS
](USER_WorkingWithParamGroups.Deleting.md)
# Criar um grupo de parâmetros de banco de dados no Amazon RDS
Você pode criar um novo grupo de parâmetros de banco de dados usando o Console de gerenciamento da AWS, 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 Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Parameter groups** (Grupos de parâmetros).
1. Escolha **Create parameter group (Criar grupo de parâmetros)**.
1. Em **Nome do grupo de parâmetros**, digite o nome do novo grupo de parâmetros de banco de dados.
1. Em **Descrição**, digite uma descrição para o novo grupo de parâmetros de banco de dados.
1. Em **Tipo de mecanismo**, escolha o mecanismo de banco de dados.
1. Em **Família de grupos de parâmetros**, selecione uma família de grupos de parâmetros de banco de dados.
1. Em **Tipo**, se aplicável, selecione **Grupo de parâmetros de banco de dados**.
1. Escolha **Criar**.
## AWS CLI
Para criar um grupo de parâmetros de banco de dados, use o comando AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html)da . 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.
**Example**
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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html) do RDS.
Inclua os seguintes parâmetros necessários:
+ `DBParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`
# Associar um grupo de parâmetros de banco de dados a uma instância de banco de dados no Amazon RDS
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 Console de gerenciamento da AWS, 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 no Amazon RDS](USER_WorkingWithParamGroups.Creating.md). 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](USER_CreateDBInstance.md). 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](Overview.DBInstance.Modifying.md).
**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 Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Databases (Bancos de dados)** e a instância de banco de dados que você deseja modificar.
1. Selecione **Modify**. A página **Modify DB instance (Modificar instância de banco de dados)** será exibida.
1. Altere a configuração do **grupo de parâmetros de banco de dados**.
1. Escolha **Continue** (Continuar) e verifique o resumo de modificações.
1. (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 de programação de modificações](USER_ModifyInstance.ApplyImmediately.md).
1. 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 [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) 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 de programação de modificações](USER_ModifyInstance.ApplyImmediately.md).
**Example**
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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) do RDS com os seguintes parâmetros:
+ `DBInstanceName`
+ `DBParameterGroupName`
# Modificar parâmetros em um grupo de parâmetros de banco de dados no Amazon RDS
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.
Existem dois tipos de parâmetros: dinâmicos e estáticos. As alterações em parâmetros dinâmicos são aplicadas à instância de banco de dados imediatamente sem uma reinicialização. As alterações feitas em parâmetros estáticos só serão aplicadas depois que a instância 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, 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.
![\[Cenário de reinicialização pendente para alteração de parâmetro\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/param-reboot.png)
## Console
**Como modificar os parâmetros em um grupo de parâmetros de banco de dados**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Parameter groups** (Grupos de parâmetros).
1. Na lista, selecione o grupo de parâmetros que você deseja modificar.
1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Edit (Editar)**.
1. 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.
1. Escolha **Save changes** (Salvar alterações).
## AWS CLI
Para copiar um grupo de parâmetros de banco de dados, use o comando AWS CLI[https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html) 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*.
**Example**
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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html) do RDS com os seguintes parâmetros obrigatórios:
+ `DBParameterGroupName`
+ `Parameters`
# Redefinir parâmetros em um grupo de parâmetros de banco de dados como seus valores padrão no Amazon RDS
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.
![\[Cenário de reinicialização pendente para alteração de parâmetro\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/param-reboot.png)
**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 Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, selecione **Parameter groups**.
1. Na lista, escolha o grupo de parâmetros.
1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Edit (Editar)**.
1. 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.
1. 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 [https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html) 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.
**Example**
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*.
**Example**
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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html) 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 no Amazon RDS
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 Console de gerenciamento da AWS. Também é possível usar o comando [copy-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html) da AWS CLI ou a operação da API [CopyDBParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html) 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](https://console.aws.amazon.com/rds/) ou o comando [describe-db-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) 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 Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, selecione **Parameter groups**.
1. Na lista, escolha o grupo de parâmetros personalizado que você deseja copiar.
1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Copy (Copiar)**.
1. 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.
1. Em **Description (Descrição)**, digite uma descrição para o novo grupo de parâmetros.
1. Escolha **Copiar**.
## AWS CLI
Para copiar um grupo de parâmetros de banco de dados, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html) 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`.
**Example**
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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html) com os seguintes parâmetros obrigatórios:
+ `SourceDBParameterGroupIdentifier`
+ `TargetDBParameterGroupIdentifier`
+ `TargetDBParameterGroupDescription`
# Listar grupos de parâmetros de banco de dados no Amazon RDS
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 Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. 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](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameter-groups.html) da `describe-db-parameter-groups`.
**Example**
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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameterGroups.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameterGroups.html).
# Visualizar valores de parâmetros para um grupo de parâmetros de banco de dados no Amazon RDS
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 Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, selecione **Parameter groups**.
Os grupos de parâmetros de banco de dados aparecem em uma lista.
1. 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](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) da `describe-db-parameters` com o seguinte parâmetro obrigatório.
+ `--db-parameter-group-name`
**Example**
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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) da API do RDS com o seguinte parâmetro necessário.
+ `DBParameterGroupName`
# Excluir um grupo de parâmetros de banco de dados no Amazon RDS
É possível excluir um grupo de parâmetros de banco de dados usando o Console de gerenciamento da AWS, 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 Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, selecione **Parameter groups**.
Os grupos de parâmetros de banco de dados aparecem em uma lista.
1. Escolha o nome dos grupos de parâmetros a serem excluídos.
1. Escolha **Ações** e então **Excluir**.
1. 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 [https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-parameter-group.html) da AWS CLI com o parâmetro exigido a seguir.
+ `--db-parameter-group-name`
**Example**
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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBParameterGroup.html) da API do RDS com o parâmetro exigido a seguir.
+ `DBParameterGroupName`
# 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.
**Topics**
+ [
# Criar um grupo de parâmetros de cluster de banco de dados
](USER_WorkingWithParamGroups.CreatingCluster.md)
+ [
# Modificar parâmetros em um grupo de parâmetros de cluster de banco de dados
](USER_WorkingWithParamGroups.ModifyingCluster.md)
+ [
# Redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados
](USER_WorkingWithParamGroups.ResettingCluster.md)
+ [
# Copiar um grupo de parâmetros de cluster de banco de dados
](USER_WorkingWithParamGroups.CopyingCluster.md)
+ [
# Listar grupos de parâmetros de cluster de banco de dados
](USER_WorkingWithParamGroups.ListingCluster.md)
+ [
# Visualizar valores de parâmetros de um grupo de parâmetros de cluster de banco de dados
](USER_WorkingWithParamGroups.ViewingCluster.md)
+ [
# Excluir um grupo de parâmetros de cluster de banco de dados
](USER_WorkingWithParamGroups.DeletingCluster.md)
# 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 Console de gerenciamento da AWS, 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](https://console.aws.amazon.com/rds/) ou o comando [describe-db-cluster-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) 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.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 Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Parameter groups** (Grupos de parâmetros).
1. Escolha **Criar grupo de parâmetros**.
1. Em **Nome do grupo de parâmetros**, insira o nome do novo grupo de parâmetros do cluster de banco de dados.
1. Em **Descrição**, insira uma descrição para o novo grupo de parâmetros do cluster de banco de dados.
1. Em **Tipo de mecanismo**, escolha o mecanismo de banco de dados.
1. Em **Família de grupos de parâmetros**, selecione uma família de grupos de parâmetros de banco de dados.
1. Escolha **Criar**.
## AWS CLI
Para criar um grupo de parâmetros de cluster de banco de dados, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-parameter-group.html).
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.
**Example**
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"
}
}
```
## API do RDS
Para criar um grupo de parâmetros de cluster de banco de dados, use a ação da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterParameterGroup.html).
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.
## Console
**Para modificar um grupo de parâmetros de cluster de banco de dados**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, selecione **Parameter groups**.
1. Na lista, escolha o grupo de parâmetros que você deseja modificar.
1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Edit (Editar)**.
1. 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.
1. Selecione **Save changes**.
1. Reinicialize a cluster para aplicar as alterações a ela.
Se você não o cluster, uma operação de failover poderá levar mais tempo do que o normal.
## AWS CLI
Para modificar um grupo de parâmetros de cluster de banco de dados, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html) 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*.
**Example**
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
```
## API do RDS
Para modificar um grupo de parâmetros de cluster de banco de dados, use o comando da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html) com os seguintes parâmetros obrigatórios:
+ `DBClusterParameterGroupName`
+ `Parameters`
# 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.
## Console
**Para redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados para seus valores padrão**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, selecione **Parameter groups**.
1. Na lista, escolha o grupo de parâmetros.
1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Edit (Editar)**.
1. 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.
1. Escolha **Reset (Redefinir)** e, em seguida, confirme escolhendo **Reset parameters (Redefinir parâmetros)**.
1. Reinicialize a cluster do banco de dados.
## AWS CLI
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 [https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-cluster-parameter-group.html) 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.
**Example**
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*.
**Example**
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
```
## API do RDS
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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBClusterParameterGroup.html) 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](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) ou a operação da API do RDS [CopyDBClusterParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html).
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](https://console.aws.amazon.com/rds/) ou o comando [describe-db-cluster-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) 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.
## Console
**Para copiar um grupo de parâmetros de cluster de banco de dados**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, selecione **Parameter groups**.
1. Na lista, escolha o grupo de parâmetros personalizado que você deseja copiar.
1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Copy (Copiar)**.
1. 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.
1. Em **Description (Descrição)**, digite uma descrição para o novo grupo de parâmetros.
1. Escolha **Copiar**.
## AWS CLI
Para copiar um grupo de parâmetros de cluster de banco de dados, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) 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`.
**Example**
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"
```
## API do RDS
Para copiar um grupo de parâmetros de cluster de banco de dados, use a operação da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterParameterGroup.html) com os seguintes parâmetros obrigatórios:
+ `SourceDBClusterParameterGroupIdentifier`
+ `TargetDBClusterParameterGroupIdentifier`
+ `TargetDBClusterParameterGroupDescription`
# Listar 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.
## Console
**Para listar todos os grupos de parâmetros do cluster de banco de dados para uma conta da AWS**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. 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)**.
## AWS CLI
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 [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusterparameter-groups.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusterparameter-groups.html).
**Example**
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"
}
]
}
```
## API do RDS
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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterParameterGroups.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterParameterGroups.html).
# Visualizar valores de parâmetros de um grupo de parâmetros de 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.
## Console
**Para visualizar os valores de parâmetros para um grupo de parâmetros de cluster de banco de dados**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. 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)**.
1. Escolha o nome do grupo de parâmetros de cluster de banco de dados para ver sua lista de parâmetros.
## AWS CLI
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 [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) com o parâmetro obrigatório a seguir.
+ `--db-cluster-parameter-group-name`
**Example**
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"
]
},
...
```
## API do RDS
Para visualizar os valores de parâmetros para um grupo de parâmetros de cluster de banco de dados, use o comando [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) 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 de banco de dados
É possível excluir um grupo de parâmetros de cluster de banco de dados usando o Console de gerenciamento da AWS, 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.
## Console
**Para excluir um grupo de parâmetros**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Parameter groups** (Grupos de parâmetros).
Os grupos de parâmetros aparecem em uma lista.
1. Escolha o nome dos grupos de parâmetros do cluster de banco de dados a serem excluídos.
1. Escolha **Ações** e então **Excluir**.
1. Revise os nomes dos grupos de parâmetros e escolha **Excluir**.
## AWS CLI
Para excluir um grupo de parâmetros de cluster de banco de dados, use o comando [https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-parameter-group.html) da AWS CLI com os parâmetros obrigatórios a seguir.
+ `--db-parameter-group-name`
**Example**
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
```
## API do RDS
Para excluir um grupo de parâmetros de cluster de banco de dados, use o comando [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterParameterGroup.html) da API do RDS com os parâmetros obrigatórios a seguir.
+ `DBParameterGroupName`
# Comparação de grupos de parâmetros de banco de dados
É possível usar o Console de gerenciamento da AWS para visualizar as diferenças entre dois grupos de parâmetros de banco de dados.
Os grupos de parâmetros especificados devem ser grupos de parâmetros de banco de dados ou devem ser grupos de parâmetros de cluster de banco de dados. Isso se aplica mesmo se o mecanismo de banco de dados e a versão forem os mesmos. Por exemplo, não é possível comparar um grupo de parâmetros do banco de dados do `aurora-mysql8.0` (Aurora MySQL versão 3) e um grupo de parâmetros do cluster de banco de dados do `aurora-mysql8.0`.
Você pode comparar grupos de parâmetros de banco de dados do Aurora MySQL e do RDS para MySQL, mesmo para versões diferentes, mas não pode comparar grupos de parâmetros de banco de dados do Aurora PostgreSQL e do RDS para PostgreSQL.
**Para comparar dois grupos de parâmetros de banco de dados**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, selecione **Parameter groups**.
1. Na lista, escolha os dois grupos de parâmetros que você deseja comparar.
**nota**
Para comparar um grupo de parâmetros padrão com um grupo de parâmetros personalizado, primeiro escolha o grupo de parâmetros padrão na guia **Padrão** e, depois, selecione o grupo de parâmetros personalizado na guia **Personalizado**.
1. Em **Ações**, selecione **Comparar**.
# Especificação de parâmetros de banco de dados
Os tipos de parâmetros de banco de dados incluem os seguintes:
+ Inteiro
+ Booliano
+ String
+ Longo
+ Double
+ Timestamp
+ Objeto de outros tipos de dados definidos
+ Matriz de valores do tipo integer, boolean, string, long, double, timestamp ou object
Você também pode especificar parâmetros inteiros e booleanos usando expressões, fórmulas e funções.
Para o mecanismo do Oracle, você pode usar a variável de fórmula `DBInstanceClassHugePagesDefault` para especificar um parâmetro de banco de dados booleano. Consulte [Variáveis de fórmulas de parâmetros de banco de dados](#USER_FormulaVariables).
Para o mecanismo do PostgreSQL, você pode usar uma expressão para especificar um parâmetro de banco de dados booleano. Consulte [Expressões de parâmetro de banco de dados booleanas](#USER_ParamBooleanExpressions).
**Contents**
+ [
## Fórmulas de parâmetros de banco de dados
](#USER_ParamFormulas)
+ [
### Variáveis de fórmulas de parâmetros de banco de dados
](#USER_FormulaVariables)
+ [
### Operadores de fórmulas de parâmetros de banco de dados
](#USER_FormulaOperators)
+ [
## Funções de parâmetros de banco de dados
](#USER_ParamFunctions)
+ [
## Expressões de parâmetro de banco de dados booleanas
](#USER_ParamBooleanExpressions)
+ [
## Expressões de log de parâmetros de banco de dados
](#USER_ParamLogExpressions)
+ [
## Exemplos de valores de parâmetros de banco de dados
](#USER_ParamValueExamples)
## Fórmulas de parâmetros de banco de dados
Uma fórmula de parâmetro de banco de dados é uma expressão resolvida como um valor inteiro ou booliano. A expressão é delimitada por chaves: \$1\$1. você pode usar uma fórmula para um valor de parâmetro de banco de dados ou como um argumento para uma função de parâmetro de banco de dados.
**Sintaxe**
```
{FormulaVariable}
{FormulaVariable*Integer}
{FormulaVariable*Integer/Integer}
{FormulaVariable/Integer}
```
### Variáveis de fórmulas de parâmetros de banco de dados
Cada variável de fórmula retorna um inteiro ou um valor booliano. Os nomes das variáveis diferenciam maiúsculas de minúsculas.
*AllocatedStorage*
Retorna um inteiro que representa o tamanho, em bytes, do volume de dados.
*DBInstanceClassHugePagesDefault*
Retorna um valor Booliano. Atualmente, é compatível apenas com os mecanismos do Oracle.
Para obter mais informações, consulte [Ativar o HugePages para uma instância do RDS para Oracle](Oracle.Concepts.HugePages.md).
*DBInstanceClassMemory*
Retorna um número inteiro para o número de bytes de memória disponíveis para o processo do banco de dados. Esse número é calculado internamente começando com a quantidade total de memória para a classe de instância de banco de dados. A partir disso, o cálculo subtrai a memória reservada para o sistema operacional e os processos do RDS que gerenciam a instância. Portanto, o número é sempre um pouco menor do que as figuras de memória mostradas nas tabelas de classe de instância em [Classes de instâncias de banco de dados do ](Concepts.DBInstanceClass.md). O valor exato depende de uma combinação de fatores. São eles classe de instância, mecanismo de banco de dados e se ele se aplica a uma instância do RDS ou a uma instância que faça parte de um cluster do Aurora.
*DBInstanceVCPU*
Retorna um número inteiro representando a quantidade de unidades de processamento centrais virtuais (vCPUs) usadas pelo Amazon RDS para gerenciar a instância.
*EndPointPort*
Retorna um inteiro representando a porta usada ao se conectar à instância de banco de dados.
*Réplica TrueIF*
Retorna `1` se a instância de banco de dados é uma réplica de leitura e `0` se não é. Esse é o valor padrão do `read_only` parâmetro no .
### Operadores de fórmulas de parâmetros de banco de dados
Fórmulas de parâmetros de banco de dados que oferecem suporte a dois operadores: divisão e multiplicação.
*Operador de divisão: /*
Divide o dividendo pelo divisor, retornando um quociente inteiro. Casas decimais no quociente são truncadas, não arredondadas.
Sintaxe
```
dividend / divisor
```
Os argumentos de dividendo e divisor devem ser expressões de inteiros.
*Operador de multiplicação: \$1*
Multiplica as expressões, retornando seu produto. As casas decimais nas expressões são truncadas, e não arredondadas.
Sintaxe
```
expression * expression
```
Ambas as expressões devem ser números inteiros.
## Funções de parâmetros de banco de dados
Você especifica os argumentos das funções de parâmetro de banco de dados como inteiros ou fórmulas. Cada função deve ter pelo menos um argumento. Especifique vários argumentos como uma lista separada por vírgulas. A lista não pode ter membros vazios, como *argument1*,,*argument3*. Nomes de função não diferenciam maiúsculas de minúsculas.
*IF*
Retorna um argumento.
Atualmente, é compatível apenas com mecanismos do Oracle e o único primeiro argumento compatível é `{DBInstanceClassHugePagesDefault}`. Para obter mais informações, consulte [Ativar o HugePages para uma instância do RDS para Oracle](Oracle.Concepts.HugePages.md).
Sintaxe
```
IF(argument1, argument2, argument3)
```
Retorna o segundo argumento se o primeiro argumento é avaliado como verdadeiro. Retorna o terceiro argumento, caso contrário.
*GREATEST*
Retorna o maior valor de uma lista de números inteiros ou fórmulas de parâmetros.
Sintaxe
```
GREATEST(argument1, argument2,...argumentn)
```
Retorna um número inteiro.
*LEAST*
Retorna o menor valor de uma lista de números inteiros ou fórmulas de parâmetros.
Sintaxe
```
LEAST(argument1, argument2,...argumentn)
```
Retorna um número inteiro.
*SUM*
Adiciona os valores dos números inteiros ou fórmulas de parâmetros especificados.
Sintaxe
```
SUM(argument1, argument2,...argumentn)
```
Retorna um número inteiro.
## Expressões de parâmetro de banco de dados booleanas
Uma expressão de parâmetro de banco de dados booleana é resolvida como um valor booleano de 1 ou 0. A expressão é delimitada por aspas.
**nota**
Expressões de parâmetro de banco de dados booleanas são compatíveis apenas com o mecanismo do PostgreSQL.
**Sintaxe**
```
"expression operator expression"
```
Ambas as expressões devem ser resolvidas como inteiros. Uma expressão pode ser a seguinte:
+ Uma constante de inteiro
+ Fórmula de parâmetros de banco de dados
+ Função de parâmetros de banco de dados
+ Variável de parâmetro de banco de dados
As expressões de parâmetro de banco de dados booleanas suportam os seguintes operadores de desigualdade:
*O operador maior que: >*
Sintaxe
```
"expression > expression"
```
*O operador menor que: <*
Sintaxe
```
"expression < expression"
```
* Os operadores maior que ou igual a: >=, =>*
Sintaxe
```
"expression >= expression"
"expression => expression"
```
*Os operadores menor que ou igual a: <=, =<*
Sintaxe
```
"expression <= expression"
"expression =< expression"
```
**Example usando uma expressão de parâmetro de banco de dados booleana**
O seguinte exemplo de expressão de parâmetro de banco de dados booliana compara o resultado de uma fórmula de parâmetro com um valor inteiro. Ele faz isso para modificar o parâmetro de banco de dados booliano `wal_compression` para uma instância de banco de dados do PostgreSQL. A expressão do parâmetro compara o número de vCPUs com o valor 2. Se o número de vCPUs for maior que 2, então o parâmetro de banco de dados `wal_compression` é definido como true (verdadeiro).
```
aws rds modify-db-parameter-group --db-parameter-group-name group-name \
--parameters "ParameterName=wal_compression,ParameterValue=\"{DBInstanceVCPU} > 2\" "
```
## Expressões de log de parâmetros de banco de dados
Você pode definir um valor de parâmetro de banco de dados inteiro como uma expressão de log. A expressão é delimitada por chaves: \$1\$1. Por exemplo:
```
{log(DBInstanceClassMemory/8187281418)*1000}
```
A função `log` representa a base de log 2. Esse exemplo também usa a variável de fórmula `DBInstanceClassMemory`. Consulte [Variáveis de fórmulas de parâmetros de banco de dados](#USER_FormulaVariables).
**nota**
Atualmente, você não pode especificar o parâmetro `innodb_log_file_size` do MySQL com qualquer valor diferente de um inteiro.
## Exemplos de valores de parâmetros de banco de dados
Esses exemplos mostram o uso de fórmulas, funções e expressões para os valores de parâmetros de banco de dados.
**Atenção**
Definir parâmetros indevidamente em um grupo de parâmetros de banco de dados pode ter efeitos adversos não intencionais. Estes podem incluir performance degradada e instabilidade do sistema. Sempre tenha cuidado ao modificar os parâmetros do banco de dados e faça backup dos seus dados antes de modificar seu grupo de parâmetros de banco de dados. Faça testes com alterações de grupos de parâmetros em instâncias de bancos de dados de teste, criadas usando restaurações pontuais, antes de aplicar essas alterações às suas instâncias de banco de dados de produção.
**Example uso da função de parâmetros de banco de dados GREATEST (Maior)**
Você pode especificar a função `GREATEST` em um parâmetro de processos do Oracle. Use-a para definir a quantidade de processos do usuário para o maior entre 80 ou `DBInstanceClassMemory` dividido por 9.868.951.
```
GREATEST({DBInstanceClassMemory/9868951},80)
```
**Example uso da função de parâmetro de banco de dados LEAST (Menor)**
Você pode especificar a função `LEAST` em um valor do parâmetro MySQL `max_binlog_cache_size`. Use-a para definir o tamanho máximo de cache que uma transação pode usar em uma instância MySQL para o menor entre 1 MB ou `DBInstanceClass`/256.
```
LEAST({DBInstanceClassMemory/256},10485760)
```