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 configuración unificada general (GUC) de cualquiera de las siguientes maneras:

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

  • Es el manifiesto del clúster de bases de datos para los 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. Busca 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 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 el siguiente comando 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.

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 los cambios surtan efecto. 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 el siguiente comando:

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.