Configurar flags de bancos de dados de uma instância

Para ajustar os parâmetros do PostgreSQL, as opções do banco de dados e personalizar o comportamento da instância em um cluster do AlloyDB para PostgreSQL, adicione, modifique ou remova flags de banco de dados em 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 sinalização pode ser necessário configurar outra para ativar toda a funcionalidade desejada.

Depois que você 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 primária ou de pool de leitura que precisa de uma reinicialização, é possível escolher uma das seguintes políticas de manutenção:

  • Baixo tempo de inatividade. Essa política é ativada por padrão. Recomendamos usar essa 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 baixa inatividade ativada, atualizar uma flag que exige uma reinicialização na instância principal do cluster tem os seguintes efeitos:

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

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

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

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

    • A flag na instância do pool de leitura termina de ser atualizada 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 volta ao desempenho máximo vários minutos depois de forçar a aplicação de uma atualização de flag.

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

    • A instância principal fica inativa por cerca de um minuto.

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

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

    • A instância do pool de leitura fica inativa por cerca de um minuto.

    • A flag na instância do pool de leitura termina de ser atualizada 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 o acesso.

Para garantir que a manutenção e as atualizações possam criar slots de replicação temporários para sincronização de estado, verifique se o número total de slots de replicação é pelo menos um a menos que o limite de max_wal_senders. Para mais informações sobre como configurar essa flag, consulte Configurar as instâncias de origem.

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 seu cluster, selecione uma instância e clique em Editar.

  4. Abra as Opções de configuração avançadas.

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

    Adicionar uma sinalização

    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 sinalização

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

    Excluir uma sinalização

    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.

  6. Clique em Atualizar instância.

gcloud

Use o comando gcloud alloydb instances update para alterar 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 as 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 por 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.

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

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