Configura los parámetros de la base de datos

Selecciona una versión de la documentación:

En esta página, se describe cómo configurar los parámetros de la base de datos con el organizador RPM de AlloyDB Omni.

Los parámetros de la base de datos, también conocidos como parámetros de Grand Unified Configuration (GUC), te permiten ajustar el rendimiento y el comportamiento de tu clúster de base de datos de AlloyDB Omni. Para obtener más información, consulta Cómo configurar parámetros en la documentación de PostgreSQL.

Antes de comenzar

Antes de configurar los parámetros de la base de datos, asegúrate de tener lo siguiente:

  1. Instalaste el organizador de AlloyDB Omni.
  2. Aprovisionaste y creaste tu clúster de AlloyDB Omni.

Configura los parámetros de la base de datos

Para configurar los parámetros de la base de datos, usa el campo parameters dentro de la sección primarySpec de la especificación del recurso DBCluster.

Actualiza la especificación del recurso

Agrega o modifica los parámetros obligatorios y sus valores en la especificación del recurso DBCluster. Puedes hacerlo para configurar parámetros durante la creación del clúster o para actualizar parámetros después de que se crea el clúster.

En el siguiente fragmento, se muestran ejemplos de parámetros de GUC. Puedes configurar otros parámetros de base de datos compatibles de manera similar:

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 ...

Reemplaza lo siguiente:

  • CLUSTER_NAME: el nombre de tu clúster de base de datos.
  • MAX_WAL_SIZE: un parámetro de ejemplo que controla el tamaño máximo al que puede crecer la WAL entre los puntos de control de WAL automáticos, por ejemplo, 2GB.
  • MAX_CONNECTIONS_LIMIT: un parámetro de ejemplo que controla la cantidad máxima de conexiones simultáneas permitidas al servidor de la base de datos, por ejemplo, 200. El valor mínimo admitido es 50.
  • HUGE_PAGES: un parámetro de ejemplo que controla el uso de páginas enormes, por ejemplo, on.
  • LOG_STATEMENT: un parámetro de ejemplo que controla qué instrucciones de SQL se registran, por ejemplo, all.

Aplica la configuración

Aplica los cambios con la interfaz del organizador que prefieras.

Ansible

Si administras tu infraestructura del organizador RPM de AlloyDB Omni directamente con Ansible, se activan las actualizaciones cuando se ejecuta el playbook adecuado y se pasa el update_action seleccionado como una variable adicional.

Archivo de muestra 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

Ejecuta el comando de Ansible:

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

Reemplaza las siguientes variables:

  • DEPLOYMENT_SPECIFICATION: ruta de acceso a la especificación de implementación que creaste en Instala componentes de AlloyDB Omni.

  • DBCLUSTER_SPECIFICATION: ruta de acceso a la especificación del clúster.

alloydbctl 

alloydbctl apply -d DEPLOYMENT_SPECIFICATION -r DBCLUSTER_SPECIFICATION

Reemplaza las siguientes variables:

  • DEPLOYMENT_SPECIFICATION: ruta de acceso a la especificación de implementación que creaste en Instala componentes de AlloyDB Omni.

  • DBCLUSTER_SPECIFICATION: ruta de acceso a la especificación del clúster.

Verifica los cambios en los parámetros

Después de aplicar la configuración, puedes verificar que los parámetros se actualicen con el comando SHOW en psql:

SHOW PARAMETER_NAME;

Reemplaza PARAMETER_NAME por el nombre del parámetro que configuraste.