Como trabalhar com grupos de parâmetros de banco de dados e grupos de parâmetros de cluster de banco de dados - Amazon Aurora

Como trabalhar com grupos de parâmetros de banco de dados e grupos de parâmetros de cluster de banco de dados

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 do Aurora com grupos de parâmetros. O Amazon RDS define grupos de parâmetros com configurações padrão.

Importante

Você pode definir seus próprios grupos de parâmetros com configurações personalizadas. Dessa forma, você pode modificar suas instâncias de banco de dados e clusters do Aurora para usar seus próprios grupos 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 banco de dados do Amazon Aurora.

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.

Um grupo de parâmetros de cluster de banco de dados atua como um contêiner de valores de configuração de mecanismo aplicados a cada instância de banco de dados em um cluster de banco 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

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 do 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 parameter group de 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ê cria seu próprio grupo de parâmetros, no qual escolhe suas próprias configurações de parâmetros. Nem todos os parâmetros de mecanismo de banco de dados podem ser alterados em um grupo de parâmetros criado por você.

Se quiser usar seu próprio grupo de parâmetros, crie um novo e modifique os parâmetros desejados. Em seguida, modifique sua instância de banco de dados ou cluster de banco de dados para usar o novo grupo de parâmetros. 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, as alterações se aplicarão a todos os clusters do Aurora que estiverem associados a esse grupo.

Você também pode copiar um parameter group de banco de dados existente com o comandoAWS CLI copy-db-parameter-group da . Você pode copiar um parameter group de cluster de banco de dados existente com o comando copy-db-parameter-group da AWS CLI. Copiar um grupo de parâmetros pode ser conveniente quando você deseja incluir a maioria dos valores e parâmetros personalizados de um grupo de parâmetros existente em um novo grupo de parâmetros .

Veja a seguir alguns pontos importantes sobre como trabalhar com parâmetros em um grupo de parâmetros:

  • Os parâmetros do banco de dados são estáticos ou dinâmicos. Quando você altera um parâmetro estático, uma reinicialização do banco de dados é necessária para colocá-lo em vigor. Quando você altera um parâmetro dinâmico e salva o grupo de parâmetros, a alteração é aplicada imediatamente, independentemente da configuração Apply Immediately (Aplicar imediatamente). Quando você alterar um parâmetro estático e salvar o grupo de parâmetros de banco de dados, a alteração do parâmetro entrará em vigor depois que você reinicializar a instância de banco de dados manualmente. Você pode reiniciar uma instância de banco de dados usando o console do RDS, chamando o comando reboot-db-instance CLI ou chamando a operação da API RebootDbInstance. A exigência de reinicializar a instância de banco de dados associada após uma alteração de parâmetro estático ajuda a aliviar o risco de uma configuração incorreta de parâmetro que afeta uma chamada de API, como chamar ModifyDBInstance para alterar a classe da instância de banco de dados ou o armazenamento em escala.

    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 AWS Management Console mostrará o grupo de parâmetros de banco de dados com um status de pending-reboot (reinicialização pendente). O status pending-reboot (reinicialização pendente) do grupo de parâmetros não resultará em 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.

  • 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 recém-associado, 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 banco de dados do Amazon Aurora.

    nota

    Depois de alterar o grupo de parâmetros associado a um cluster de banco de dados, reinicialize a instância de banco de dados primária no cluster para aplicar as alterações a todas as instâncias de banco de dados no cluster.

    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 de banco de dados primária na saída. Se o valor for pending-reboot, reinicie a instância de banco de dados principal do cluster de banco de dados.

  • É possível especificar o valor de um parâmetro como um número inteiro ou como uma expressão de número inteiro criada a partir de fórmulas, variáveis, funções e operadores. As funções podem incluir uma expressão matemática de log. Para obter mais informações, consulte Especificação de parâmetros de banco de dados.

  • Defina quaisquer parâmetros que se relacionem ao conjunto de caracteres ou ao agrupamento do seu banco de dados no seu grupo de parâmetros antes de criar a instância de banco de dados e antes de criar um banco de dados na sua instância de banco de dados. Isso garante que o banco de dados padrão e os novos bancos de dados na sua instância de banco 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 para a sua instância de banco de dados, as alterações de parâmetros não serão aplicadas em 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.

  • Definir incorretamente os parâmetros em um parameter group de 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 de seus dados antes de modificar um parameter group de . Faça testes com alterações de configuração de grupos de parâmetros em uma instância de banco de dados de teste antes de aplicar essas alterações de grupos de parâmetros a uma instância de banco de dados de produção.

  • Para um banco de dados global do 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 do Aurora.

  • Para determinar os parâmetros compatíveis para seu mecanismo de banco de dados, é possível visualizar os parâmetros no grupo de parâmetros de banco de dados e o grupo de parâmetros de banco de dados usado pela 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 e Visualizar valores de parâmetros de um grupo de parâmetros do cluster de banco de dados.

Parâmetros do cluster de banco de dados e da instância de banco de dados do Amazon Aurora

O Aurora usa um sistema de configurações de dois níveis, da seguinte maneira:

  • 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 banco de dados do 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. Cada instância de banco de dados do cluster herda as configurações desse grupo de parâmetros de cluster de banco de dados e está associada a um grupo de parâmetros de banco de dados. 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. Posteriormente, será possível alterar os grupos de parâmetros posteriormente para aqueles que você criar, nos quais os valores dos parâmetros podem ser editados.

Os grupos de parâmetros de cluster de banco de dados também incluem valores padrão para todos os parâmetros em nível de instância do grupo de parâmetros de banco de dados. Esses padrões destinam-se principalmente a configurar clusters do Aurora Serverless, que são associados apenas a grupos de parâmetros de cluster de banco de dados, e não a grupos de parâmetros de banco de dados. É possível modificar as configurações de parâmetros em nível de instância no grupo de parâmetros de cluster de banco de dados. Em seguida, o Aurora aplica essas configurações a cada nova instância de banco de dados adicionada a um cluster sem servidor. Para saber mais sobre as definições de configuração de clusters do Aurora Serverless e quais configurações você pode modificar, consulte Grupos de parâmetros e Aurora Serverless v1.

No caso de clusters sem servidor, os 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 sobrescritos usando o comando describe-db-parameters da AWS CLI ou a API DescribeDBParameters do RDS. O campo Source conterá o valor user se você tiver modificado esse parâmetro. Para repor 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 da AWS CLI ou a operação de API ResetDBParameterGroup 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.

Para clusters do Aurora Serverless, veja detalhes adicionais em Grupos de parâmetros e Aurora Serverless v1.

Aurora PostgreSQL

Consulte Amazon Aurora PostgreSQL parameters.

Criar um grupo de parâmetros de banco de dados

Você pode criar um novo parameter group de banco de dados usando o AWS Management Console, a AWS CLI ou a API do RDS.

Para criar um parameter group de banco de dados

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, selecione Parameter groups.

  3. Escolha Create parameter group (Criar parameter group).

    A janela Create parameter group (Criar parameter group) é exibida.

  4. Selecione uma família de parameter groups de banco de dados na lista Parameter group family (Família de parameter groups).

  5. Na lista Type (Tipo), selecione DB Parameter Group (Parameter group de banco de dados).

  6. Insira o nome do novo grupo de parâmetros de banco de dados na caixa Group name (Nome do grupo).

  7. Insira uma descrição para o novo grupo de parâmetros de banco de dados na caixa Description (Descrição).

  8. Escolha Create (Criar).

Para criar um parameter group de banco de dados, use o comando AWS CLI create-db-parameter-groupda . O exemplo a seguir cria um parameter group de banco de dados chamado mydbparametergroup para o MySQL versão 5.6 com a descrição "My new parameter group (Meu novo parameter group)".

Inclua os seguintes parâmetros necessários:

  • --db-parameter-group-name

  • --db-parameter-group-family

  • --description

Para listar todas as famílias de parameter groups disponíveis, use o comando a seguir:

aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"
nota

A saída contém duplicatas.

exemplo

Para Linux, macOS ou Unix:

aws rds create-db-parameter-group \ --db-parameter-group-name mydbparametergroup \ --db-parameter-group-family aurora5.6 \ --description "My new parameter group"

Para Windows:

aws rds create-db-parameter-group ^ --db-parameter-group-name mydbparametergroup ^ --db-parameter-group-family aurora5.6 ^ --description "My new parameter group"

O comando gerará uma saída semelhante à seguinte:

DBPARAMETERGROUP mydbparametergroup aurora5.6 My new parameter group

Para criar um grupo de parâmetros de banco de dados, use a operação da API do RDS CreateDBParameterGroup.

Inclua os seguintes parâmetros necessários:

  • DBParameterGroupName

  • DBParameterGroupFamily

  • Description

Criar um grupo de parâmetros de cluster de banco de dados

Você pode criar um novo parameter group de cluster de banco de dados usando o AWS Management Console, a AWS CLI ou a API do RDS.

Para criar um parameter group de cluster de banco de dados

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, selecione Parameter groups.

  3. Escolha Create parameter group (Criar parameter group).

    A janela Create parameter group (Criar parameter group) é exibida.

  4. Selecione uma família de parameter groups de banco de dados na lista Parameter group family (Família de parameter groups)

  5. Na lista Type (Tipo), selecione DB Parameter Group (Parameter group de cluster de banco de dados).

  6. Insira o nome do novo grupo de parâmetros de cluster de banco de dados na caixa Group name (Nome do grupo).

  7. Insira uma descrição para o novo grupo de parâmetros de cluster de banco de dados na caixa Description (Descrição).

  8. Escolha Create (Criar).

Para criar um parameter group de cluster de banco de dados, use o comando AWS CLI da create-db-cluster-parameter-group. O exemplo a seguir cria um parameter group de cluster de banco de dados chamado mydbclusterparametergroup para o MySQL versão 5.6 com a descrição "My new parameter group (Meu novo parameter group)."

Inclua os seguintes parâmetros necessários:

  • --db-cluster-parameter-group-name

  • --db-parameter-group-family

  • --description

Para listar todas as famílias de parameter groups disponíveis, use o comando a seguir:

aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"
nota

A saída contém duplicatas.

exemplo

Para Linux, macOS ou Unix:

aws rds create-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclusterparametergroup \ --db-parameter-group-family aurora5.6 \ --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 aurora5.6 ^ --description "My new cluster parameter group"

O comando gerará uma saída semelhante à seguinte:

DBCLUSTERPARAMETERGROUP mydbclusterparametergroup mysql5.6 My cluster new parameter group

Para criar um grupo de parâmetros de cluster de banco de dados, use a ação da API CreateDBClusterParameterGroup do RDS.

Inclua os seguintes parâmetros necessários:

  • DBClusterParameterGroupName

  • DBParameterGroupFamily

  • Description

Associando um parameter group de banco de dados a uma instância de banco de dados

Você pode criar seus próprios parameter groups de banco de dados com configurações personalizadas. Você pode associar um parameter group de banco de dados a uma instância de banco de dados usando a AWS Management Console, 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 parameter group de banco de dados, consulte Criar um grupo de parâmetros de banco de dados. Para mais informações sobre a modificação de uma instância de banco de dados , consulte Modificar uma instância de banco de dados em um cluster de banco de dados.

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 recém-associado, essas alterações serão aplicadas imediatamente sem uma reinicialização.

Para associar um parameter group de banco de dados a uma instância de banco de dados

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, escolha Databases (Bancos de dados) e a instância de banco de dados que você deseja modificar.

  3. Selecione Modify. A página Modify DB Instance (Modificar instância de banco de dados) é exibida.

  4. Altere a configuração do grupo de parâmetros de banco de dados.

  5. Selecione Continue (Continuar) e verifique o resumo de modificações.

  6. (Opcional) Escolha Apply immediately (Aplicar imediatamente) para aplicar as alterações imediatamente. Escolher essa opção pode causar uma interrupção em alguns casos.

  7. 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 selecione Back (Voltar) para editar as alterações ou Cancel (Cancelar) para cancelar as alterações.

Para associar um parameter group de banco de dados a uma instância de banco de dados, use o AWS CLI modify-db-instance comando com as seguintes opções:

  • --db-instance-identifier

  • --db-parameter-group-name

O exemplo a seguir associa o mydbpg parameter group de banco de dados à instância de database-1 banco de dados. 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.

exemplo

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

Para associar um parameter group de banco de dados a uma instância de banco de dados, use a ModifyDBInstance operação da API do RDS com os seguintes parâmetros:

  • DBInstanceName

  • DBParameterGroupName

Associar um parameter group de cluster de banco de dados a um cluster de banco de dados

Você pode criar seus próprios parameter groups de cluster de banco de dados com configurações personalizadas. Você pode associar um parameter group de cluster de banco de dados a um cluster de banco de dados usando o AWS Management Console 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 parameter group de cluster de banco de dados, consulte Criar um grupo de parâmetros de cluster de banco de dados. Para obter informações sobre como criar um cluster de banco de dados, consulte Criar um cluster de banco de dados do Amazon Aurora. Para obter informações sobre como modificar um cluster de banco de dados, consulte Modificar um cluster de banco de dados do Amazon Aurora.

nota

Depois de alterar o grupo de parâmetros associado a um cluster de banco de dados, reinicialize a instância de banco de dados primária no cluster para aplicar as alterações a todas as instâncias de banco de dados no cluster.

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 de banco de dados primária na saída. Se o valor for pending-reboot, reinicie a instância de banco de dados principal do cluster de banco de dados.

Para associar um parameter group de cluster de banco de dados a um cluster de banco de dados

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, selecione Databases (Bancos de dados) e selecione o cluster de banco de dados que você deseja modificar.

  3. Selecione Modify. A página Modify DB cluster (Modificar cluster de banco de dados) é exibida.

  4. Altere a configuração do parameter group do cluster de banco de dados.

  5. Selecione Continue (Continuar) e verifique o resumo de modificações.

    A alteração é aplicada imediatamente, independentemente da configuração Agendamento de modificações.

  6. 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.

Para associar um parameter group de cluster de banco de dados a um cluster de banco de dados, use o comando AWS CLI modify-db-cluster com as seguintes opções:

  • --db-cluster-name

  • --db-cluster-parameter-group-name

O exemplo a seguir associa o mydbclpg parameter group de banco de dados ao cluster de banco de dadosmydbcluster.

exemplo

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

Para associar um parameter group de cluster de banco de dados a um cluster de banco de dados, use a ModifyDBCluster operação da API do RDS com os seguintes parâmetros:

  • DBClusterIdentifier

  • DBClusterParameterGroupName

Modificar parâmetros em um grupo de parâmetros de banco de dados

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 parameter group 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 parameter group.

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 parameter group 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

Para modificar um parameter group de banco de dados

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, selecione Parameter groups.

  3. Na lista, escolha o grupo de parâmetros que você deseja modificar.

  4. Em Parameter group actions (Ações do grupo de parâmetros), escolha Edit (Editar).

  5. 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.

  6. Selecione Save changes.

Para copiar um grupo de parâmetros de banco de dados, use o comando AWS CLImodify-db-parameter-group 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 parameter group de banco de dados chamado mydbparametergroup.

exemplo

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

Para copiar um grupo de parâmetros de banco de dados, use a operação da API do RDS ModifyDBParameterGroup com os seguintes parâmetros obrigatórios:

  • DBParameterGroupName

  • Parameters

Modificar parâmetros em um grupo de parâmetros de cluster de banco de dados

É possível modificar valores de parâmetros em um grupo de parâmetros do cluster de banco de dados criado pelo cliente. Não é possível alterar os valores de parâmetros em um grupo de parâmetros do cluster de banco de dados padrão. As alterações dos parâmetros em um parameter group 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 parameter group de cluster de banco de dados.

Para modificar um parameter group de cluster de banco de dados

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, selecione Parameter groups.

  3. Na lista, escolha o grupo de parâmetros que você deseja modificar.

  4. Em Parameter group actions (Ações do grupo de parâmetros), escolha Edit (Editar).

  5. 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.

  6. Selecione Save changes.

  7. Reinicialize a instância de banco de dados primária no cluster para aplicar as alterações a todas as instâncias de banco de dados no cluster.

Para modificar um parameter group de cluster de banco de dados, use o comando AWS CLI da modify-db-cluster-parameter-group 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 parameter group de cluster de banco de dados chamado mydbclusterparametergroup.

exemplo

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

Para modificar um grupo de parâmetros de cluster de banco de dados, use o comando ModifyDBClusterParameterGroup da API do RDS com os seguintes parâmetros necessários:

  • DBClusterParameterGroupName

  • Parameters

Redefinir parâmetros em um grupo de parâmetros de banco de dados para seus valores padrão

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 parameter group 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 parameter group.

Quando você usa o console, você pode redefinir parâmetros específicos para seus valores padrão, mas não pode redefinir facilmente todos os parâmetros no grupo de parâmetros de banco de dados de uma só vez. Quando você usa a AWS CLI ou a API do RDS, você pode redefinir parâmetros específicos para seus valores padrão e você 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 parameter group 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
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.

Para redefinir parâmetros em um grupo de parâmetros de banco de dados para seus valores padrão

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, selecione Parameter groups.

  3. Na lista, escolha o grupo de parâmetros.

  4. Em Parameter group actions (Ações do grupo de parâmetros), escolha Edit (Editar).

  5. 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.

  6. Escolha Reset (Redefinir) e, em seguida, confirme escolhendo Reset parameters (Redefinir parâmetros).

Para redefinir alguns ou todos os parâmetros em um grupo de parâmetros de banco de dados, use o comando AWS CLI da reset-db-parameter-group 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.

exemplo

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.

exemplo

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

Para redefinir parâmetros em um grupo de parâmetros de banco de dados para seus valores padrão, use o comando ResetDBParameterGroup 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.

Como redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados

Você pode redefinir parâmetros para seus valores padrão em um grupo de parâmetro de cluster de banco de dados criado pelo cliente. As alterações dos parâmetros em um parameter group 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 parameter group 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.

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 AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, selecione Parameter groups.

  3. Na lista, escolha o grupo de parâmetros.

  4. Em Parameter group actions (Ações do grupo de parâmetros), escolha Edit (Editar).

  5. 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.

  6. Escolha Reset (Redefinir) e, em seguida, confirme escolhendo Reset parameters (Redefinir parâmetros).

  7. Reinicialize a instância de banco de dados primária no cluster do banco de dados para aplicar as alterações a todas as instâncias de banco de dados no cluster do banco de dados.

Para redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados para seus valores padrão, use o comando AWS CLI reset-db-cluster-parameter-group com a seguinte opção necessá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.

exemplo

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.

exemplo

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

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 ResetDBClusterParameterGroup 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 banco de dados

Você pode copiar os parameter groups de banco de dados personalizados que criou. Copiar um parameter group é uma solução conveniente quando você já criou um parameter group de banco de dados e deseja incluir a maioria dos parâmetros e valores personalizados desse grupo em um novo parameter group de banco de dados. É possível copiar um grupo de parâmetros de banco de dados usando o AWS Management Console, o comando da AWS CLI copy-db-parameter-group ou a operação da API do RDS CopyDBParameterGroup.

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 ou o comando describe-db-parameters para verificar se o seu grupo de parâmetros de banco de dados foi criado.

nota

Não é possível copiar um parameter group padrão. No entanto, é possível criar um parameter group com base em um parameter group padrão.

No momento, você não pode copiar um grupo de parâmetros para uma região da AWS diferente.

Para copiar um parameter group de banco de dados

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, selecione Parameter groups.

  3. Na lista, escolha o grupo de parâmetros personalizado que você deseja copiar.

  4. Em Parameter group actions (Ações do grupo de parâmetros), escolha Copy (Copiar).

  5. Em New DB parameter group identifier (Novo identificador do parameter group do banco de dados), digite um nome para o novo parameter group.

  6. Em Description (Descrição), digite uma descrição para o novo grupo de parâmetros.

  7. Escolha Copiar.

Para copiar um grupo de parâmetros de banco de dados, use o comando AWS CLI da copy-db-parameter-group 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 parameter group de banco de dados chamado mygroup2 que é uma cópia do parameter group de banco de dados mygroup1.

exemplo

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"

Para copiar um grupo de parâmetros de banco de dados, use a operação da API do RDS CopyDBParameterGroup com os seguintes parâmetros obrigatórios:

  • SourceDBParameterGroupIdentifier

  • TargetDBParameterGroupIdentifier

  • TargetDBParameterGroupDescription

Copiar um grupo de parâmetros de cluster de banco de dados

Você pode copiar os parameter groups de cluster de banco de dados personalizados que criou. Copiar um parameter group é uma solução conveniente quando você já criou um parameter group de cluster de banco de dados e deseja incluir a maioria dos parâmetros e valores personalizados desse grupo em um novo parameter group 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 ou a operação da API do RDS CopyDBClusterParameterGroup.

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 de banco de dados usando esse grupo de parâmetros como o padrão. Isso permite que o Amazon RDS conclua totalmente a ação de cópia antes que o grupo de parâmetros seja usado como padrão para um novo cluster de banco de dados. É possível usar a opção Parameter Groups (Grupos de parâmetros) do console do Amazon RDS ou o comando describe-db-cluster-parameters para verificar se o seu grupo de parâmetros de cluster de banco de dados foi criado.

nota

Não é possível copiar um parameter group padrão. No entanto, é possível criar um parameter group com base em um parameter group padrão.

Para copiar um parameter group de cluster de banco de dados

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, selecione Parameter groups.

  3. Na lista, escolha o grupo de parâmetros personalizado que você deseja copiar.

  4. Em Parameter group actions (Ações do grupo de parâmetros), escolha Copy (Copiar).

  5. Em New DB parameter group identifier (Novo identificador do parameter group do banco de dados), digite um nome para o novo parameter group.

  6. Em Description (Descrição), digite uma descrição para o novo grupo de parâmetros.

  7. Escolha Copiar.

Para copiar um parameter group de cluster de banco de dados, use o comando AWS CLI da copy-db-cluster-parameter-group 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 parameter group de cluster de banco de dados chamado mygroup2 que é uma cópia do parameter group de cluster de banco de dados mygroup1.

exemplo

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"

Para copiar um grupo de parâmetros de cluster de banco de dados, use a operação da API do RDS CopyDBClusterParameterGroup com os seguintes parâmetros obrigatórios:

  • SourceDBClusterParameterGroupIdentifier

  • TargetDBClusterParameterGroupIdentifier

  • TargetDBClusterParameterGroupDescription

Listar grupos de parâmetros de banco de dados

Você pode listar os grupos de parâmetros de banco de dados que criou para sua conta da AWS.

nota

Parameter groups 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 parameter group personalizado, pode modificar as configurações desses parâmetros.

Para listar todos os grupos de parâmetros de banco de dados para uma conta da AWS

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, selecione Parameter groups.

    Os parameter groups de banco de dados aparecem em uma lista.

Para listar todos os grupos de parâmetros de banco de dados de uma conta da AWS, use o comando AWS CLI da describe-db-parameter-groups.

exemplo

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.mysql5.6 mysql5.6 Default parameter group for MySQL5.6 DBPARAMETERGROUP mydbparametergroup mysql5.6 My new parameter group

O exemplo a seguir descreve o parameter group 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 mysql5.6 My new parameter group

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 DescribeDBParameterGroups.

Listagem de grupos de parâmetros de cluster de banco de dados

Você pode listar os parameter groups do cluster de banco de dados que criou para sua conta da AWS.

nota

Parameter groups 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 parameter group personalizado, pode modificar as configurações desses parâmetros.

Para listar todos os parameter groups do cluster de banco de dados para uma conta da AWS

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. 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).

Para listar todos os parameter groups de cluster de banco de dados de uma conta da AWS, use o comando AWS CLI da describe-db-cluster-parameter-groups.

exemplo

O exemplo a seguir lista todos os parameter groups de cluster de banco de dados de uma conta da AWS.

aws rds describe-db-cluster-parameter-groups

O comando retorna uma resposta como a seguinte:

DBCLUSTERPARAMETERGROUPS arn:aws:rds:us-west-2:1234567890:cluster-pg:default.aurora5.6 default.aurora5.6 aurora5.6 Default cluster parameter group for aurora5.6 DBCLUSTERPARAMETERGROUPS arn:aws:rds:us-west-2:1234567890:cluster-pg:mydbclusterparametergroup mydbclusterparametergroup aurora5.6 My new cluster parameter group

O exemplo a seguir descreve o parameter group 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 arn:aws:rds:us-west-2:1234567890:cluster-pg:mydbclusterparametergroup mydbclusterparametergroup aurora5.6 My new cluster parameter group

Para listar todos os parameter groups de cluster de banco de dados de uma conta da AWS, use a ação da API DescribeDBClusterParameterGroups do RDS.

Visualizar valores de parâmetros para um grupo de parâmetros de banco de dados

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

Para visualizar os valores de parâmetros para um parameter group de banco de dados

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, selecione Parameter groups.

    Os parameter groups de banco de dados aparecem em uma lista.

  3. Escolha o nome do grupo de parâmetros para ver sua lista de parâmetros.

Para visualizar os valores de parâmetros para um parameter group de banco de dados, use o comando AWS CLI da describe-db-parameters com o seguinte parâmetro obrigatório.

  • --db-parameter-group-name

exemplo

O exemplo a seguir lista os parâmetros e os valores de parâmetros para um parameter group 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

Para visualizar os valores de parâmetros para um grupo de parâmetros de banco de dados, use o comando DescribeDBParameters da API do RDS com o seguinte parâmetro necessário.

  • DBParameterGroupName

Visualizar valores de parâmetros de um grupo de parâmetros do cluster de banco de dados

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

Para visualizar os valores de parâmetros para um parameter group de cluster de banco de dados

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. 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).

  3. Escolha o nome do grupo de parâmetros de cluster de banco de dados para ver sua lista de parâmetros.

Para visualizar os valores de parâmetros para um parameter group de cluster de banco de dados, use o comando AWS CLI da describe-db-cluster-parameters com o seguinte parâmetro obrigatório.

  • --db-cluster-parameter-group-name

exemplo

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": [ { "ApplyMethod": "pending-reboot", "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded", "DataType": "boolean", "AllowedValues": "0,1", "SupportedEngineModes": [ "provisioned" ], "Source": "engine-default", "IsModifiable": false, "ParameterName": "allow-suspicious-udfs", "ApplyType": "static" }, { "ApplyMethod": "pending-reboot", "Description": "Enables new features in the Aurora engine.", "DataType": "boolean", "IsModifiable": true, "AllowedValues": "0,1", "SupportedEngineModes": [ "provisioned" ], "Source": "engine-default", "ParameterValue": "0", "ParameterName": "aurora_lab_mode", "ApplyType": "static" }, ...

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, sem formatação.

aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name mydbclusterparametergroup --output text

O comando retorna uma resposta como a seguinte:

PARAMETERS 0,1 pending-reboot static boolean Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded False allow-suspicious-udfs engine-default SUPPORTEDENGINEMODES provisioned PARAMETERS 0,1 pending-reboot static boolean Enables new features in the Aurora engine. True aurora_lab_mode 0 engine-default SUPPORTEDENGINEMODES provisioned ...

Para visualizar os valores de parâmetros para um grupo de parâmetros de cluster de banco de dados, use o comando DescribeDBClusterParameters da API do RDS com o seguinte parâmetro necessário.

  • DBClusterParameterGroupName

Comparação de grupos de parâmetros de

Você pode usar o AWS Management Console para visualizar as diferenças entre dois parameter groups do mesmo mecanismo e versão do banco de dados.

Para comparar dois parameter groups

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, selecione Parameter groups.

  3. Na lista, escolha os dois grupos de parâmetros que você deseja comparar.

  4. Em Parameter group actions (Ações do grupo de parâmetros), escolha Compare (Comparar).

    nota

    Se os itens selecionados não forem equivalentes, você não poderá escolher Compare (Comparar). Por exemplo, não é possível comparar um grupo de parâmetros MySQL 5.6 e um MySQL 5.7. Você não pode comparar um grupo de parâmetros do banco de dados e um grupo de parâmetros do cluster do Aurora.

Especificação de parâmetros de banco de dados

Os tipos de parâmetros de banco de dados incluem os seguintes:

  • Inteiro

  • Booleano

  • String

  • Long

  • Double

  • Time stamp

  • 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 de banco de dados inteiros e booleanos usando expressões, fórmulas e funções.

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: {}. 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 inteiro com a quantidade de bytes de memória alocados para a classe de instância de banco de dados associada à instância de banco de dados atual, menos a memória usada pelos processos do RDS que gerenciam a instância.

EndPointPort

Retorna um inteiro representando a porta usada ao se conectar à instância de banco de dados.

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: *

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: {}. 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.

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.

nota

Atualmente, as funções de parâmetro de banco de dados são suportadas apenas no console e não são compatíveis com a CLI da AWS.

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.

exemplo 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)