

# Grupos de parâmetros de banco de dados para instâncias de banco de dados do Amazon RDS
<a name="USER_WorkingWithDBInstanceParamGroups"></a>

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
<a name="USER_WorkingWithParamGroups.Creating"></a>

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
<a name="USER_WorkingWithParamGroups.Creating.CON"></a>

**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
<a name="USER_WorkingWithParamGroups.Creating.CLI"></a>

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
<a name="USER_WorkingWithParamGroups.Creating.API"></a>

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
<a name="USER_WorkingWithParamGroups.Associating"></a>

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
<a name="USER_WorkingWithParamGroups.Associating.CON"></a>

**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
<a name="USER_WorkingWithParamGroups.Associating.CLI"></a>

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
<a name="USER_WorkingWithParamGroups.Associating.API"></a>

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
<a name="USER_WorkingWithParamGroups.Modifying"></a>

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
<a name="USER_WorkingWithParamGroups.Modifying.CON"></a>

**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
<a name="USER_WorkingWithParamGroups.Modifying.CLI"></a>

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
<a name="USER_WorkingWithParamGroups.Modifying.API"></a>

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
<a name="USER_WorkingWithParamGroups.Resetting"></a>

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
<a name="USER_WorkingWithParamGroups.Resetting.CON"></a>

**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
<a name="USER_WorkingWithParamGroups.Resetting.CLI"></a>

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
<a name="USER_WorkingWithParamGroups.Resetting.API"></a>

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
<a name="USER_WorkingWithParamGroups.Copying"></a>

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
<a name="USER_WorkingWithParamGroups.Copying.CON"></a>

**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
<a name="USER_WorkingWithParamGroups.Copying.CLI"></a>

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
<a name="USER_WorkingWithParamGroups.Copying.API"></a>

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
<a name="USER_WorkingWithParamGroups.Listing"></a>

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
<a name="USER_WorkingWithParamGroups.Listing.CON"></a>

**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
<a name="USER_WorkingWithParamGroups.Listing.CLI"></a>

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
<a name="USER_WorkingWithParamGroups.Listing.API"></a>

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
<a name="USER_WorkingWithParamGroups.Viewing"></a>

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

## Console
<a name="USER_WorkingWithParamGroups.Viewing.CON"></a>

**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
<a name="USER_WorkingWithParamGroups.Viewing.CLI"></a>

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
<a name="USER_WorkingWithParamGroups.Viewing.API"></a>

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
<a name="USER_WorkingWithParamGroups.Deleting"></a>

É 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
<a name="USER_WorkingWithParamGroups.Deleting.CON"></a>

**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
<a name="USER_WorkingWithParamGroups.Deleting.CLI"></a>

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
<a name="USER_WorkingWithParamGroups.Deleting.API"></a>

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`