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 para o AlloyDB Omni, é possível atualizar os parâmetros da Grand Unified Configuration (GUC) de uma das seguintes maneiras:

  • 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êiner

Em um AlloyDB Omni em execução 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 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 comando 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 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' 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âmetros estão localizadas na parte status do campo currentParameters.

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

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 inexistente ou define um valor de string para um parâmetro inteiro.