Configurar parâmetros de banco de dados

Selecione uma versão da documentação:

Nesta página, descrevemos como configurar parâmetros de banco de dados usando o orquestrador RPM do AlloyDB Omni.

Os parâmetros de banco de dados, também conhecidos como parâmetros da Grand Unified Configuration (GUC, na sigla em inglês), permitem ajustar a performance e o comportamento do cluster de banco de dados do AlloyDB Omni. Para mais informações, consulte Definir parâmetros na documentação do PostgreSQL.

Antes de começar

Antes de configurar os parâmetros do banco de dados, verifique se você tem:

  1. Instalou o orquestrador do AlloyDB Omni.
  2. Provisionou e criou o cluster do AlloyDB Omni.

Configurar parâmetros de banco de dados

Para configurar os parâmetros do banco de dados, use o campo parameters na seção primarySpec da especificação do recurso DBCluster.

Atualizar a especificação do recurso

Adicione ou modifique os parâmetros necessários e os valores deles na especificação do recurso DBCluster. Você pode fazer isso para configurar parâmetros durante a criação do cluster ou para atualizar parâmetros depois que o cluster for criado.

O snippet a seguir mostra exemplos de parâmetros GUC. Você pode configurar outros parâmetros de banco de dados compatíveis da mesma forma:

DBCluster:
  metadata:
    name: CLUSTER_NAME
  spec:
    primarySpec:
      # ... other settings ...
      parameters:
        # ... existing parameters ...
        max_wal_size: "MAX_WAL_SIZE"
        max_connections: "MAX_CONNECTIONS_LIMIT"
        huge_pages: "HUGE_PAGES"
        log_statement: "LOG_STATEMENT"
        # ... other parameters ...

Substitua:

  • CLUSTER_NAME: o nome do cluster de banco de dados.
  • MAX_WAL_SIZE: um parâmetro de exemplo que controla o tamanho máximo que o WAL pode aumentar entre os checkpoints automáticos do WAL, por exemplo, 2GB.
  • MAX_CONNECTIONS_LIMIT: um parâmetro de exemplo que controla o número máximo de conexões simultâneas permitidas para o servidor de banco de dados, por exemplo, 200. O valor mínimo compatível é 50.
  • HUGE_PAGES: um parâmetro de exemplo que controla o uso de páginas enormes, por exemplo, on.
  • LOG_STATEMENT: um parâmetro de exemplo que controla quais instruções SQL são registradas, por exemplo, all.

Aplique a configuração

Aplique as mudanças usando a interface do orquestrador de sua preferência.

Ansible

Se você estiver gerenciando a infraestrutura do orquestrador RPM do AlloyDB Omni diretamente usando o Ansible, ele vai acionar atualizações executando o playbook apropriado e transmitindo o update_action selecionado como uma variável extra.

Arquivo de amostra para update.yml:

---
- hosts: localhost
  vars:
    update_action: "update_resource_spec"
    ansible_user: your_ssh_user
    ansible_ssh_private_key_file: ~/path/to/private-key
  roles:
    - role: google.alloydbomni_orchestrator.update

Execute o comando do Ansible:

ansible-playbook -i DEPLOYMENT_SPECIFICATION update.yml -e resource_spec="DBCLUSTER_SPECIFICATION"

Substitua as seguintes variáveis:

  • DEPLOYMENT_SPECIFICATION: caminho para a especificação de implantação criada em Instalar componentes do AlloyDB Omni.

  • DBCLUSTER_SPECIFICATION: caminho para a especificação do cluster.

alloydbctl 

alloydbctl apply -d DEPLOYMENT_SPECIFICATION -r DBCLUSTER_SPECIFICATION

Substitua as seguintes variáveis:

  • DEPLOYMENT_SPECIFICATION: caminho para a especificação de implantação criada em Instalar componentes do AlloyDB Omni.

  • DBCLUSTER_SPECIFICATION: caminho para a especificação do cluster.

Verificar mudanças de parâmetros

Depois de aplicar a configuração, você pode verificar se os parâmetros foram atualizados usando o comando SHOW em psql:

SHOW PARAMETER_NAME;

Substitua PARAMETER_NAME pelo nome do parâmetro configurado.