# Grupos de parâmetros do cluster de banco de dados para clusters de banco de dados do Amazon Aurora
Clusters de banco de dados Amazon Aurora 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**
+ [Parâmetros do cluster de banco de dados e da instância de bancos de dados Amazon Aurora](#Aurora.Managing.ParameterGroups)
+ [Criar um grupo de parâmetros de cluster de banco de dadosno Amazon Aurora](USER_WorkingWithParamGroups.CreatingCluster.md)
+ [Associar um grupo de parâmetros de cluster de banco de dados a um cluster de banco de dados no Amazon Aurora](USER_WorkingWithParamGroups.AssociatingCluster.md)
+ [Modificar parâmetros em um grupo de parâmetros de cluster de banco de dadosno Amazon Aurora](USER_WorkingWithParamGroups.ModifyingCluster.md)
+ [Redefinir parâmetros em um grupo de parâmetros de cluster de banco de dadosno Amazon Aurora](USER_WorkingWithParamGroups.ResettingCluster.md)
+ [Copiar um grupo de parâmetros de cluster de banco de dadosno Amazon Aurora](USER_WorkingWithParamGroups.CopyingCluster.md)
+ [Listar grupos de parâmetros de cluster de banco de dadosno Amazon Aurora](USER_WorkingWithParamGroups.ListingCluster.md)
+ [Visualizar valores de parâmetros de um grupo de parâmetros de cluster de banco de dadosno Amazon Aurora](USER_WorkingWithParamGroups.ViewingCluster.md)
+ [Excluir um grupo de parâmetros de cluster de banco de dadosno Amazon Aurora](USER_WorkingWithParamGroups.DeletingCluster.md)
## Parâmetros do cluster de banco de dados e da instância de bancos de dados Amazon Aurora
O Aurora usa um sistema de configurações de dois níveis:
+ Os parâmetros em um *grupo de parâmetros de cluster de banco de dados* aplicam-se a cada instância de banco de dados em um cluster de banco de dados. Seus dados são armazenados no subsistema de armazenamento compartilhado do Aurora. Por causa disso, todos os parâmetros relacionados ao layout físico de dados de tabelas devem ser os mesmos para todas as instâncias de banco de dados em um cluster do Aurora. Da mesma forma, como as instâncias de bancos de dados do Aurora são conectadas por replicação, todos os parâmetros para configurações de replicação devem ser idênticos por todo um cluster do Aurora.
+ Os parâmetros em um *grupo de parâmetros de banco de dados* aplicam-se a uma única instância de banco de dados em um cluster de bancos de dados Aurora. Esses parâmetros estão relacionados a aspectos como o uso da memória, que você pode variar entre instâncias de bancos de dados no mesmo cluster do Aurora. Por exemplo, um cluster geralmente contém instâncias de banco de dados com diferentes classes de instância da AWS.
Cada cluster do Aurora é associado a um grupo de parâmetros de cluster de banco de dados. Esse grupo de parâmetros atribui valores padrão para cada valor de configuração para o mecanismo de banco de dados correspondente. O grupo de parâmetros de cluster também inclui valores padrão para os parâmetros em nível de instância e de cluster. Cada instância de banco de dados em um cluster provisionado ou do Aurora Serverless v2 herda as configurações desse grupo de parâmetros de cluster de banco de dados.
Cada instância de banco de dados também é associada a um grupo de parâmetros de banco de dados. Os valores no grupo de parâmetros de banco de dados podem substituir os valores padrão do grupo de parâmetros do cluster. Por exemplo, se uma instância em um cluster tiver problemas, você poderá atribuir um grupo de parâmetros de banco de dados personalizado a essa instância. O grupo de parâmetros personalizado pode ter configurações específicas para parâmetros relacionados à depuração ou ao ajuste de performance.
O Aurora atribui grupos de parâmetros padrão quando você cria um cluster ou uma nova instância de banco de dados, com base no mecanismo de banco de dados e na versão especificados. Em vez disso, você pode especificar grupos de parâmetros personalizados. Você mesmo cria esses grupos de parâmetros e pode editar os valores dos parâmetros. Você pode especificar esses grupos de parâmetros personalizados no momento da criação. Também é possível modificar um cluster de banco de dados ou instância posteriormente para usar um grupo de parâmetros personalizado.
Para instâncias do Aurora Serverless v2 e provisionadas, quaisquer valores de configuração que você modificar no grupo de parâmetros de cluster de banco de dados substituirão os valores padrão no grupo de parâmetros de banco de dados. Se você editar os valores correspondentes no grupo de parâmetros de banco de dados, eles substituirão as configurações do grupo de parâmetros de cluster de banco de dados.
Qualquer configuração de parâmetro de banco de dados que você modificar terá precedência sobre os valores do grupo de parâmetros de cluster de banco de dados, mesmo que você altere os parâmetros de configuração de volta para seus valores padrão. É possível ver quais parâmetros são substituídos usando o comando [describe-db-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) AWS CLI ou a operação [DescribeDBParameters](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) da API do RDS. O campo `Source` conterá o valor `user` se você tiver modificado esse parâmetro. Para redefinir um ou mais parâmetros de forma que o valor do grupo de parâmetros de cluster de banco de dados tenha precedência, use o comando [reset-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html) AWS CLI ou a operação [ResetDBParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html) da API do RDS.
Os parâmetros do cluster e da instância de banco de dados disponíveis no Aurora variam de acordo com a compatibilidade do mecanismo de banco de dados.
| Mecanismo do banco de dados | Parâmetros |
| --- | --- |
| Aurora MySQL | Consulte [Parâmetros de configuração do Aurora MySQL](AuroraMySQL.Reference.ParameterGroups.md). Para clusters do Aurora Serverless, consulte detalhes adicionais em [Trabalhar com grupos de parâmetros para o Aurora Serverless v2](aurora-serverless-v2.setting-capacity.md#aurora-serverless-v2.parameter-groups) e [Grupos de parâmetros para Aurora Serverless v1](aurora-serverless-v1.how-it-works.md#aurora-serverless.parameter-groups). |
| Aurora PostgreSQL | Consulte [Amazon Aurora PostgreSQL parameters](AuroraPostgreSQL.Reference.ParameterGroups.md). Para clusters do Aurora Serverless, consulte detalhes adicionais em [Trabalhar com grupos de parâmetros para o Aurora Serverless v2](aurora-serverless-v2.setting-capacity.md#aurora-serverless-v2.parameter-groups) e [Grupos de parâmetros para Aurora Serverless v1](aurora-serverless-v1.how-it-works.md#aurora-serverless.parameter-groups). |
**nota**
Aurora Serverless v1Os clusters do têm apenas grupos de parâmetros de cluster de banco de dados associados, não grupos de parâmetros de banco de dados. Para clusters do Aurora Serverless v2, você faz todas as alterações nos parâmetros personalizados no grupo de parâmetros de cluster de banco de dados.
Aurora Serverless v2O usa grupos de parâmetros de cluster de banco de dados e grupos de parâmetros de banco de dados Com o Aurora Serverless v2, você pode modificar quase todos os parâmetros de configuração. O Aurora Serverless v2 substitui as configurações de alguns parâmetros de configuração relacionados à capacidade para que sua workload não seja interrompida quando houver redução de escala vertical das instâncias do Aurora Serverless v2.
Para saber mais sobre as definições de configuração do Aurora Serverless e quais configurações você pode modificar, consulte [Trabalhar com grupos de parâmetros para o Aurora Serverless v2](aurora-serverless-v2.setting-capacity.md#aurora-serverless-v2.parameter-groups) e [Grupos de parâmetros para Aurora Serverless v1](aurora-serverless-v1.how-it-works.md#aurora-serverless.parameter-groups).
# Criar um grupo de parâmetros de cluster de banco de dadosno Amazon Aurora
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.aurora-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 Aurora MySQL versão 5.7 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 aurora-mysql5.7 \
--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 aurora-mysql5.7 ^
--description "My new cluster parameter group"
```
O comando gerará uma saída semelhante à seguinte:
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupName": "mydbclusterparametergroup",
"DBParameterGroupFamily": "aurora-mysql5.7",
"Description": "My new cluster parameter group",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
}
}
```
## 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`
# Associar um grupo de parâmetros de cluster de banco de dados a um cluster de banco de dados no Amazon Aurora
Você pode criar seus próprios grupos de parâmetros de cluster de banco de dados com configurações personalizadas. Você pode associar um grupo de parâmetros de cluster de banco de dados a um cluster de banco de dados usando o Console de gerenciamento da AWS ou a API RDSAWS CLI. Você pode fazer isso ao criar ou modificar um cluster de banco de dados.
Para obter informações sobre como criar um grupo de parâmetros de cluster de banco de dados, consulte [Criar um grupo de parâmetros de cluster de banco de dadosno Amazon Aurora](USER_WorkingWithParamGroups.CreatingCluster.md). Para obter informações sobre como criar um cluster de banco de dados, consulte [Criar um cluster de bancos de dados do Amazon Aurora](Aurora.CreateInstance.md). Para obter informações sobre como modificar um cluster de banco de dados, consulte [Modificar um cluster de bancos de dados Amazon Aurora](Aurora.Modifying.md).
**nota**
Para o Aurora PostgreSQL 15.2, 14.7, 13.10, 12.14 e todas as versões 11, ao alterar o grupo de parâmetros de cluster de banco de dados associado a um cluster de banco de dados, reinicialize cada instância de réplica para aplicar as alterações.
Para determinar se a instância de banco de dados principal de um cluster de banco de dados deve ser reinicializada para aplicar alterações, execute o seguinte comando AWS CLI:
`aws rds describe-db-clusters --db-cluster-identifier db_cluster_identifier`
Verifique o valor `DBClusterParameterGroupStatus` da instância do banco de dados primário na saída. Se o valor for `pending-reboot`, reinicie a instância de banco de dados principal do cluster de banco de dados.
## Console
**Para associar um grupo de parâmetros de cluster de banco de dados a um 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 **Databases (Bancos de dados)** e escolha o cluster de banco de dados que você deseja modificar.
1. Escolha **Modify** (Modificar). A página **Modify DB cluster (Modificar cluster de banco de dados)** é exibida.
1. Altere a configuração do **grupo de parâmetros do cluster de banco de dados**.
1. Escolha **Continue** (Continuar) e verifique o resumo de modificações.
A alteração é aplicada imediatamente, independentemente da configuração **Agendamento de modificações**.
1. Na página de confirmação, revise suas alterações. Se estiverem corretas, escolha **Modify cluster (Modificar cluster)** para salvar as alterações.
Como alternativa, escolha **Back (Voltar)** para editar suas alterações ou escolha **Cancel (Cancelar)** para cancelar as alterações.
## AWS CLI
Para associar um grupo de parâmetros de cluster de banco de dados a um cluster de banco de dados, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) com as seguintes opções:
+ `--db-cluster-name`
+ `--db-cluster-parameter-group-name`
O exemplo a seguir associa o `mydbclpg` grupo de parâmetros de banco de dados ao cluster de banco de dados`mydbcluster`.
**Example**
Para Linux, macOS ou Unix:
```
aws rds modify-db-cluster \
--db-cluster-identifier mydbcluster \
--db-cluster-parameter-group-name mydbclpg
```
Para Windows:
```
aws rds modify-db-cluster ^
--db-cluster-identifier mydbcluster ^
--db-cluster-parameter-group-name mydbclpg
```
## API do RDS
Para associar um grupo de parâmetros de cluster de banco de dados a um cluster de banco de dados, use a operação da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) com os seguintes parâmetros:
+ `DBClusterIdentifier`
+ `DBClusterParameterGroupName`
# Modificar parâmetros em um grupo de parâmetros de cluster de banco de dadosno Amazon Aurora
É 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 instância de banco de dados primária (de gravador) no cluster para aplicar as alterações a ela.
1. Depois, reinicialize as instâncias de banco de dados de leitor para aplicar as alterações a elas.
Se você não reiniciar as instâncias de banco de dados, 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 dadosno Amazon Aurora
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 instância de banco de dados primária no cluster de banco de dados para aplicar as alterações a todas as instâncias de banco de dados no 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 dadosno Amazon Aurora
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 dadosno Amazon Aurora
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": "mydbclusterparametergroup",
"DBParameterGroupFamily": "aurora-mysql5.7",
"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 dadosno Amazon Aurora
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": "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"
]
},
{
"ParameterName": "aurora_binlog_read_buffer_size",
"ParameterValue": "5242880",
"Description": "Read buffer size used by master dump thread when the switch aurora_binlog_use_large_read_buffer is ON.",
"Source": "engine-default",
"ApplyType": "dynamic",
"DataType": "integer",
"AllowedValues": "8192-536870912",
"IsModifiable": true,
"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 dadosno Amazon Aurora
É 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`