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, incluindo o ajuste de parâmetros e opções do PostgreSQL, além da configuração e ajuste 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 sinalização 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:

  • Baixa inatividade. Essa política fica ativada por padrão. Recomendamos usar essa política em 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 ser atualizada para o novo valor após cerca de 15 minutos.

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

    • A instância do pool de leitura não exige 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 flags 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 adicionar ou modificar flags rapidamente em troca de um tempo de inatividade maior da instância e uma diminuição temporária no desempenho ou taxa de transferência do banco de dados. O cluster volta 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 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.

    A atualização de uma flag que requer 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 Google Cloud que você está usando precisa ter sido ativado para acessar o AlloyDB.
  • Você precisa ter um destes papéis do IAM no projeto Google Cloud que está usando:
    • roles/alloydb.admin (o papel predefinido do IAM de administrador do AlloyDB)
    • roles/owner (o papel básico Proprietário do IAM)
    • roles/editor (o papel básico de editor do IAM)

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

Console

  1. No console Google Cloud , 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. Adicione, modifique ou exclua uma flag de banco de dados da sua 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. Informe um valor para a flag.
    4. Clique em Concluído.

    Modificar uma flag

    1. Para modificar uma sinalização do banco de dados na sua instância, expanda a sinalização e mude o valor na seção Editar sinalização do banco de dados.
    2. Clique em Concluído.

    Excluir uma flag

    1. Para excluir uma flag de banco de dados da sua 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 comando gcloud alloydb instances update 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 flags 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 flags 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 com tempo de inatividade baixo ou zero depois que você modifica as flags do banco de dados.

Para conferir a lista de flags atuais e 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