Configure os parâmetros da base de dados do AlloyDB Omni

Selecione uma versão da documentação:

Para configurar um parâmetro de base de dados para o AlloyDB Omni, pode atualizar os parâmetros de configuração unificada geral (GUC) de uma das seguintes formas:

  • O ficheiro postgresql.conf para ambientes que executam o AlloyDB Omni numa VM.

  • O manifesto do cluster de base de dados para ambientes que executam o AlloyDB Omni num cluster do Kubernetes.

Atualize um parâmetro no AlloyDB Omni contentorizado

Num AlloyDB Omni em execução numa VM, pode atualizar um parâmetro editando o ficheiro postgresql.conf da seguinte forma:

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

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

    Por exemplo, para aplicar a expiração da palavra-passe, defina a seguinte flag no ficheiro postgresql.conf:

    password.enforce_expiration = ON

  3. Depois de adicionar ou editar as flags da base de dados, recarregue o postgresql.conf ficheiro para que as alterações entrem em vigor. Por exemplo, se instalou o AlloyDB Omni através do Docker, execute o seguinte para reiniciar a instância do Docker e recarregar o postgresql.conf:

    docker restart CONTAINER-NAME

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

Atualize um parâmetro no AlloyDB Omni num cluster do Kubernetes

Pode configurar parâmetros da base de dados através do campo parameters na secção primarySpec do manifesto do cluster da base de dados:

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

Substitua o seguinte:

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

Alguns parâmetros requerem que reinicie o cluster para que as alterações entrem em vigor. Pode obter uma lista de parâmetros que requerem um reinício a partir de pg_catalog.pg_settings. Qualquer parâmetro com pg_catalog.pg_settings.context = 'postmaster' requer um reinício.

Para atualizar os parâmetros da base 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 definições de parâmetros estão localizadas na parte status do campo currentParameters.

Para ver os parâmetros da base de dados, execute o seguinte:

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

O resultado tem um aspeto semelhante ao seguinte:

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

Se o AlloyDB Omni não conseguir aplicar os parâmetros que pede no manifesto do cluster de base de dados, os valores do campo currentParameters podem diferir dos valores no campo parameters do manifesto. Por exemplo, aplica um parâmetro inexistente ou define um valor de string para um parâmetro inteiro.