Esta página descreve como adicionar flags de base de dados a uma instância, modificar flags de base de dados e eliminar flags de base de dados de uma instância num cluster do AlloyDB for PostgreSQL.
Usa flags de base de dados para muitas operações, incluindo ajustar os parâmetros do PostgreSQL, ajustar as opções e configurar e otimizar uma instância. As modificações ao valor de um sinalizador da base de dados persistem para a respetiva instância até remover o sinalizador ou modificar novamente o respetivo valor.
Em alguns casos, a definição de uma flag pode exigir que defina outra flag para ativar totalmente a funcionalidade desejada.
Depois de definir, remover ou modificar uma flag para uma instância da base de dados, o AlloyDB pode reiniciar a instância. Isto depende da flag, conforme indicado em Flags de base de dados suportadas.
Quando modifica uma flag da base de dados na instância principal ou num conjunto de leitura que requer um reinício, pode escolher uma das seguintes políticas de manutenção:
Inatividade reduzida. Esta política está ativada por predefinição. Recomendamos que use esta política para todos os seus clusters AlloyDB de produção, uma vez que minimiza o tempo de inatividade da aplicação.
Com a política de tempo de inatividade baixo ativada, a atualização de uma flag que requer o reinício na instância principal do cluster tem os seguintes efeitos:
A instância principal tem menos de um segundo de tempo de inatividade para a maioria das cargas de trabalho.
A flag na instância principal termina a atualização para o novo valor após cerca de 15 minutos.
A atualização de uma flag que requer um reinício numa instância do conjunto de leitura tem os seguintes efeitos:
A instância do conjunto de leitura não requer qualquer tempo de inatividade.
A flag na instância do conjunto de leitura termina a atualização 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_APPLYcom o comandogcloud beta alloydb instances update.Esta política é mais adequada para ambientes de desenvolvimento, permitindo-lhe adicionar ou modificar rapidamente flags em troca de um tempo de inatividade da instância mais longo e uma diminuição temporária no desempenho ou na taxa de transferência da base de dados. O seu cluster volta ao pico de desempenho vários minutos depois de aplicar forçadamente uma atualização de flags.
Com a política de aplicação forçada ativada, a atualização de uma flag que requer um reinício na instância principal do cluster tem os seguintes efeitos:
A instância principal fica inativa durante cerca de um minuto.
A flag na instância principal termina a atualização para o novo valor após um ou dois minutos.
A atualização de uma flag que requer um reinício numa instância do conjunto de leitura tem os seguintes efeitos:
A instância do conjunto de leitura sofre cerca de um minuto de inatividade.
A flag na instância do conjunto de leitura termina a atualização para o novo valor após um ou dois minutos.
Antes de começar
- O Google Cloud projeto que está a usar tem de ter sido ativado para aceder ao AlloyDB.
- Tem de ter uma destas funções de IAM no Google Cloud projeto que está a usar:
roles/alloydb.admin(a função IAM predefinida de administrador do AlloyDB)roles/owner(a função de IAM básica de proprietário)roles/editor(a função de IAM básica de editor)
Se não tiver nenhuma destas funções, contacte o administrador organizacional para pedir acesso.
Consola
Na Google Cloud consola, aceda à página Clusters.
Clique num cluster na coluna Nome do recurso.
Na página Vista geral, aceda a Instâncias no cluster, selecione uma instância e, de seguida, clique em Editar.
Adicione, modifique ou elimine uma flag de base de dados da sua instância:
Adicione uma flag
- Para adicionar uma flag de base de dados à sua instância, clique em Adicionar flag.
- Selecione uma flag na lista Nova flag da base de dados.
- Indique um valor para a flag.
- Clique em Concluído.
Modifique uma flag
- Para modificar uma flag da base de dados presente na sua instância, expanda a flag da base de dados e modifique o valor da flag existente na secção Editar flag da base de dados.
- Clique em Concluído.
Elimine uma flag
- Para eliminar uma flag de base de dados da sua instância, selecione uma flag e clique no ícone de eliminação.
- Clique em Concluído.
Clique em Atualizar instância.
gcloud
Use o comando gcloud alloydb instances update
para alterar as flags da base de dados de uma instância.
gcloud alloydb instances update INSTANCE_ID \
--database-flags FLAGS_LIST \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_IDPara aplicar atualizações de flags mais rapidamente, inclua o argumento
--update-mode=FORCE_APPLY. Uma vez que isto pode diminuir temporariamente o desempenho da base de dados, evite usar esta opção num 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_APPLYSubstitua o seguinte:
INSTANCE_ID: o ID da instância.FLAGS_LIST: uma lista separada por vírgulas de uma ou mais especificações de flags da base de dados. Cada especificação consiste no nome da flag, num sinal de igual (=) e no valor a atribuir às flags. Para os flags de base de dados que não aceitam valores, indique o nome do flag seguido de um sinal de igual (=).REGION_ID: a região onde a instância está localizada, por exemplo,us-central1.CLUSTER_ID: o ID do cluster onde a instância está colocada.PROJECT_ID: O ID do projeto onde o cluster está localizado. em ciclo de manutenção com tempo de inatividade baixo ou nulo, depois de modificar as flags da base de dados.
Para ver a lista das 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