Configura los parámetros de la base de datos de AlloyDB Omni

Para configurar un parámetro de base de datos para AlloyDB Omni, puedes actualizar los parámetros de configuración unificada general (GUC) en cualquiera de las siguientes ubicaciones:

  • El archivo postgresql.conf para entornos que ejecutan AlloyDB Omni en una VM

  • El manifiesto del clúster de bases de datos para entornos que ejecutan AlloyDB Omni en un clúster de Kubernetes

Cómo actualizar un parámetro en AlloyDB Omni en contenedor

En un AlloyDB Omni que se ejecuta en una VM, puedes actualizar un parámetro editando el archivo postgresql.conf de la siguiente manera:

  1. Busca el archivo de configuración postgresql.conf de tu instalación de AlloyDB Omni.

  2. Usa un editor de texto para agregar o actualizar una marca de base de datos en postgresql.conf.

    Por ejemplo, para aplicar el vencimiento de la contraseña, establece la siguiente marca en el archivo postgresql.conf:

    password.enforce_expiration = ON

  3. Después de agregar o editar las marcas de la base de datos, vuelve a cargar el archivo postgresql.conf para que se apliquen los cambios. Por ejemplo, si instalaste AlloyDB Omni con Docker, ejecuta lo siguiente para reiniciar tu instancia de Docker y volver a cargar postgresql.conf:

    docker restart CONTAINER-NAME

Para obtener más información, consulta Cómo configurar parámetros en la documentación de PostgreSQL.

Actualiza un parámetro en AlloyDB Omni en un clúster de Kubernetes

Puedes configurar los parámetros de la base de datos con el campo parameters en la sección primarySpec del manifiesto del clúster de la base de datos:

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

Reemplaza lo siguiente:

  • PARAMETER_NAME: Es el nombre del parámetro, por ejemplo, autovacuum.
  • PARAMETER_VALUE: Es el valor del parámetro, por ejemplo, off.

Algunos parámetros requieren que reinicies el clúster para que se apliquen los cambios. Puedes obtener una lista de los parámetros que requieren un reinicio desde pg_catalog.pg_settings. Cualquier parámetro con pg_catalog.pg_settings.context = 'postmaster' requiere un reinicio.

Para actualizar los parámetros de la base de datos, ejecuta el siguiente comando:

kubectl patch dbclusters.alloydbomni.dbadmin.goog dbcluster-sample -p '{"spec":{"primarySpec":{"parameters": {"PARAMETER_NAME": "PARAMETER_VALUE"}}}}' --type=merge

La configuración de parámetros se encuentra en la parte status del campo currentParameters.

Para ver los parámetros de la base de datos, ejecuta lo siguiente:

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

El resultado es similar al siguiente:

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

Si AlloyDB Omni no puede aplicar los parámetros que solicitas en el manifiesto del clúster de bases de datos, los valores del campo currentParameters pueden diferir de los valores del campo parameters de tu manifiesto. Por ejemplo, aplicas un parámetro inexistente o estableces un valor de cadena en un parámetro de número entero.