Actualiza los atributos del clúster de la base de datos

Puedes cambiar los siguientes atributos del clúster de base de datos con la consola de GDC o la CLI de gdcloud:

  • Contraseña de la base de datos para el usuario administrador
  • Conexiones externas (habilitadas o inhabilitadas)
  • Nivel de disponibilidad
  • Copia de seguridad habilitada y días de retención de la copia de seguridad
  • Marcas de bases de datos
  • CPU, memoria o almacenamiento asignados al clúster de la base de datos

Para obtener información sobre cómo modificar un atributo, consulta el flujo de trabajo correspondiente al tipo de atributo que deseas actualizar:

Console

Alta disponibilidad

Habilita o inhabilita la alta disponibilidad en la misma zona. Consulta la sección Configura la alta disponibilidad para obtener más información.

Protección de datos

Para todos los tipos de clústeres de bases de datos, puedes habilitar o inhabilitar la protección de datos:

  1. Ve a Protección de datos y haz clic en Editar Editar para acceder al formulario de configuración de protección de datos. Si las copias de seguridad automáticas están habilitadas, también puedes configurar el tiempo que se conservarán.
  2. Después de realizar los cambios, haz clic en Guardar para que las actualizaciones se apliquen a tu clúster de base de datos.

Conectividad

Para todos los tipos de clústeres de bases de datos, puedes elegir si se puede acceder al clúster de bases de datos solo desde dentro del proyecto de GDC o si también se puede acceder desde fuera del proyecto:

  1. Ve a Conectividad y haz clic en editar Editar.
  2. Actualiza tus parámetros de configuración de conectividad.

  3. Haz clic en Guardar para aplicar los cambios.

Instancias

Para todos los tipos de clústeres de bases de datos, puedes editar las propiedades de la instancia principal:

  1. Ve a Instancia principal y haz clic en edit Editar.

  2. Elige entre los parámetros de configuración Alto rendimiento, Estándar, Mínimo o Personalizado. La opción Personalizado te permite elegir la cantidad de CPU, memoria y almacenamiento para tu instancia principal.

  3. Si actualizas la CPU, la memoria o el almacenamiento de la instancia principal, se requerirá un reinicio. Selecciona Guardar y reiniciar para aplicar los cambios.

En todos los tipos de clústeres de bases de datos, este formulario también te permite agregar, modificar o quitar marcas de bases de datos. El conjunto de marcas disponibles está predeterminado por GDC. Consulta la sección Configura marcas de base de datos para obtener más información.

gdcloud

Usa el siguiente comando para actualizar un clúster de base de datos:

gdcloud database clusters update CLUSTER_NAME [options]

Reemplaza CLUSTER_NAME por el nombre del clúster de base de datos que deseas actualizar.

Para ver la lista completa de opciones, consulta la referencia de comandos o ejecuta lo siguiente:

gdcloud database clusters update --help

API

Protección de datos

En todos los tipos de clústeres de bases de datos, puedes habilitar la función de protección de datos creando un recurso BackupPlan para ese clúster de bases de datos.

apiVersion: postgresql.dbadmin.gdc.goog/v1
kind: BackupPlan
metadata:
  name: DBCLUSTER_NAME-backupplan
  namespace: USER_PROJECT
spec:
  dbclusterRef: DBCLUSTER_NAME
  backupRetainDays: RETENTION_DAYS

Reemplaza las siguientes variables:

  • DBCLUSTER_NAME: Es el nombre del clúster de base de datos para el que deseas habilitar la protección de datos.
  • USER_PROJECT: Es el nombre del proyecto de usuario en el que se creará el clúster de la base de datos.
  • RETENTION_DAYS: Es la cantidad de días que el operador conserva esta copia de seguridad. Debe ser un número entero entre 1 y 90.

También puedes configurar los parámetros de protección de datos, como los días de retención, editando el recurso BackupPlan correspondiente.

Para desactivar la protección de datos de un clúster de bases de datos, borra el recurso BackupPlan correspondiente que se creó antes.

Restablece la contraseña del usuario administrador

En todos los tipos de clústeres de bases de datos, puedes restablecer la contraseña de la base de datos para el usuario administrador.

  1. Crea un Secret de contraseña.

    apiVersion: v1
kind: Secret
metadata:
  name: db-pw-DBCLUSTER_NAME
  namespace: USER_PROJECT
type: Opaque
data:
  DBCLUSTER_NAME: "BASE64_PASSWORD"

  2. Aplica un parche al DBCluster.

    kubectl patch dbcluster.postgresql.dbadmin.gdc.goog DBCLUSTER_NAME -p '{"spec":{"primarySpec": {"adminUser": {"passwordRef": {"name": "db-pw-DBCLUSTER_NAME"}}}}}' --type=merge -n USER_PROJECT

Reemplaza las siguientes variables:

  • DBCLUSTER_NAME: Es el nombre del clúster de la base de datos.
  • USER_PROJECT: Es el nombre del proyecto de usuario en el que se actualizará el clúster de la base de datos.
  • BASE64_PASSWORD: Es la codificación en Base64 de la contraseña de administrador de la base de datos.

La nueva contraseña tarda alrededor de un minuto en aplicarse.

Configurar marcas de bases de datos

Las imágenes de la base de datos que se envían con GDC incluyen parámetros de configuración predeterminados. Sin embargo, puedes personalizar el motor de base de datos predeterminado para satisfacer los requisitos de tus aplicaciones. Los clústeres de bases de datos proporcionan marcas predefinidas que puedes configurar con la consola de GDC o la gdcloud CLI:

Console

  1. En el menú de navegación, selecciona Database Service.

  2. En la lista de clústeres de bases de datos, haz clic en el clúster de bases de datos para el que deseas configurar las marcas de base de datos.

  3. En la sección Instancias en tu clúster de bases de datos, haz clic en Editar instancia principal.

    Edita tu clúster de base de datos principal para configurar las marcas.

  4. En la sección Marcas, haz clic en Agregar una marca de base de datos.

  5. Elige la marca y, luego, ingresa el valor. Si el valor que ingresas no es válido, la consola de GDC te dará instrucciones para cumplir con el rango o el tipo de valor requerido.

  6. Haz clic en Listo.

  7. Para establecer la configuración, haz clic en Guardar. Para que algunas marcas se apliquen, debes reiniciar el clúster de la base de datos. En este caso, haz clic en Guardar y reiniciar.

  8. Para confirmar que se estableció la marca nueva, regresa a la sección Instancias en tu clúster de base de datos de tu clúster de base de datos y verifica que la marca y el valor nuevos estén visibles.

Para editar las marcas de base de datos, vuelve a la sección Marcas y modifica las marcas existentes. Coloca el cursor sobre un componente de marca y haz clic en el ícono Borrar para quitar una marca de base de datos.

gdcloud

Puedes configurar marcas de base de datos nuevas para tu clúster o restablecer todas las marcas existentes a sus valores predeterminados:

  • Para configurar una marca de base de datos para tu clúster de base de datos, ejecuta lo siguiente:

    gdcloud database clusters update CLUSTER_NAME \
    --database-flags DB_FLAGS

    Reemplaza lo siguiente:

    • CLUSTER_NAME: Es el nombre del clúster de la base de datos.
    • DB_FLAGS: Es la lista separada por comas de las marcas de base de datos que se establecerán en la base de datos que se ejecuta en el clúster de base de datos. Cada marca de base de datos y valor se configuran como un par clave-valor. Las marcas sin un valor se pueden definir sin una cadena después del carácter =.

    Por ejemplo, el siguiente comando establece varias marcas de base de datos para test-db-cluster:

    gdcloud database clusters update test-db-cluster \
    --database-flags max_allowed_packet=55555,skip_grant_tables=,log_output=1

    Para obtener una lista de las marcas de base de datos disponibles, consulta Marcas de base de datos disponibles.

  • Para restablecer todas las marcas de la base de datos a su configuración predeterminada, ejecuta lo siguiente:

    gdcloud database clusters update CLUSTER_NAME --clear-database-flags

    Reemplaza CLUSTER_NAME por el nombre del clúster de base de datos.

API

  • Para configurar las marcas de base de datos de tu clúster de base de datos, ejecuta lo siguiente:

      kubectl patch dbcluster.postgresql.dbadmin.gdc.goog DBCLUSTER_NAME -p '{"spec":{"primarySpec": {"parameters": DB_FLAGS}}}' --type=merge -n USER_PROJECT

    Reemplaza las siguientes variables:

    • DBCLUSTER_NAME: Es el nombre del clúster de la base de datos.
    • USER_PROJECT: Es el nombre del proyecto de usuario en el que se creó el clúster de la base de datos.
    • DB_FLAGS: Son los parámetros de configuración de la base de datos que se agregarán o actualizarán. Debe ser un objeto con formato JSON de pares clave-valor, en el que las claves son los nombres de los parámetros de la base de datos y los valores son sus parámetros de configuración respectivos. Por ejemplo, en el siguiente comando, se configuran varias marcas de base de datos:
    "autovacuum": "on", "autovacuum_analyze_threshold": "2147483647", "dbs.enable_anon": "on"

    Para obtener una lista de las marcas de base de datos disponibles, consulta Marcas de base de datos disponibles.

  • Para restablecer todas las marcas de la base de datos a su configuración predeterminada, ejecuta lo siguiente:

    kubectl patch dbcluster.postgresql.dbadmin.gdc.goog DBCLUSTER_NAME --type=json -p='[{"op": "remove", "path": "/spec/primarySpec/parameters"}]' -n USER_PROJECT

    Reemplaza las siguientes variables:

    • DBCLUSTER_NAME: Es el nombre del clúster de la base de datos.
    • USER_PROJECT: Es el nombre del proyecto de usuario en el que se creó el clúster de la base de datos.

Marcas de bases de datos disponibles

Marca Rango Tipo Se debe reiniciar
google_columnar_engine.enabled on, off Booleano TRUE
google_columnar_engine.memory_size_in_mb [128, 2147483647] Número entero TRUE
anon.algorithm String FALSO
anon.maskschema String FALSO
anon.restrict_to_trusted_schemas on, off Booleano FALSO
anon.salt String FALSO
anon.sourceschema String FALSO
dbs.enable_anon on, off Booleano TRUE
dbs.enable_pg_bigm on, off Booleano TRUE
dbs.enable_pg_cron on, off Booleano TRUE
dbs.enable_pg_hint_plan on, off Booleano TRUE
dbs.enable_pg_squeeze on, off Booleano TRUE
dbs.enable_pg_wait_sampling on, off Booleano TRUE
pg_bigm.enable_recheck on, off Booleano FALSO
pg_bigm.gin_key_limit [0, 2147483647] Número entero FALSO
pg_bigm.similarity_limit [0, 1] Número de punto flotante FALSO
pg_hint_plan.debug_print off, on, detailed, verbose, 0, 1, 2, 3, no, yes, false, true Enum TRUE
pg_hint_plan.enable_hint on, off Booleano FALSO
pg_hint_plan.enable_hint_table on, off Booleano FALSO
pg_hint_plan.message_level debug5, debug4, debug3, debug2, debug1, debug, info, notice, warning, error, log Enum FALSO
pg_hint_plan.parse_messages debug5, debug4, debug3, debug2, debug1, debug, info, notice, warning, error, log Enum FALSO
pg_stat_statements.max [100, 2147483647] Número entero TRUE
pg_stat_statements.save on, off Booleano FALSO
pg_stat_statements.track none, top, all Enum FALSO
pg_stat_statements.track_utility on, off Booleano FALSO
pg_wait_sampling.history_period [1, 2147483647] Número entero FALSO
pg_wait_sampling.history_size [1, 2147483647] Número entero FALSO
pg_wait_sampling.profile_period [1, 2147483647] Número entero FALSO
pg_wait_sampling.profile_pid on, off Booleano FALSO
pg_wait_sampling.profile_queries on, off Booleano FALSO
pgaudit.log read, write, function, role, ddl, misc, misc_set,
all, none , -read, -write, -function, -role, -ddl,
-misc, -misc_set, -all, -none		 String repetida FALSO
pgaudit.log_client on, off Booleano FALSO
pgaudit.log_parameter on, off Booleano FALSO
pgaudit.log_level debug5, debug4, debug3, debug2, debug1, info,
notice, warning, error, log		 Enum FALSO
pgaudit.log_relation on, off Booleano FALSO
pgaudit.log_catalog on, off Booleano FALSO
pgaudit.role String FALSO
pgaudit.log_statement_once on, off Booleano FALSO
pglogical.batch_inserts on, off Booleano TRUE
pglogical.conflict_log_level debug5, debug4, debug3 , debug2, debug1 , info, notice , warning, error , log, fatal , panic Enum FALSO
pglogical.conflict_resolution error, apply_remote, keep_local, last_update_wins, first_update_wins Enum FALSO
pglogical.extra_connection_options String FALSO
pglogical.synchronous_commit on, off Booleano TRUE
pglogical.use_spi on, off Booleano TRUE
pgtt.enabled on, off Booleano FALSO
plv8.execution_timeout [1, 65536] Número entero FALSO
plv8.memory_limit [256, 3096] Número entero FALSO
plv8.start_proc String FALSO