# 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`