Configurar 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 de AlloyDB Omni, puede actualizar los parámetros de configuración unificada general (GUC) de cualquiera de las siguientes formas:

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

Actualizar un parámetro en AlloyDB Omni en contenedores

En una instancia de AlloyDB Omni que se ejecute 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 añadir o actualizar una marca de base de datos en postgresql.conf.

    Por ejemplo, para forzar la caducidad de la contraseña, define la siguiente marca en el archivo postgresql.conf:

    password.enforce_expiration = ON

  3. Después de añadir 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 Configuración de parámetros en la documentación de PostgreSQL.

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

Puede configurar los parámetros de la base de datos mediante el campo parameters de la sección primarySpec del manifiesto de su clúster de base de datos:

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

Haz los cambios siguientes:

  • 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 los parámetros que requieren un reinicio en 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

Los ajustes de los parámetros se encuentran 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 solicita en el manifiesto del clúster de base de datos, los valores del campo currentParameters pueden ser diferentes de los valores del campo parameters de su manifiesto. Por ejemplo, si aplica un parámetro que no existe o asigna un valor de cadena a un parámetro entero.