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 de AlloyDB Omni.

Los parámetros de la base de datos, también conocidos como parámetros de configuración unificada general (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. Instalado el organizador de AlloyDB Omni.
  2. Tu clúster de AlloyDB Omni aprovisionado y creado

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 de recursos DBCluster.

Actualiza la especificación de recursos

Agrega los parámetros obligatorios y sus valores a la especificación de recursos DBCluster:

DBCluster:
  metadata:
    name: CLUSTER_NAME
  spec:
    primarySpec:
      # ... other settings ...
      parameters:
        max_wal_size: "MAX_WAL_SIZE"
        max_connections: "MAX_CONNECTIONS_LIMIT"

Reemplaza lo siguiente:

  • CLUSTER_NAME: Es el nombre de tu clúster de base de datos.
  • MAX_WAL_SIZE: Es el tamaño máximo que puede alcanzar la WAL entre los puntos de control de WAL automáticos, por ejemplo, 2GB.
  • MAX_CONNECTIONS_LIMIT: Es 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.

Parámetros admitidos durante la creación del clúster

Puedes configurar los siguientes parámetros de la base de datos (GUC) en la especificación de recursos DBCluster durante la creación del clúster:

  • log_connections
  • log_disconnections
  • log_hostname
  • log_statement
  • max_connections
  • max_wal_size
  • huge_pages
  • tcp_keepalives_idle
  • tcp_keepalives_interval
  • tcp_keepalives_count

No puedes configurar parámetros, como shared_buffers, que no se incluyen en esta lista con la especificación DBCluster. En cambio, debes actualizarlos de forma manual después de crear el clúster.

Aplica la configuración

Aplica los cambios con la interfaz del organizador que prefieras.

Ansible 

ansible-playbook -i DEPLOYMENT_SPECIFICATION DBCLUSTER_PLAYBOOK -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_PLAYBOOK: Es la ruta de acceso al libro de jugadas que creaste para tu clúster de base de datos.

  • DBCLUSTER_SPECIFICATION: Es la 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: Es la ruta de acceso a la especificación del clúster.

Actualiza los parámetros de la base de datos después de crear el clúster

Para actualizar los parámetros después de crear el clúster, debes modificar manualmente los archivos de configuración en los nodos de la base de datos.

Actualiza los parámetros en un clúster de alta disponibilidad

Para actualizar manualmente los parámetros de la base de datos en un clúster de alta disponibilidad (HA), completa los siguientes pasos:

  1. Si availability.enableAutoFailover y availability.enableAutoHeal se establecen en true en el archivo de especificación DBCluster, establécelos en false.

    DBCluster:
  metadata:
    name: my-db-cluster
  spec:
    databaseVersion: 18.1.0
    mode: ""
    availability:
      ...
      enableAutoFailover: false
      enableAutoHeal: false
      ...

    Aplica la especificación de recursos actualizada con la interfaz que prefieras.

  2. En cada nodo de la base de datos, edita el 30startup.conf archivo en el siguiente directorio: DATA_DISK_PATH/18/db/postgresql.conf.d/.

    Reemplaza DATA_DISK_PATH por el valor del campo path del disco llamado DataDisk en la especificación de recursos DBCluster.

    Ejemplo de especificación de DBCluster:

    DBCluster:
  spec:
    primarySpec:
      resources:
        disks:
        - name: DataDisk
          path: /var/lib/alloydbomni/data  # This is your DATA_DISK_PATH

  3. Agrega o actualiza las configuraciones de los parámetros de la base de datos en el archivo 30startup.conf. Para obtener más información, consulta la documentación de PostgreSQL.

  4. Reinicia el servicio de la base de datos en todos los nodos:

    sudo systemctl restart alloydbomni18

  5. Si modificaste los campos availability.enableAutoFailover y availability.enableAutoHeal en la especificación de recursos DBCluster, revierte a sus valores originales y aplica los cambios.

Actualiza los parámetros en un clúster independiente

Para actualizar manualmente los parámetros de la base de datos en un clúster independiente, completa los siguientes pasos:

  1. En el nodo de la base de datos, actualiza el 30startup.conf archivo en el siguiente directorio: DATA_DISK_PATH/18/db/postgresql.conf.d/.

    Reemplaza DATA_DISK_PATH por la ruta de acceso del sistema de archivos definida para tu DataDisk en la especificación de recursos DBCluster.

  2. Agrega o actualiza las configuraciones de los parámetros de la base de datos en el archivo 30startup.conf.

  3. Reinicia el servicio de la base de datos:

    sudo systemctl restart alloydbomni18

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.