Atualize os atributos do cluster da base de dados

Pode alterar os seguintes atributos do cluster de base de dados com a consola GDC ou a CLI gdcloud:

  • Palavra-passe da base de dados para o utilizador administrador
  • Ligações externas (ativadas/desativadas)
  • Nível de disponibilidade (apenas para o AlloyDB Omni e o PostgreSQL)
  • Cópia de segurança ativada e dias de retenção da cópia de segurança
  • Sinalizações de bases de dados
  • CPU, memória ou armazenamento atribuídos ao cluster de base de dados

Para obter informações sobre como modificar um atributo, consulte o fluxo de trabalho correspondente ao tipo de atributo que quer atualizar:

Consola

Elevada disponibilidade

Para clusters de bases de dados do AlloyDB Omni e PostgreSQL, ative ou desative a alta disponibilidade na mesma zona. Consulte a secção Configure a alta disponibilidade para mais informações.

Proteção de dados

Para todos os tipos de clusters de bases de dados, pode ativar ou desativar a proteção de dados:

  1. Aceda a Proteção de dados e clique em editar Editar para aceder ao formulário de definições de proteção de dados. Se as cópias de segurança automáticas estiverem ativadas, também pode configurar o período de retenção das cópias de segurança.
  2. Depois de fazer alterações, clique em Guardar para aplicar as atualizações ao cluster da base de dados.

Conetividade

Para todos os tipos de clusters de bases de dados, pode escolher se o cluster de base de dados só pode ser acedido a partir do projeto do GDC ou se também é acessível a partir do exterior do projeto:

  1. Aceda a Conetividade e clique em editar Editar.
  2. Atualize as configurações de conetividade.

  3. Clique em Guardar para aplicar as alterações.

Instâncias

Para todos os tipos de clusters de bases de dados, pode editar as propriedades da instância principal:

  1. Aceda a Instância principal e clique em editar Editar.

  2. Escolha entre as configurações Alto desempenho, Padrão, Mínimo ou Personalizado. A opção Personalizado permite-lhe escolher o número de CPUs, a memória e o armazenamento para a sua instância principal.

  3. A atualização da CPU, da memória ou do armazenamento da instância principal requer um reinício. Selecione Guardar e reiniciar para aplicar as alterações.

Para todos os tipos de clusters de base de dados, este formulário também lhe permite adicionar, modificar ou remover flags de base de dados. O conjunto de flags disponíveis é predeterminado pelo GDC. Consulte a secção Configure as flags da base de dados para mais informações.

CLI gcloud

Use o seguinte comando para atualizar um cluster de base de dados: sh gdcloud database clusters update CLUSTER_NAME [options]

Substitua o seguinte:

  • CLUSTER_NAME com o nome do cluster da base de dados a atualizar.

Para ver a lista completa de opções, consulte a referência de comandos ou execute o comando sh gdcloud database clusters update --help

API

Proteção de dados

Para todos os tipos de clusters de bases de dados, pode ativar a funcionalidade de proteção de dados criando um recurso BackupPlan para esse cluster de base de dados.

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

Substitua as seguintes variáveis:

  • DBENGINE_NAME: o nome do motor da base de dados. Esta é uma das opções alloydbomni,postgresql ou oracle.
  • DBCLUSTER_NAME: o nome do cluster da base de dados para o qual quer ativar a proteção de dados.
  • USER_PROJECT: o nome do projeto do utilizador onde o cluster de base de dados vai ser criado.
  • RETENTION_DAYS: o número de dias durante os quais o operador do AlloyDB Omni retém esta cópia de segurança. Tem de ser um número inteiro entre 1 e 90.

Também pode configurar definições de proteção de dados, como os dias de retenção, editando o recurso BackupPlan correspondente.

Para desativar a proteção de dados para um cluster de base de dados, elimine o recurso BackupPlan correspondente criado anteriormente.

Configure as flags da base de dados

As imagens da base de dados fornecidas com o GDC têm predefinições. No entanto, pode personalizar o motor de base de dados predefinido para satisfazer os requisitos das suas aplicações. Os clusters de bases de dados fornecem flags predefinidas que pode definir através da consola do GDC ou da CLI gdcloud:

Consola

  1. No menu de navegação, selecione Serviço de base de dados.

  2. Na lista de clusters de base de dados, clique no cluster de base de dados para o qual quer configurar flags de base de dados.

  3. Na secção Instâncias no cluster da base de dados, clique em Editar principal.

    Edite o cluster de base de dados principal para configurar flags.

  4. Na secção Sinalizações, clique em Adicionar uma sinalização de base de dados.

  5. Escolha a sua flag e introduza o valor. Se o valor que introduzir não for válido, a consola do GDC dá-lhe instruções sobre como cumprir o intervalo ou o tipo de valor obrigatório.

  6. Clique em Concluído.

  7. Para definir a configuração, clique em Guardar. Para que algumas flags entrem em vigor, tem de reiniciar o cluster da base de dados. Neste caso, clique em Guardar e reiniciar.

  8. Para confirmar que a nova flag está definida, regresse à secção Instâncias no cluster da base de dados do cluster da base de dados e verifique se a nova flag e o valor estão visíveis.

Para editar as suas flags da base de dados, regresse à secção Flags e modifique as flags existentes. Passe o cursor do rato sobre um componente de indicador e clique no ícone Eliminar para remover um indicador da base de dados.

gdcloud

Pode configurar novas flags da base de dados para o seu cluster ou repor todas as flags existentes para os respetivos valores predefinidos:

  • Para configurar uma flag de base de dados para o cluster de base de dados, execute:

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

    Substitua o seguinte:

    • CLUSTER_NAME: o nome do cluster da base de dados.
    • DB_FLAGS: a lista separada por vírgulas de flags da base de dados a definir na base de dados em execução no cluster da base de dados. Cada indicador e valor da base de dados são definidos como um par de chave-valor. As flags sem um valor podem ser definidas sem uma string após o caráter =.

    Por exemplo, o comando seguinte define várias flags da base de dados para o test-db-cluster:

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

    Para ver uma lista das flags de base de dados disponíveis, consulte o artigo Flags de base de dados disponíveis.

  • Para repor todos os sinalizadores da base de dados para as respetivas predefinições, execute o seguinte comando:

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

    Substitua CLUSTER_NAME pelo nome do cluster da base de dados.

API

  • Para configurar flags da base de dados para o cluster de base de dados, execute:

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

    Substitua as seguintes variáveis:

    • DBENGINE_NAME: o nome do motor da base de dados. É uma de alloydbomni, postgresql ou oracle.
    • DBCLUSTER_NAME: o nome do cluster da base de dados.
    • USER_PROJECT: o nome do projeto do utilizador onde o cluster de base de dados foi criado.
    • DB_FLAGS: os parâmetros de configuração da base de dados a adicionar ou atualizar. Este deve ser um objeto formatado em JSON de pares de chave-valor, em que as chaves são os nomes dos parâmetros da base de dados e os valores são as respetivas definições. Por exemplo, o seguinte define várias flags de base de dados:
    "autovacuum": "on", "autovacuum_analyze_threshold": "2147483647", "dbs.enable_anon": "on"

    Para ver uma lista das flags de base de dados disponíveis, consulte o artigo Flags de base de dados disponíveis.

  • Para repor todos os sinalizadores da base de dados para as respetivas predefinições, execute o seguinte comando:

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

    Substitua as seguintes variáveis:

    • DBENGINE_NAME: o nome do motor da base de dados. É uma de alloydbomni, postgresql ou oracle.
    • DBCLUSTER_NAME: o nome do cluster da base de dados.
    • USER_PROJECT: o nome do projeto do utilizador onde o cluster de base de dados foi criado.

Flags de base de dados disponíveis

As flags de base de dados disponíveis para configurar para o seu cluster de base de dados são fornecidas a seguir com base no motor de base de dados que configurou.

Sinalizações da base de dados PostgreSQL

Bandeira Intervalo Tipo É necessário reiniciar
max_connections [1, 262143] Número inteiro TRUE
temp_file_limit [1048576, 2147483647] Número inteiro FALSE
log_min_duration_statement [-1, 2147483647] Número inteiro FALSE
log_connections ativado, desativado Booleano FALSE
log_lock_waits ativado, desativado Booleano FALSE
log_disconnections ativado, desativado Booleano FALSE
log_checkpoints ativado, desativado Booleano FALSE
log_temp_files [-1, 2147483647] Número inteiro FALSE
log_statement none, ddl, mod, all Enum FALSE
pgaudit.log read, write, function, role, ddl, misc, misc_set,
all, none , -read, -write, -function, -role, -ddl,
-misc, -misc_set, -all, -none		 String repetida FALSE
work_mem [64, 2147483647] Número inteiro FALSE
autovacuum ativado, desativado Booleano FALSE
maintenance_work_mem [1024, 2147483647] Número inteiro FALSE
random_page_cost [0, 2147483647] Flutuante FALSE
log_min_messages debug5, debug4, debug3, debug2, debug1, info
notice, warning, error, log, fatal, panic		 Enum FALSE
idle_in_transaction_session_timeout [0, 2147483647] Número inteiro FALSE
max_wal_size [2, 2147483647],. Número inteiro FALSE
autovacuum_vacuum_scale_factor [0, 100] Flutuante FALSE
log_autovacuum_min_duration [-1, 2147483647] Número inteiro FALSE
autovacuum_vacuum_cost_limit [-1, 10000] Número inteiro FALSE
autovacuum_max_workers [1, 262143] Número inteiro TRUE
autovacuum_analyze_scale_factor [0, 100] Flutuante FALSE
track_activity_query_size [100, 1048576] Número inteiro TRUE
log_duration ativado, desativado Booleano FALSE
autovacuum_vacuum_cost_delay [-1, 100] Número inteiro FALSE
checkpoint_completion_target [0, 1] Flutuante FALSE
log_statement_stats ativado, desativado Booleano FALSE
max_worker_processes [8, 4096] Número inteiro TRUE
log_min_error_statement debug5, debug4, debug3, debug2, debug1, info,
notice, warning, error, log, fatal, panic		 Enum FALSE
default_statistics_target [1, 10000] Número inteiro FALSE
checkpoint_timeout [30, 86400] Número inteiro FALSE
wal_buffers [-1, 262143 ] Número inteiro TRUE
effective_cache_size [1, 2147483647] Número inteiro FALSE
autovacuum_work_mem [1, 2147483647] Número inteiro FALSE
log_hostname ativado, desativado Booleano FALSE
autovacuum_vacuum_threshold [0, 2147483647] Número inteiro FALSE
autovacuum_naptime [1, 2147483] Número inteiro FALSE
autovacuum_analyze_threshold [0, 2147483647] Número inteiro FALSE
pgaudit.log_client ativado, desativado Booleano FALSE
pgaudit.log_parameter ativado, desativado Booleano FALSE
pgaudit.log_level debug5, debug4, debug3, debug2, debug1, info,
notice, warning, error, log		 Enum FALSE
pgaudit.log_relation ativado, desativado Booleano FALSE
pgaudit.log_catalog ativado, desativado Booleano FALSE
pgaudit.role String FALSE
autovacuum_freeze_max_age [100000, 2000000000] Número inteiro TRUE
autovacuum_multixact_freeze_max_age [10000, 2000000000] Número inteiro TRUE
pgaudit.log_statement_once ativado, desativado Booleano FALSE
anon.algorithm String FALSE
anon.maskschema String FALSE
anon.restrict_to_trusted_schemas ativado, desativado Booleano FALSE
anon.salt String FALSE
anon.sourceschema String FALSE
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_wait_sampling on, off Booleano TRUE
pg_bigm.enable_recheck ativado, desativado Booleano FALSE
pg_bigm.gin_key_limit [0, 2147483647] Número inteiro FALSE
pg_bigm.similarity_limit [0, 1] Flutuante FALSE
pg_hint_plan.debug_print off, on, detailed, verbose, 0, 1, 2, 3, no, yes, false, true Enum TRUE
pg_hint_plan.enable_hint ativado, desativado Booleano FALSE
pg_hint_plan.enable_hint_table ativado, desativado Booleano FALSE
pg_hint_plan.message_level debug5, debug4, debug3, debug2, debug1, debug, info, notice, warning, error, log Enum FALSE
pg_hint_plan.parse_messages debug5, debug4, debug3, debug2, debug1, debug, info, notice, warning, error, log Enum FALSE
pg_stat_statements.max [100, 2147483647] Número inteiro TRUE
pg_stat_statements.save ativado, desativado Booleano FALSE
pg_stat_statements.track nenhum, superior, todos Enum FALSE
pg_stat_statements.track_utility ativado, desativado Booleano FALSE
pg_wait_sampling.history_period [1, 2147483647] Número inteiro FALSE
pg_wait_sampling.history_size [1, 2147483647] Número inteiro FALSE
pg_wait_sampling.profile_period [1, 2147483647] Número inteiro FALSE
pg_wait_sampling.profile_pid ativado, desativado Booleano FALSE
pg_wait_sampling.profile_queries ativado, desativado Booleano FALSE
pglogical.batch_inserts ativado, desativado Booleano TRUE
pglogical.conflict_log_level debug5, debug4, debug3 , debug2, debug1 , info, notice , warning, error , log, fatal , panic Enum FALSE
pglogical.conflict_resolution error, apply_remote, keep_local, last_update_wins, first_update_wins Enum FALSE
pglogical.extra_connection_options String FALSE
pglogical.synchronous_commit ativado, desativado Booleano TRUE
pglogical.use_spi ativado, desativado Booleano TRUE
pgtt.enabled ativado, desativado Booleano FALSE
plv8.execution_timeout [1, 65536] Número inteiro FALSE
plv8.memory_limit [256, 3096] Número inteiro FALSE
plv8.start_proc String FALSE
rdkit.agent_FP_bit_ratio [0, 3] Flutuante FALSE
rdkit.avalon_fp_size [64, 9192] Número inteiro FALSE
rdkit.dice_threshold [0, 1] Flutuante FALSE
rdkit.difference_FP_weight_agents [-10, 10] Número inteiro FALSE
rdkit.difference_FP_weight_nonagents [1, 20] Número inteiro FALSE
rdkit.do_chiral_sss ativado, desativado Booleano FALSE
rdkit.do_enhanced_stereo_sss ativado, desativado Booleano FALSE
rdkit.featmorgan_fp_size [64, 9192] Número inteiro FALSE
rdkit.hashed_atompair_fp_size [64, 9192] Número inteiro FALSE
rdkit.hashed_torsion_fp_size [64, 9192] Número inteiro FALSE
rdkit.ignore_reaction_agents ativado, desativado Booleano FALSE
rdkit.init_reaction ativado, desativado Booleano FALSE
rdkit.layered_fp_size [64, 9192] Número inteiro FALSE
rdkit.morgan_fp_size [64, 9192] Número inteiro FALSE
rdkit.move_unmmapped_reactants_to_agents ativado, desativado Booleano FALSE
rdkit.rdkit_fp_size [64, 9192] Número inteiro FALSE
rdkit.reaction_difference_fp_size [64, 9192] Número inteiro FALSE
rdkit.reaction_difference_fp_type [1, 3] Número inteiro FALSE
rdkit.reaction_sss_fp_size [64, 9192] Número inteiro FALSE
rdkit.reaction_sss_fp_type [1, 5] Número inteiro FALSE
rdkit.sss_fp_size [64, 4096] Número inteiro FALSE
rdkit.tanimoto_threshold [0, 1] Flutuante FALSE
rdkit.threshold_unmapped_reactant_atoms [0, 1] Flutuante FALSE

A tabela seguinte especifica os valores predefinidos para flags diferentes dos predefinidos do fornecedor:

Bandeira Valor/fórmula
shared_buffers 1/3 * totalMemory(MiB)
max_wal_size 1504MB
max_connections Memória total >= ? Valor
120GB 1000
60GB 800
15GB 500
7,5 GB 400
6GB 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 ativado
log_disconnections ativado
pgaudit.log all, -misc
log_hostname ativado
pgaudit.log_parameter ativado

Sinalizações da base de dados Oracle

Bandeira Intervalo Tipo É necessário reiniciar
aq_tm_processes [0, 40] Número inteiro FALSE
background_core_dump FULL, PARTIAL Enum FALSE
bitmap_merge_area_size [0, 2147483647] Número inteiro TRUE
control_management_pack_access NONE, DIAGNOSTIC, DIAGNOSTIC+TUNING Enum FALSE
cursor_sharing FORÇAR, EXATO, SEMELHANTE Enum FALSE
db_cache_size [0, 10995116277760] Número inteiro FALSE
db_files [200, 20000] Número inteiro TRUE
db_flashback_retention_target [30, 2147483647] Número inteiro FALSE
db_keep_cache_size [0, 10995116277760] Número inteiro FALSE
db_recovery_file_dest_size [0, 10995116277760] Número inteiro FALSE
evento String TRUE
large_pool_size [0, 10995116277760] Número inteiro FALSE
log_buffer [2097152, 10995116277760] Número inteiro TRUE
open_cursors [5, 65535] Número inteiro FALSE
pga_aggregate_limit [0, 10995116277760] Número inteiro FALSE
pga_aggregate_target [10485760, 10995116277760] Número inteiro FALSE
processos [100, 20000] Número inteiro TRUE
recyclebin ATIVADO, DESATIVADO Enum TRUE
resource_limit VERDADEIRO, FALSO Booleano FALSE
sec_max_failed_login_attempts [1, 2147483647] Número inteiro TRUE
sga_max_size [377487360, 10995116277760] Número inteiro TRUE
sga_target [377487360, 10995116277760] Número inteiro FALSE
shared_pool_size [0, 10995116277760] Número inteiro FALSE
undo_retention [0, 2147483647] Número inteiro FALSE
global_names VERDADEIRO, FALSO Booleano FALSE
DBFIPS_140 VERDADEIRO, FALSO Booleano TRUE
parallel_max_servers [0, 32767] Número inteiro FALSE
_fix_control String FALSE
_sql_plan_directive_mgmt_control [0, 65535] Número inteiro FALSE
_optimizer_dsdir_usage_control [0, 126] Número inteiro FALSE
skip_unusable_indexes VERDADEIRO, FALSO Booleano FALSE

A tabela seguinte especifica os valores predefinidos para flags diferentes dos predefinidos do fornecedor:

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

Sinalizações da base de dados do AlloyDB Omni

Bandeira Intervalo Tipo É necessário reiniciar
google_columnar_engine.enabled ativado, desativado Booleano TRUE
google_columnar_engine.memory_size_in_mb [128, 2147483647] Número inteiro TRUE
anon.algorithm String FALSE
anon.maskschema String FALSE
anon.restrict_to_trusted_schemas ativado, desativado Booleano FALSE
anon.salt String FALSE
anon.sourceschema String FALSE
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 ativado, desativado Booleano FALSE
pg_bigm.gin_key_limit [0, 2147483647] Número inteiro FALSE
pg_bigm.similarity_limit [0, 1] Flutuante FALSE
pg_hint_plan.debug_print off, on, detailed, verbose, 0, 1, 2, 3, no, yes, false, true Enum TRUE
pg_hint_plan.enable_hint ativado, desativado Booleano FALSE
pg_hint_plan.enable_hint_table ativado, desativado Booleano FALSE
pg_hint_plan.message_level debug5, debug4, debug3, debug2, debug1, debug, info, notice, warning, error, log Enum FALSE
pg_hint_plan.parse_messages debug5, debug4, debug3, debug2, debug1, debug, info, notice, warning, error, log Enum FALSE
pg_stat_statements.max [100, 2147483647] Número inteiro TRUE
pg_stat_statements.save ativado, desativado Booleano FALSE
pg_stat_statements.track nenhum, superior, todos Enum FALSE
pg_stat_statements.track_utility ativado, desativado Booleano FALSE
pg_wait_sampling.history_period [1, 2147483647] Número inteiro FALSE
pg_wait_sampling.history_size [1, 2147483647] Número inteiro FALSE
pg_wait_sampling.profile_period [1, 2147483647] Número inteiro FALSE
pg_wait_sampling.profile_pid ativado, desativado Booleano FALSE
pg_wait_sampling.profile_queries ativado, desativado Booleano FALSE
pgaudit.log read, write, function, role, ddl, misc, misc_set,
all, none , -read, -write, -function, -role, -ddl,
-misc, -misc_set, -all, -none		 String repetida FALSE
pgaudit.log_client ativado, desativado Booleano FALSE
pgaudit.log_parameter ativado, desativado Booleano FALSE
pgaudit.log_level debug5, debug4, debug3, debug2, debug1, info,
notice, warning, error, log		 Enum FALSE
pgaudit.log_relation ativado, desativado Booleano FALSE
pgaudit.log_catalog ativado, desativado Booleano FALSE
pgaudit.role String FALSE
pgaudit.log_statement_once ativado, desativado Booleano FALSE
pglogical.batch_inserts ativado, desativado Booleano TRUE
pglogical.conflict_log_level debug5, debug4, debug3 , debug2, debug1 , info, notice , warning, error , log, fatal , panic Enum FALSE
pglogical.conflict_resolution error, apply_remote, keep_local, last_update_wins, first_update_wins Enum FALSE
pglogical.extra_connection_options String FALSE
pglogical.synchronous_commit ativado, desativado Booleano TRUE
pglogical.use_spi ativado, desativado Booleano TRUE
pgtt.enabled ativado, desativado Booleano FALSE
plv8.execution_timeout [1, 65536] Número inteiro FALSE
plv8.memory_limit [256, 3096] Número inteiro FALSE
plv8.start_proc String FALSE