# Grupos de parâmetros para Amazon Aurora *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 Aurora com grupos de parâmetros. O Aurora 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. **Topics** + [ # Visão geral dos grupos de parâmetros ](parameter-groups-overview.md) + [ # Grupos de parâmetros do cluster de banco de dados para clusters de banco de dados do Amazon Aurora ](USER_WorkingWithDBClusterParamGroups.md) + [ # Grupos de parâmetros de banco de dados para instâncias de banco de dados do Amazon Aurora ](USER_WorkingWithDBInstanceParamGroups.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 cluster de banco de dados* atua como um contêiner de valores de configuração de mecanismo que se aplicam a cada instância de banco de dados em um cluster de bancos de dados do Aurora. Por exemplo, o modelo de armazenamento compartilhado do Aurora requer que cada instância de banco de dados em m um cluster do Aurora use a mesma configuração de parâmetros, como `innodb_file_per_table`. Dessa forma, os parâmetros que afetam o layout de armazenamento físico fazem parte do grupo de parâmetros do cluster. O grupo de parâmetros de cluster de banco de dados também inclui valores padrão para todos os parâmetros em nível de instância. 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 banco de dados aplicam-se a instâncias de banco de dados no Amazon RDS e no Aurora. Essas definições de configuração aplicam-se a propriedades que podem variar entre as instâncias de banco de dados em um cluster do Aurora, como os tamanhos dos buffers de memória. **Topics** + [ ## Grupos de parâmetros padrão e personalizados ](#parameter-groups-overview.custom) + [ ## Parâmetros estáticos e dinâmicos de cluster de banco de dados ](#parameter-groups-overview.db-cluster) + [ ## Parâmetros estáticos e dinâmicos de instância de banco de dados ](#parameter-groups-overview.db-instance) + [ ## 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 Aurora 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. Para obter informações sobre como modificar um cluster de banco de dados ou uma instância de banco de dados, consulte [Modificar um cluster de bancos de dados Amazon Aurora](Aurora.Modifying.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 um cluster de bancos de dados Amazon Aurora](Aurora.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 do Aurora, 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 existente em um novo grupo de parâmetros. ## 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 de cluster de banco de dados, a alteração entra em vigor depois que você reinicializa manualmente as instâncias de banco de dados em cada cluster de banco de dados associado. Quando você usa o Console de gerenciamento da AWS para alterar os valores dos parâmetros estáticos do cluster de banco de dados, ele sempre usa `pending-reboot` para `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, ele sempre usa `immediate` para `ApplyMethod`. Para adiar a alteração do parâmetro até a finalização da reinicialização das instâncias de banco de dados em um cluster de banco de dados associado, 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). Se você alterar o grupo de parâmetros de cluster de banco de dados associado a um cluster de banco de dados, reinicialize as instâncias de banco de dados no cluster. A reinicialização aplica as alterações a todas as instâncias de banco de dados no cluster de banco de dados. Para determinar se as instâncias de banco de dados de um cluster de banco de dados deve ser reinicializada para as alterações serem aplicadas, execute o comando da AWS CLI a seguir. `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`, reinicialize as instâncias de banco de dados do cluster 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. 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 de conjunto de caracteres Antes de criar um cluster de banco de dados, 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 Aurora](USER_WorkingWithParamGroups.Viewing.md) e [Visualizar valores de parâmetros de um grupo de parâmetros de cluster de banco de dadosno Amazon Aurora](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). Para um banco de dados global Aurora, especifique definições de configuração diferentes para os clusters do Aurora individuais. Verifique se as configurações são suficientemente semelhantes para produzir um comportamento consistente caso você promova um cluster secundário para ser o cluster primário. Por exemplo, use as mesmas configurações para os fusos horários e os conjuntos de caracteres em todos os clusters de um banco de dados global Aurora. 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 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` # Grupos de parâmetros de banco de dados para instâncias de banco de dados do Amazon Aurora 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 Aurora ](USER_WorkingWithParamGroups.Creating.md) + [ # Associar um grupo de parâmetros de banco de dados a uma instância de banco de dados no Amazon Aurora ](USER_WorkingWithParamGroups.Associating.md) + [ # Modificar parâmetros em um grupo de parâmetros de banco de dados no Amazon Aurora ](USER_WorkingWithParamGroups.Modifying.md) + [ # Redefinir parâmetros em um grupo de parâmetros de banco de dados como seus valores padrão no Amazon Aurora ](USER_WorkingWithParamGroups.Resetting.md) + [ # Copiar um grupo de parâmetros de banco de dados no Amazon Aurora ](USER_WorkingWithParamGroups.Copying.md) + [ # Listar grupos de parâmetros de banco de dados no Amazon Aurora ](USER_WorkingWithParamGroups.Listing.md) + [ # Visualizar valores de parâmetros para um grupo de parâmetros de banco de dados no Amazon Aurora ](USER_WorkingWithParamGroups.Viewing.md) + [ # Excluir um grupo de parâmetros de banco de dados no Amazon Aurora ](USER_WorkingWithParamGroups.Deleting.md) # Criar um grupo de parâmetros de banco de dados no Amazon Aurora 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 aurora-mysql5.7 \ --description "My new parameter group" ``` Para Windows: ``` aws rds create-db-parameter-group ^ --db-parameter-group-name mydbparametergroup ^ --db-parameter-group-family aurora-mysql5.7 ^ --description "My new parameter group" ``` O comando gerará uma saída semelhante à seguinte: ``` DBPARAMETERGROUP mydbparametergroup aurora-mysql5.7 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 Aurora 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 Aurora](USER_WorkingWithParamGroups.Creating.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 em um cluster de banco de dados](Aurora.Modifying.md#Aurora.Modifying.Instance). **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. 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. **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 Aurora 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/AuroraUserGuide/images/db-cluster-instance-param-group.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 Aurora 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/AuroraUserGuide/images/db-cluster-instance-param-group.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 Aurora 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 Aurora 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 Aurora 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 Aurora É 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` # 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. **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 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. *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 Amazon Aurora](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 Aurora MySQL. ### 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. 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 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). ## 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âmetro de banco de dados LEAST (Menor)** Você pode especificar a função `LEAST` em um valor do parâmetro do Aurora MySQL `table_definition_cache`. Use-a para definir a quantidade de definições de tabela que podem ser armazenadas no cache de definição para o menor entre `DBInstanceClassMemory`/393040 ou 20.000. ``` LEAST({DBInstanceClassMemory/393040}, 20000) ```