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) en el manifiesto del clúster de base de datos (DBCluster) para los entornos que ejecutan AlloyDB Omni en un clúster de Kubernetes. Para obtener una lista de las marcas compatibles, consulta Marcas de base de datos compatibles.

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 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 los 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 a lo siguiente:

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

Si AlloyDB Omni no puede aplicar las actualizaciones solicitadas, el resultado mostrará los valores actuales y los solicitados por separado. Por ejemplo, esta diferencia puede ocurrir si aplicas un parámetro inexistente o estableces un valor de cadena para un parámetro de número entero.

Audita los parámetros de la base de datos con la IU web

Puedes auditar las marcas de base de datos activas y, además, identificar los parámetros personalizados que difieren de los valores predeterminados del motor con la página Marcas de base de datos en la interfaz de usuario web de AlloyDB Omni.

Para auditar los parámetros de la base de datos en la IU web, completa los siguientes pasos:

  1. Conéctate a la IU web y selecciona tu clúster.
  2. En el menú de navegación, haz clic en Marcas de base de datos.
  3. Usa los siguientes controles para buscar y filtrar parámetros:
    • Buscar marcas: Ingresa una palabra clave (por ejemplo, max) para filtrar los parámetros por nombre.
    • Mostrar marcas modificadas: Selecciona esta casilla de verificación para mostrar solo los parámetros cuyos valores activos difieren de los valores predeterminados del motor. Los valores personalizados también se destacan en amarillo en la columna Valor actual.
    • Contraer todo o Expandir todo: Contrae o expande los grupos de categorías de parámetros (como Opciones de Google AlloyDB, Valores predeterminados de conexión del cliente/Configuración regional y formato, Valores predeterminados de conexión del cliente/Otros valores predeterminados y Valores predeterminados de conexión del cliente/Precarga de biblioteca compartida).
  4. Revisa las columnas de la tabla de parámetros dentro de cada grupo de categorías:
    • Parámetro: Es el nombre del parámetro de la base de datos.
    • Tipo: Es el tipo de datos del parámetro (por ejemplo, INTEGER).
    • Valor actual: Es el valor activo del parámetro en la instancia (se destaca en amarillo si se modificó el valor predeterminado).
    • Valor predeterminado: Es el valor predeterminado del motor para el parámetro.
    • Se requiere reiniciar: Indica si la modificación del parámetro requiere un reinicio de la base de datos (true o false).
    • Fuente: Es la fuente de configuración del valor actual (por ejemplo, default).