Configurar os parâmetros do banco de dados do AlloyDB Omni

Para configurar um parâmetro de banco de dados para o AlloyDB Omni, atualize os parâmetros de configuração unificada (GUC, na sigla em inglês) em uma das seguintes opções:

• O arquivo postgresql.conf para ambientes que executam o AlloyDB Omni em uma VM.

• O manifesto do cluster de banco de dados para ambientes que executam o AlloyDB Omni em um cluster do Kubernetes.

Atualizar um parâmetro no AlloyDB Omni contêinerizado

Em um AlloyDB Omni executado em uma VM, é possível atualizar um parâmetro editando o arquivo postgresql.conf da seguinte maneira:

1. Localize o arquivo de configuração postgresql.conf para a instalação do AlloyDB Omni.

2. Use um editor de texto para adicionar ou atualizar uma flag de banco de dados em postgresql.conf.

   Por exemplo, para forçar a expiração de senha, defina a seguinte flag no arquivo postgresql.conf:

   password.enforce_expiration = ON
   

3. Depois que as flags do banco de dados forem adicionadas ou editadas, recarregue o arquivo postgresql.conf para que as mudanças entrem em vigor. Por exemplo, se você instalou o AlloyDB Omni usando o Docker, execute o seguinte para reiniciar a instância do Docker e recarregar postgresql.conf:

   docker restart CONTAINER-NAME

Para mais informações, consulte Definição de parâmetros na documentação do PostgreSQL.

Atualizar um parâmetro no AlloyDB Omni em um cluster do Kubernetes

É possível configurar parâmetros de banco de dados usando o campo parameters na seção primarySpec do manifesto do cluster do banco de dados:

spec:
  primarySpec:
    parameters:
      "PARAMETER_NAME": "PARAMETER_VALUE"
      ...

Substitua:

• PARAMETER_NAME: o nome do parâmetro, por exemplo, autovacuum.
• PARAMETER_VALUE: o valor do parâmetro, por exemplo, off.

Observação: repita a linha de código PARAMETER_NAME": "PARAMETER_VALUE para cada par de nome-valor que você tiver.

Alguns parâmetros exigem que você reinicie o cluster para que as mudanças entrem em vigor. É possível acessar uma lista de parâmetros que exigem uma reinicialização em pg_catalog.pg_settings. Qualquer parâmetro com pg_catalog.pg_settings.context = 'postmaster' requer uma reinicialização.

Para atualizar os parâmetros do banco de dados, execute o seguinte comando:

kubectl patch dbclusters.alloydbomni.dbadmin.goog dbcluster-sample -p '{"spec":{"primarySpec":{"parameters": {"PARAMETER_NAME": "PARAMETER_VALUE"}}}}' --type=merge

Observação: para parâmetros que exigem uma reinicialização, a atualização dos parâmetros reinicia o banco de dados automaticamente.

As configurações de parâmetro estão localizadas na parte status do campo currentParameters.

Para conferir os parâmetros do banco de dados, execute o seguinte:

kubectl get dbclusters.alloydbomni.dbadmin.goog dbcluster-sample -o jsonpath={.status.primary.currentParameters}

A saída será assim:

{"autovacuum":"off","max_connections":"3000"}

Se o AlloyDB Omni não puder aplicar os parâmetros solicitados no manifesto do cluster do banco de dados, os valores do campo currentParameters poderão ser diferentes dos valores no campo parameters do manifesto. Por exemplo, você aplica um parâmetro inexistente ou define um valor de string para um parâmetro inteiro.