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

Selecione uma versão da documentação:

Para configurar um parâmetro de banco de dados do AlloyDB Omni, atualize os parâmetros da Grand Unified Configuration (GUC) em um dos seguintes locais:

  • 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 em contêineres

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 sua 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 aplicar o vencimento da senha, defina a seguinte flag no arquivo postgresql.conf:

    password.enforce_expiration = ON

  3. Depois que os flags do banco de dados forem adicionados ou editados, 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 Definir 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 de 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.

Alguns parâmetros exigem que você reinicie o cluster para que as mudanças entrem em vigor. É possível extrair uma lista de parâmetros que exigem uma reinicialização de pg_catalog.pg_settings. Qualquer parâmetro com pg_catalog.pg_settings.context = 'postmaster' exige 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

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 de 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 que não existe ou define um valor de string para um parâmetro inteiro.