Configurar flags de bancos de dados de uma instância

Nesta página, descrevemos como adicionar, modificar e excluir flags de banco de dados de uma instância em um cluster do AlloyDB para PostgreSQL.

Você usa flags de banco de dados em muitas operações, como no ajuste dos parâmetros do PostgreSQL, das opções e na configuração e nos ajustes de uma instância. As modificações no valor de uma flag de banco de dados persistem na instância até que você remova a flag ou modifique o valor dela novamente.

Em alguns casos, para configurar uma flag pode ser necessário configurar outra para ativar toda a funcionalidade desejada.

Depois de definir, remover ou modificar uma flag para uma instância de banco de dados, o AlloyDB poderá reiniciar a instância. Isso depende da flag, conforme listado em Flags de banco de dados compatíveis.

Ao modificar uma flag de banco de dados na instância principal ou em um pool de leitura que precisa ser reiniciado, você pode escolher uma das seguintes políticas de manutenção:

  • Baixo tempo de inatividade. Essa política é ativada por padrão. Recomendamos o uso dessa política para todos os clusters de produção do AlloyDB, porque ela minimiza o tempo de inatividade do aplicativo.

    Com a política de baixo tempo de inatividade ativada, a atualização de uma flag que exige uma reinicialização na instância principal do cluster tem estes efeitos:

    • A instância principal tem menos de um segundo de inatividade para a maioria das cargas de trabalho.

    • A flag na instância principal termina de atualizar para o novo valor após cerca de 15 minutos.

    A atualização de uma flag que exige uma reinicialização em uma instância do pool de leitura tem estes efeitos:

    • A instância do pool de leitura não exige tempo de inatividade.

    • A flag na instância do pool de leitura termina de atualizar para o novo valor após cerca de 10 minutos.

  • Forçar aplicação. Para aplicar atualizações de flag mais rapidamente, use a opção FORCE_APPLY com o comando gcloud beta alloydb instances update.

    Essa política é mais adequada para ambientes de desenvolvimento, permitindo que você adicione ou modifique flags rapidamente em troca de um tempo de inatividade mais longo da instância e uma diminuição temporária no desempenho ou na capacidade de processamento do banco de dados. O cluster retorna ao desempenho máximo vários minutos após a aplicação forçada de uma atualização de flag.

    Com a política de aplicação forçada ativada, a atualização de uma flag que exige uma reinicialização na instância principal do cluster tem estes efeitos:

    • A instância principal tem cerca de um minuto de inatividade.

    • A flag na instância principal termina de atualizar para o novo valor após um ou dois minutos.

    A atualização de uma flag que exige uma reinicialização em uma instância do pool de leitura tem estes efeitos:

    • A instância do pool de leitura tem cerca de um minuto de inatividade.

    • A flag na instância do pool de leitura termina de atualizar para o novo valor após um ou dois minutos.

Antes de começar

  • O projeto do Google Cloud que você está usando precisa ter sido ativado para acessar o AlloyDB.
  • Você precisa ter um destes papéis do IAM no Google Cloud projeto que está sendo usado:
    • roles/alloydb.admin (o papel predefinido do IAM de Admin do AlloyDB)
    • roles/owner (o papel básico do IAM de Proprietário)
    • roles/editor (o papel básico do IAM de Editor)

    Se você não tiver nenhum desses papéis, entre em contato com o Administrador da organização para solicitar acesso.

Console

  1. No Google Cloud console, acesse a página Clusters.

    Acessar Clusters

  2. Clique em um cluster na coluna Nome do Recurso.

  3. Na página Visão geral , acesse Instâncias no cluster, selecione uma instância e clique em Editar.

  4. Adicione, modifique ou exclua uma flag de banco de dados da instância:

    Adicionar uma flag

    1. Para adicionar uma flag de banco de dados à instância, clique em Adicionar flag.
    2. Selecione uma flag na lista Nova flag de banco de dados.
    3. Forneça um valor para a flag.
    4. Clique em Concluído.

    Modificar uma flag

    1. Para modificar uma flag de banco de dados presente na instância, expanda a flag e modifique o valor da flag atual na seção Editar flag de banco de dados.
    2. Clique em Concluído.

    Excluir uma flag

    1. Para excluir uma flag de banco de dados da instância, selecione uma flag e clique no ícone de exclusão.
    2. Clique em Concluído.

  5. Clique em Atualizar instância.

gcloud

Use o gcloud alloydb instances update comando para mudar as flags de banco de dados de uma instância.

   gcloud alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID

Para aplicar atualizações de flag mais rapidamente, inclua o argumento --update-mode=FORCE_APPLY. Como isso pode diminuir temporariamente o desempenho do banco de dados, evite usar essa opção em um ambiente de produção.

   gcloud beta alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID \
   --update-mode=FORCE_APPLY

Substitua:

  • INSTANCE_ID: o ID da instância.
  • FLAGS_LIST: uma lista separada por vírgulas de uma ou mais especificações de flag de banco de dados. Cada especificação consiste no nome da flag, um sinal de igual (=) e o valor a ser atribuído às flags. Para flags de banco de dados que não aceitam valores, forneça o nome da flag seguido de um sinal de igual (=).
  • REGION_ID: a região em que a instância está localizada, por exemplo, us-central1.
  • CLUSTER_ID: o ID do cluster em que a instância está localizada.
  • PROJECT_ID: o ID do projeto em que o cluster está localizado. passando por um ciclo de manutenção de tempo de inatividade baixo ou zero, depois de modificar as flags de banco de dados.

Para conferir a lista de flags atuais definidas manualmente de uma instância, execute o seguinte comando:

   gcloud alloydb instances describe INSTANCE_ID \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID