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

Selecciona una versión de la documentación:

Para configurar un parámetro de base de datos para AlloyDB Omni, puedes actualizar los parámetros de Grand Unified Configuration (GUC) de cualquiera de las siguientes maneras:

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

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

Actualiza un parámetro en AlloyDB Omni en contenedores

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. Ubica el archivo de configuración postgresql.conf para 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 forzar 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 los cambios surtan efecto. 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 parámetros de base de datos con el campo parameters en la sección primarySpec del manifiesto del clúster de base de datos:

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

Reemplaza lo siguiente:

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

Algunos parámetros requieren que reinicies el clúster para que los cambios surtan efecto. Puedes obtener una lista de parámetros que requieren un reinicio de 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 los 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 base 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.