Actualizar los atributos del clúster de 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 del usuario administrador
  • Conexiones externas (habilitadas o inhabilitadas)
  • Nivel de disponibilidad (solo AlloyDB Omni y PostgreSQL)
  • Copia de seguridad habilitada y días de conservación de la copia de seguridad
  • Marcas de bases de datos
  • CPU, memoria o almacenamiento asignados al clúster de base de datos

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

Consola

Alta disponibilidad

En el caso de los clústeres de bases de datos AlloyDB Omni y PostgreSQL, habilita o inhabilita la alta disponibilidad en la misma zona. Para obtener más información, consulta la sección Configurar la alta disponibilidad.

Protección de Datos

En todos los tipos de clústeres de bases de datos, puede 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 automatizadas están habilitadas, también puedes configurar durante cuánto tiempo se conservarán.
  2. Después de hacer los cambios, haz clic en Guardar para que se apliquen a tu clúster de base de datos.

Connectivity

En todos los tipos de clúster de bases de datos, puede elegir si se puede acceder al clúster de bases de datos solo desde el 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 configuraciones de conectividad.
  3. Haz clic en Guardar para aplicar los cambios.

Instancias

En 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 editar Editar.
  2. Elige entre las configuraciones Alto rendimiento, Estándar, Mínimo o Personalizado. La opción Personalizado te permite elegir el número de CPUs, la memoria y el almacenamiento de tu instancia principal.

  3. Si actualizas la CPU, la memoria o el almacenamiento de tu instancia principal, tendrás que reiniciarla. Selecciona Guardar y reiniciar para aplicar los cambios.

En todos los tipos de clúster de bases de datos, este formulario también te permite añadir, modificar o quitar marcas de bases de datos. GDC predetermina el conjunto de marcas disponibles. Para obtener más información, consulta la sección Configurar marcas de bases de datos.

CLI de gdcloud

Usa el siguiente comando para actualizar un clúster de base de datos: sh gdcloud database clusters update CLUSTER_NAME [options]

Haz los cambios siguientes:

  • CLUSTER_NAME con el nombre del clúster de base de datos que se va a actualizar.

Para ver la lista completa de opciones, consulta la referencia de comandos o ejecuta sh gdcloud database clusters update --help

API

Protección de Datos

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

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

Sustituye las siguientes variables:

  • DBENGINE_NAME: el nombre del motor de la base de datos. Puede ser alloydbomni,postgresql o oracle.
  • DBCLUSTER_NAME: el nombre del clúster de bases de datos para el que se va a habilitar la protección de datos.
  • USER_PROJECT: el nombre del proyecto de usuario en el que se creará el clúster de bases de datos.
  • RETENTION_DAYS: número de días durante los que el operador de AlloyDB Omni conserva esta copia de seguridad. Debe ser un número entero entre 1 y 90.

También puede configurar ajustes de protección de datos, como los días de conservación, editando el recurso BackupPlan correspondiente.

Para desactivar la protección de datos de un clúster de bases de datos, elimina el recurso BackupPlan correspondiente que hayas creado anteriormente.

Configurar marcas de bases de datos

Las imágenes de la base de datos que se incluyen con GDC tienen ajustes 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 definir mediante la consola de GDC o la CLI de gdcloud:

Consola

  1. En el menú de navegación, selecciona Database Service (Servicio de bases de datos).

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

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

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

  4. En la sección Marcas, haga clic en Añadir marca de base de datos.

  5. Elige la marca e introduce el valor. Si el valor que introduces no es válido, la consola de GDC te indica cómo cumplir el intervalo o el tipo de valor necesarios.

  6. Haz clic en Listo.

  7. Para definir la configuración, haz clic en Guardar. Para que algunas marcas surtan efecto, debes reiniciar el clúster de bases de datos. En este caso, haz clic en Guardar y reiniciar.

  8. Para confirmar que se ha definido la nueva marca, vuelve a la sección Instancias de tu clúster de base de datos y comprueba que la nueva marca y el valor se muestran.

Para editar las marcas de la base de datos, vuelva a la sección Marcas y modifique las marcas que ya haya. Coloca el cursor sobre un componente de marca y haz clic en el icono Eliminar para quitar una marca de base de datos.

gdcloud

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

  • Para configurar una marca de base de datos en tu clúster de base de datos, ejecuta el siguiente comando:

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

    Haz los cambios siguientes:

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

    Por ejemplo, el siguiente comando define 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 ver una lista de las marcas de bases de datos disponibles, consulta Marcas de bases de datos disponibles.

  • Para restablecer todos los indicadores de la base de datos a sus ajustes predeterminados, ejecuta el siguiente comando:

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

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

API

  • Para configurar marcas de bases de datos en tu clúster de bases de datos, ejecuta el siguiente comando:

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

    Sustituye las siguientes variables:

    • DBENGINE_NAME: el nombre del motor de la base de datos. Es uno de los valores alloydbomni, postgresql o oracle.
    • DBCLUSTER_NAME: el nombre del clúster de la base de datos.
    • USER_PROJECT: el nombre del proyecto de usuario en el que se creó el clúster de base de datos.
    • DB_FLAGS: los parámetros de configuración de la base de datos que se van a añadir o actualizar. Debe ser un objeto con formato JSON de pares clave-valor, donde las claves son los nombres de los parámetros de la base de datos y los valores son sus ajustes respectivos. Por ejemplo, el siguiente conjunto de marcas de bases de datos:
    "autovacuum": "on", "autovacuum_analyze_threshold": "2147483647", "dbs.enable_anon": "on"
    

    Para ver una lista de las marcas de bases de datos disponibles, consulta Marcas de bases de datos disponibles.

  • Para restablecer todos los indicadores de la base de datos a sus ajustes predeterminados, ejecuta el siguiente comando:

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

    Sustituye las siguientes variables:

    • DBENGINE_NAME: el nombre del motor de la base de datos. Es uno de los valores alloydbomni, postgresql o oracle.
    • DBCLUSTER_NAME: el nombre del clúster de la base de datos.
    • USER_PROJECT: el nombre del proyecto de usuario en el que se creó el clúster de base de datos.

Marcas de bases de datos disponibles

Las marcas de base de datos disponibles que puedes configurar para tu clúster de base de datos se proporcionan a continuación en función del motor de base de datos que hayas configurado.

Marcas de la base de datos PostgreSQL

Bandera Intervalo Tipo Es necesario reiniciar
max_connections [1, 262143] Entero TRUE
temp_file_limit [1048576, 2147483647] Entero FALSO
log_min_duration_statement [-1, 2147483647] Entero FALSO
log_connections Activado y Desactivado Booleano FALSO
log_lock_waits Activado y Desactivado Booleano FALSO
log_disconnections Activado y Desactivado Booleano FALSO
log_checkpoints Activado y Desactivado Booleano FALSO
log_temp_files [-1, 2147483647] Entero FALSO
log_statement none, ddl, mod, all Enum FALSO
pgaudit.log read, write, function, role, ddl, misc, misc_set,
all, none , -read, -write, -function, -role, -ddl,
-misc, -misc_set, -all, -none
Cadena repetida FALSO
work_mem [64, 2147483647] Entero FALSO
autovacuum Activado y Desactivado Booleano FALSO
maintenance_work_mem [1024, 2147483647] Entero FALSO
random_page_cost [0, 2147483647] Flotante FALSO
log_min_messages debug5, debug4, debug3, debug2, debug1, info
notice, warning, error, log, fatal, panic
Enum FALSO
idle_in_transaction_session_timeout [0, 2147483647] Entero FALSO
max_wal_size [2, 2147483647],. Entero FALSO
autovacuum_vacuum_scale_factor [0, 100] Flotante FALSO
log_autovacuum_min_duration [-1, 2147483647] Entero FALSO
autovacuum_vacuum_cost_limit [-1, 10000] Entero FALSO
autovacuum_max_workers [1, 262143] Entero TRUE
autovacuum_analyze_scale_factor [0, 100] Flotante FALSO
track_activity_query_size [100, 1048576] Entero TRUE
log_duration Activado y Desactivado Booleano FALSO
autovacuum_vacuum_cost_delay [-1, 100] Entero FALSO
checkpoint_completion_target [0, 1] Flotante FALSO
log_statement_stats Activado y Desactivado Booleano FALSO
max_worker_processes [8, 4096] Entero TRUE
log_min_error_statement debug5, debug4, debug3, debug2, debug1, info,
notice, warning, error, log, fatal, panic
Enum FALSO
default_statistics_target [1, 10000] Entero FALSO
checkpoint_timeout [30, 86400] Entero FALSO
wal_buffers [-1, 262143 ] Entero TRUE
effective_cache_size [1, 2147483647] Entero FALSO
autovacuum_work_mem [1, 2147483647] Entero FALSO
log_hostname Activado y Desactivado Booleano FALSO
autovacuum_vacuum_threshold [0, 2147483647] Entero FALSO
autovacuum_naptime [1, 2147483] Entero FALSO
autovacuum_analyze_threshold [0, 2147483647] Entero FALSO
pgaudit.log_client Activado y Desactivado Booleano FALSO
pgaudit.log_parameter Activado y Desactivado Booleano FALSO
pgaudit.log_level debug5, debug4, debug3, debug2, debug1, info,
notice, warning, error, log
Enum FALSO
pgaudit.log_relation Activado y Desactivado Booleano FALSO
pgaudit.log_catalog Activado y Desactivado Booleano FALSO
pgaudit.role Cadena FALSO
autovacuum_freeze_max_age [100000, 2000000000] Entero TRUE
autovacuum_multixact_freeze_max_age [10000, 2000000000] Entero TRUE
pgaudit.log_statement_once Activado y Desactivado Booleano FALSO
anon.algorithm Cadena FALSO
anon.maskschema Cadena FALSO
anon.restrict_to_trusted_schemas Activado y Desactivado Booleano FALSO
anon.salt Cadena FALSO
anon.sourceschema Cadena FALSO
dbs.enable_anon activado o desactivado Booleano TRUE
dbs.enable_pg_bigm activado o desactivado Booleano TRUE
dbs.enable_pg_cron activado o desactivado Booleano TRUE
dbs.enable_pg_hint_plan activado o desactivado Booleano TRUE
dbs.enable_pg_wait_sampling activado o desactivado Booleano TRUE
pg_bigm.enable_recheck Activado y Desactivado Booleano FALSO
pg_bigm.gin_key_limit [0, 2147483647] Entero FALSO
pg_bigm.similarity_limit [0, 1] 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 Activado y Desactivado Booleano FALSO
pg_hint_plan.enable_hint_table Activado y Desactivado 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] Entero TRUE
pg_stat_statements.save Activado y Desactivado Booleano FALSO
pg_stat_statements.track none, top, all Enum FALSO
pg_stat_statements.track_utility Activado y Desactivado Booleano FALSO
pg_wait_sampling.history_period [1, 2147483647] Entero FALSO
pg_wait_sampling.history_size [1, 2147483647] Entero FALSO
pg_wait_sampling.profile_period [1, 2147483647] Entero FALSO
pg_wait_sampling.profile_pid Activado y Desactivado Booleano FALSO
pg_wait_sampling.profile_queries Activado y Desactivado Booleano FALSO
pglogical.batch_inserts Activado y Desactivado Booleano TRUE
pglogical.conflict_log_level debug5, debug4, debug3, debug2, debug1, info, notice, warning, error, log, fatal y panic Enum FALSO
pglogical.conflict_resolution error, apply_remote, keep_local, last_update_wins, first_update_wins Enum FALSO
pglogical.extra_connection_options Cadena FALSO
pglogical.synchronous_commit Activado y Desactivado Booleano TRUE
pglogical.use_spi Activado y Desactivado Booleano TRUE
pgtt.enabled Activado y Desactivado Booleano FALSO
plv8.execution_timeout [1, 65536] Entero FALSO
plv8.memory_limit [256, 3096] Entero FALSO
plv8.start_proc Cadena FALSO
rdkit.agent_FP_bit_ratio [0, 3] Flotante FALSO
rdkit.avalon_fp_size [64, 9192] Entero FALSO
rdkit.dice_threshold [0, 1] Flotante FALSO
rdkit.difference_FP_weight_agents [-10, 10] Entero FALSO
rdkit.difference_FP_weight_nonagents [1, 20] Entero FALSO
rdkit.do_chiral_sss Activado y Desactivado Booleano FALSO
rdkit.do_enhanced_stereo_sss Activado y Desactivado Booleano FALSO
rdkit.featmorgan_fp_size [64, 9192] Entero FALSO
rdkit.hashed_atompair_fp_size [64, 9192] Entero FALSO
rdkit.hashed_torsion_fp_size [64, 9192] Entero FALSO
rdkit.ignore_reaction_agents Activado y Desactivado Booleano FALSO
rdkit.init_reaction Activado y Desactivado Booleano FALSO
rdkit.layered_fp_size [64, 9192] Entero FALSO
rdkit.morgan_fp_size [64, 9192] Entero FALSO
rdkit.move_unmmapped_reactants_to_agents Activado y Desactivado Booleano FALSO
rdkit.rdkit_fp_size [64, 9192] Entero FALSO
rdkit.reaction_difference_fp_size [64, 9192] Entero FALSO
rdkit.reaction_difference_fp_type [1, 3] Entero FALSO
rdkit.reaction_sss_fp_size [64, 9192] Entero FALSO
rdkit.reaction_sss_fp_type [1, 5] Entero FALSO
rdkit.sss_fp_size [64, 4096] Entero FALSO
rdkit.tanimoto_threshold [0, 1] Flotante FALSO
rdkit.threshold_unmapped_reactant_atoms [0, 1] Flotante FALSO

En la siguiente tabla se especifican los valores predeterminados de las marcas que son diferentes de los valores predeterminados del proveedor:

Bandera Valor o fórmula
shared_buffers 1/3 * totalMemory(MiB)
max_wal_size 1504 MB
max_connections Memoria total >= ? Valor
120 GB 1000
60 GB 800
15 GB 500
7,5 GB 400
6 GB 200
3,75 GB 100
1,7 GB 50
0 25
effective_cache_size 2/5 * totalMemory
temp_file_limit 1/10 * storageSize
log_connections activado
log_disconnections activado
pgaudit.log all, -misc
log_hostname activado
pgaudit.log_parameter activado

Marcas de bases de datos de Oracle

Bandera Intervalo Tipo Es necesario reiniciar
aq_tm_processes [0, 40] Entero FALSO
background_core_dump COMPLETO, PARCIAL Enum FALSO
bitmap_merge_area_size [0, 2147483647] Entero TRUE
control_management_pack_access NINGUNO, DIAGNÓSTICO, DIAGNÓSTICO+AJUSTE Enum FALSO
cursor_sharing FUERZA, EXACTA, SIMILAR Enum FALSO
db_cache_size [0, 10995116277760] Entero FALSO
db_files [200, 20000] Entero TRUE
db_flashback_retention_target [30, 2147483647] Entero FALSO
db_keep_cache_size [0, 10995116277760] Entero FALSO
db_recovery_file_dest_size [0, 10995116277760] Entero FALSO
evento Cadena TRUE
large_pool_size [0, 10995116277760] Entero FALSO
log_buffer [2097152, 10995116277760] Entero TRUE
open_cursors [5, 65535] Entero FALSO
pga_aggregate_limit [0, 10995116277760] Entero FALSO
pga_aggregate_target [10485760, 10995116277760] Entero FALSO
procesos [100, 20000] Entero TRUE
recyclebin ACTIVADO, DESACTIVADO Enum TRUE
resource_limit TRUE, FALSE Booleano FALSO
sec_max_failed_login_attempts [1, 2147483647] Entero TRUE
sga_max_size [377487360, 10995116277760] Entero TRUE
sga_target [377487360, 10995116277760] Entero FALSO
shared_pool_size [0, 10995116277760] Entero FALSO
undo_retention [0, 2147483647] Entero FALSO
global_names TRUE, FALSE Booleano FALSO
DBFIPS_140 TRUE, FALSE Booleano TRUE
parallel_max_servers [0, 32767] Entero FALSO
_fix_control Cadena FALSO
_sql_plan_directive_mgmt_control [0, 65535] Entero FALSO
_optimizer_dsdir_usage_control [0, 126] Entero FALSO
skip_unusable_indexes TRUE, FALSE Booleano FALSO

En la siguiente tabla se especifican los valores predeterminados de las marcas que son diferentes de los valores predeterminados del proveedor:

Bandera Valor o fórmula
sga_target 4/5* (totalMemory-1GiB)
pga_aggregate_target 1/5* (totalMemory-1GiB)
open_cursors 300
procesos 300
DBFIPS_140 TRUE
global_names TRUE

Marcas de bases de datos de AlloyDB Omni

Bandera Intervalo Tipo Es necesario reiniciar
google_columnar_engine.enabled Activado y Desactivado Booleano TRUE
google_columnar_engine.memory_size_in_mb [128, 2147483647] Entero TRUE
anon.algorithm Cadena FALSO
anon.maskschema Cadena FALSO
anon.restrict_to_trusted_schemas Activado y Desactivado Booleano FALSO
anon.salt Cadena FALSO
anon.sourceschema Cadena FALSO
dbs.enable_anon activado o desactivado Booleano TRUE
dbs.enable_pg_bigm activado o desactivado Booleano TRUE
dbs.enable_pg_cron activado o desactivado Booleano TRUE
dbs.enable_pg_hint_plan activado o desactivado Booleano TRUE
dbs.enable_pg_squeeze activado o desactivado Booleano TRUE
dbs.enable_pg_wait_sampling activado o desactivado Booleano TRUE
pg_bigm.enable_recheck Activado y Desactivado Booleano FALSO
pg_bigm.gin_key_limit [0, 2147483647] Entero FALSO
pg_bigm.similarity_limit [0, 1] 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 Activado y Desactivado Booleano FALSO
pg_hint_plan.enable_hint_table Activado y Desactivado 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] Entero TRUE
pg_stat_statements.save Activado y Desactivado Booleano FALSO
pg_stat_statements.track none, top, all Enum FALSO
pg_stat_statements.track_utility Activado y Desactivado Booleano FALSO
pg_wait_sampling.history_period [1, 2147483647] Entero FALSO
pg_wait_sampling.history_size [1, 2147483647] Entero FALSO
pg_wait_sampling.profile_period [1, 2147483647] Entero FALSO
pg_wait_sampling.profile_pid Activado y Desactivado Booleano FALSO
pg_wait_sampling.profile_queries Activado y Desactivado Booleano FALSO
pgaudit.log read, write, function, role, ddl, misc, misc_set,
all, none , -read, -write, -function, -role, -ddl,
-misc, -misc_set, -all, -none
Cadena repetida FALSO
pgaudit.log_client Activado y Desactivado Booleano FALSO
pgaudit.log_parameter Activado y Desactivado Booleano FALSO
pgaudit.log_level debug5, debug4, debug3, debug2, debug1, info,
notice, warning, error, log
Enum FALSO
pgaudit.log_relation Activado y Desactivado Booleano FALSO
pgaudit.log_catalog Activado y Desactivado Booleano FALSO
pgaudit.role Cadena FALSO
pgaudit.log_statement_once Activado y Desactivado Booleano FALSO
pglogical.batch_inserts Activado y Desactivado Booleano TRUE
pglogical.conflict_log_level debug5, debug4, debug3, debug2, debug1, info, notice, warning, error, log, fatal y panic Enum FALSO
pglogical.conflict_resolution error, apply_remote, keep_local, last_update_wins, first_update_wins Enum FALSO
pglogical.extra_connection_options Cadena FALSO
pglogical.synchronous_commit Activado y Desactivado Booleano TRUE
pglogical.use_spi Activado y Desactivado Booleano TRUE
pgtt.enabled Activado y Desactivado Booleano FALSO
plv8.execution_timeout [1, 65536] Entero FALSO
plv8.memory_limit [256, 3096] Entero FALSO
plv8.start_proc Cadena FALSO