Esta página descreve como adicionar flags de banco de dados a uma instância, modificar flags de banco de dados 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 e das opções do PostgreSQL, assim como 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 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 pode reiniciar a instância. Isso depende da flag, como listado em Flags do banco de dados com suporte.
Ao modificar uma flag de banco de dados na instância principal ou de pool de leitura que precisa ser reiniciada, você pode escolher uma das seguintes políticas de manutenção:
Tempo de inatividade baixo. 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 tempo de inatividade baixo ativada, atualizar 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 sinalização na instância principal termina de atualizar para o novo valor após cerca de 15 minutos.
Atualizar 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 atualizar para o novo valor após cerca de 10 minutos.
Forçar aplicação. Para aplicar as atualizações de flag mais rapidamente, use a opção
FORCE_APPLY
com o comandogcloud beta alloydb instances update
.Essa política é mais adequada para ambientes de desenvolvimento, permitindo adicionar ou modificar rapidamente flags em troca de um tempo de inatividade maior da instância e uma diminuição temporária no desempenho ou na taxa de transferência do banco de dados. O cluster volta ao pico de desempenho vários minutos após a aplicação forçada de uma atualização de sinalização.
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 estes efeitos:
A instância principal tem um período de inatividade de cerca de um minuto.
A flag na instância principal termina de atualizar para o novo valor após um ou dois minutos.
Atualizar 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 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.
- É necessário ter uma destas funções do IAM no projeto do Google Cloud que você está usando:
roles/alloydb.admin
(papel predefinido do IAM de administrador do AlloyDB)roles/owner
(o papel básico do IAM "Proprietário")roles/editor
(papel básico do IAM de editor)
Se você não tiver nenhuma dessas funções, entre em contato com o administrador da organização para solicitar acesso.
No console do Google Cloud, acesse a página Clusters.
Clique em um cluster na coluna Nome do recurso.
Na página Visão geral, acesse Instâncias no cluster, selecione uma instância e clique em Editar.
Adicione, modifique ou exclua uma flag de banco de dados da sua instância:
Adicionar uma sinalização
- Para adicionar uma flag de banco de dados à sua instância, clique em Adicionar flag.
- Selecione uma flag na lista Nova flag de banco de dados.
- Informe um valor para a flag.
- Clique em Concluído.
Modificar uma flag
- Para modificar uma flag de banco de dados presente na sua instância, expanda a flag do banco de dados e modifique o valor da flag atual na seção Editar flag do banco de dados.
- Clique em Concluído.
Excluir uma sinalização
- Para excluir uma flag de banco de dados da sua instância, selecione uma flag e clique no ícone de exclusão.
- Clique em Concluído.
Clique em Atualizar instância.
Use o comando gcloud alloydb instances update
para mudar as flags do 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 sinalizadores de banco de dados. Cada especificação consiste no nome da sinalização, um sinal de igualdade (=) e o valor a ser atribuído às sinalizações. Para sinalizações de banco de dados que não têm valores, forneça o nome da sinalização seguido de um sinal de igual (=).REGION_ID
: a região em que a instância é colocada, por exemplo,us-central1
.CLUSTER_ID
: o ID do cluster em que a instância está colocada.PROJECT_ID
: o ID do projeto em que o cluster está colocado. em um ciclo de manutenção com tempo de inatividade baixo ou nulo, depois que você modifica as flags do 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