Configurazione dei flag di database

Questa pagina descrive come configurare i flag di database per Cloud SQL e elenca i flag che puoi impostare per l'istanza. Utilizzi i flag di database per molte operazioni, tra cui la modifica dei parametri MySQL, delle opzioni e la configurazione e l'ottimizzazione di un'istanza.

In alcuni casi, l'impostazione di un flag potrebbe richiedere l'impostazione di un altro per attivare completamente la funzionalità desiderata. Ad esempio, per attivare il registro delle query lente, devi impostare sia il flag slow_query_log su on sia il flag log_output su FILE per rendere disponibili i log utilizzando Esplora log della console Google Cloud.

Quando imposti, rimuovi o modifichi un flag per un'istanza di database, il database potrebbe essere riavviato. Il valore del flag viene mantenuto per l'istanza finché non lorimuovi. Se l'istanza è l'origine di una replica e viene riavviata, viene riavviata anche la replica in modo da allinearsi alla configurazione corrente dell'istanza.

Configurazione dei flag di database

Impostare un flag di database

Console

  1. Nella console Google Cloud, seleziona il progetto che contiene l'istanza Cloud SQL per cui vuoi impostare un flag del database.
  2. Apri l'istanza e fai clic su Modifica.
  3. Scorri verso il basso fino alla sezione Flag.
  4. Per impostare un flag che non è stato impostato prima nell'istanza, fai clic su Aggiungi elemento, scegli il flag dal menu a discesa e impostane il valore.
  5. Fai clic su Salva per salvare le modifiche.
  6. Conferma le modifiche in Flag nella pagina Panoramica.

gcloud

Modifica l'istanza:

gcloud sql instances patch INSTANCE_NAME --database-flags=FLAG1=VALUE1,FLAG2=VALUE2

Questo comando sovrascriverà tutti i flag del database impostati in precedenza. Per conservarli e aggiungerne di nuovi, includi i valori di tutti i flag che vuoi impostare nell'istanza. Qualsiasi flag non incluso specificamente viene impostato sul relativo valore predefinito. Per i flag che non accettano un valore, specifica il nome del flag seguito da un segno di uguale ("=").

Ad esempio, per impostare i flag general_log, skip_show_database e wait_timeout, puoi utilizzare il seguente comando:

gcloud sql instances patch INSTANCE_NAME \
  --database-flags=general_log=on,skip_show_database=on,wait_timeout=200000

Terraform

Per aggiungere flag di database, utilizza una risorsa Terraform.

resource "google_sql_database_instance" "instance" {
  database_version = "MYSQL_8_0"
  name             = "mysql-instance"
  region           = "us-central1"
  settings {
    database_flags {
      name  = "general_log"
      value = "on"
    }
    database_flags {
      name  = "skip_show_database"
      value = "on"
    }
    database_flags {
      name  = "wait_timeout"
      value = "200000"
    }
    disk_type = "PD_SSD"
    tier      = "db-n1-standard-2"
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Applica le modifiche

Per applicare la configurazione Terraform in un progetto Google Cloud, completa i passaggi nelle seguenti sezioni.

Prepara Cloud Shell

  1. Avvia Cloud Shell.
  2. Imposta il progetto Google Cloud predefinito in cui vuoi applicare le configurazioni Terraform.

    Devi eseguire questo comando una sola volta per progetto e puoi farlo in qualsiasi directory.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.

Prepara la directory

Ogni file di configurazione di Terraform deve avere una propria directory (chiamata anche modulo principale).

  1. In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file è denominato main.tf.
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf
  2. Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

    Copia il codice campione nel main.tf appena creato.

    Se vuoi, copia il codice da GitHub. Questa opzione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

  3. Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
  4. Salva le modifiche.
  5. Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory.
    terraform init

    Se vuoi, per utilizzare la versione più recente del provider Google, includi l'opzione -upgrade:

    terraform init -upgrade

Applica le modifiche

  1. Rivedi la configurazione e verifica che le risorse che Terraform sta per creare o aggiornare corrispondano alle tue aspettative:
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

  2. Applica la configurazione di Terraform eseguendo il seguente comando e inserendo yes al prompt:
    terraform apply

    Attendi che Terraform mostri il messaggio "Applicazione completata".

  3. Apri il tuo progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

Elimina le modifiche

Per eliminare le modifiche:

  1. Per disattivare la protezione dell'eliminazione, imposta l'argomento deletion_protection su false nel file di configurazione Terraform.
    deletion_protection =  "false"
  2. Applica la configurazione Terraform aggiornata eseguendo il seguente comando e inserendo yes al prompt:
    terraform apply
  1. Rimuovi le risorse applicate in precedenza con la configurazione Terraform eseguendo il seguente comando e inserendo yes al prompt:

    terraform destroy

REST v1

Per impostare un flag per un database esistente:

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL:

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

Corpo JSON della richiesta:

{
  "settings":
  {
    "databaseFlags":
    [
      {
        "name": "flag_name",
        "value": "flag_value"
      }
    ]
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Ad esempio, per impostare il flag general_log per un utilizzo del database esistente:

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL:

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

Corpo JSON della richiesta:

{
  "settings":
  {
    "databaseFlags":
    [
      {
        "name": "general_log",
        "value": "on"
      }
    ]
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Se esistono flag configurati per il database, modifica il comando precedente per includerli. Il comando PATCH sovrascrive i flag esistenti con quelli specificati nella richiesta.

REST v1beta4

Per impostare un flag per un database esistente:

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON della richiesta:

{
  "settings":
  {
    "databaseFlags":
    [
      {
        "name": "flag_name",
        "value": "flag_value"
      }
    ]
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Ad esempio, per impostare il flag general_log per un utilizzo del database esistente:

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON della richiesta:

{
  "settings":
  {
    "databaseFlags":
    [
      {
        "name": "general_log",
        "value": "on"
      }
    ]
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Se esistono flag configurati per il database, modifica il comando precedente per includerli. Il comando PATCH sovrascrive i flag esistenti con quelli specificati nella richiesta.

Reimposta tutti gli indicatori sui valori predefiniti

Console

  1. Nella console Google Cloud, seleziona il progetto che contiene l'istanza Cloud SQL per cui vuoi cancellare tutti gli indicatori.
  2. Apri l'istanza e fai clic su Modifica.
  3. Apri la sezione Flag di database.
  4. Fai clic sulla X accanto a tutti gli indicatori visualizzati.
  5. Fai clic su Salva per salvare le modifiche.

gcloud

Imposta tutti i flag sui valori predefiniti in un'istanza:

gcloud sql instances patch INSTANCE_NAME \
--clear-database-flags

Ti viene chiesto di confermare che l'istanza verrà riavviata.

REST v1

Per cancellare tutti i flag per un'istanza esistente:

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL:

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

Corpo JSON della richiesta:

{
  "settings":
  {
    "databaseFlags": []
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Per cancellare tutti i flag per un'istanza esistente:

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON della richiesta:

{
  "settings":
  {
    "databaseFlags": []
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Visualizzare i valori attuali dei flag di database

Per visualizzare tutti i valori correnti delle variabili di sistema MySQL, accedi alla tua istanza con il client mysql e inserisci il seguente comando:

 SHOW VARIABLES;

Tieni presente che puoi modificare il valore solo per gli indicatori supportati (elencati di seguito).

Determina quali flag di database sono stati impostati per un'istanza

Per vedere quali flag sono stati impostati per un'istanza Cloud SQL:

Console

  1. Nella console Google Cloud, seleziona il progetto che contiene l'istanza Cloud SQL per cui vuoi visualizzare gli indicatori del database impostati.
  2. Seleziona l'istanza per aprire la pagina Panoramica istanza.

    I flag di database impostati sono elencati nella sezione Flag di database.

gcloud

Recupera lo stato dell'istanza:

gcloud sql instances describe INSTANCE_NAME

Nell'output, i flag di database sono elencati in settings come la raccolta databaseFlags. Per ulteriori informazioni sulla rappresentazione dei flag nell'output, consulta Rappresentazione delle risorse delle istanze.

REST v1

Per elencare i flag configurati per un'istanza:

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Nell'output, cerca il campo databaseFlags.

REST v1beta4

Per elencare i flag configurati per un'istanza:

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Nell'output, cerca il campo databaseFlags.

Flag gestiti da Cloud SQL

Cloud SQL regola determinati flag di sistema a seconda del tipo di macchina dell'istanza.

innodb_buffer_pool_instances
  • 1 per db-f1-micro e db-g1-small.
  • 1 se la RAM è inferiore a 7,5 GB.
  • 2 se 7,5 GB <= RAM < 13 GB.
  • 4 se 13 GB <= RAM < 26 GB.
  • 8 se la RAM è >= 26 GB.

Flag supportati

I flag supportati in Cloud SQL sono i flag più richiesti per MySQL. I flag non menzionati di seguito non sono supportati.

Per un determinato flag, Cloud SQL potrebbe supportare un valore o un intervallo diverso rispetto al parametro o all'opzione MySQL corrispondente.

I flag si applicano a tutte le versioni di MySQL supportate da Cloud SQL tranne dove indicato.

A | B | C | D | E | F | G | H | I | L | M | N | O | P | Q | R | S | T | U | W

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

Flag Cloud SQL Tipo
Valori accettabili e note
Riavvio
necessario?
activate_all_roles_on_login boolean
on | off
valore predefinito: off
No
autocommit boolean
on | off
predefinito: on
No
auto_increment_increment integer
1 ... 65535
No
auto_increment_offset integer
1 ... 65535
No
automatic_sp_privileges boolean
on | off
predefinito: on
No
back_log integer
1 ... 65535
predefinito: max_connections
binlog_cache_size integer
4096 ... 9223372036854775807
No
binlog_expire_logs_seconds integer
0 o 86400 (1 day) ... 4294967295 (max value)
Il valore predefinito è 2592000, ovvero 30 giorni.

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
binlog_group_commit_sync_delay 0 ... 1000000

Supportato in MySQL 5.7 e versioni successive

Il valore predefinito è 0.

No
binlog_group_commit_sync_no_delay_count 0 ... 1000000

Supportato in MySQL 5.7 e versioni successive

Il valore predefinito è 0.

No
binlog_gtid_simple_recovery boolean
on | off
predefinito: on
binlog_order_commits boolean
on | off
predefinito: on

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
binlog_row_image enumeration
full (valore predefinito), minimal o noblob
No
binlog_row_metadata enumeration
full o minimal (valore predefinito)
No
binlog_row_value_options string
PARTIAL_JSON
No
binlog_rows_query_log_events boolean
on | off
predefinito: off
No
binlog_stmt_cache_size 4096 ... 9223372036854775807 No
binlog_transaction_dependency_history_size integer

Per informazioni su come utilizzare questo flag e sui relativi valori accettabili, consulta Configurare la replica parallela.

No
binlog_transaction_dependency_tracking enumeration

Per informazioni su come utilizzare questo flag e sui relativi valori accettabili, consulta Configurare la replica parallela. Questo flag non è supportato in MySQL 8.4.

No
block_encryption_mode string
aes-keylen-mode
default: aes-128-ECB
No
bulk_insert_buffer_size integer
0 ... 4294967295
predefinito: 8388608
No
collation_connection string
Valore predefinito:
MySQL 8.0 e versioni successive: utf8mb4_0900_ai_ci

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
collation_server string
valore predefinito:
MySQL 5.7 - utf8_general_ci
MySQL 8.0 e versioni successive - utf8mb4_0900_ai_ci
No
character_set_client string

predefinito:
MySQL 5.7: utf8
MySQL 8.0 e versioni successive: utf8mb4

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
character_set_connection string
predefinito:
MySQL 5.7: utf8
MySQL 8.0 e versioni successive: utf8mb4

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
character_set_results string
utf8 o utf8mb4
predefinito:
MySQL 5.7: utf8
MySQL 8.0 e versioni successive: utf8mb4

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
character_set_server string
utf8 o utf8mb4 (consigliato)
check_proxy_users boolean
on | off
predefinito: off
No
cloudsql_allow_analyze_table boolean on | off
valore predefinito: off
No
cloudsql_iam_authentication boolean on | off
valore predefinito: off
supportato in MySQL 5.7 e versioni successive per Cloud SQL.
No
cloudsql_ignore_innodb_encryption boolean on | off
valore predefinito: off
No
cloudsql_mysql_audit_data_masking_cmds string
"", dql, dml, ddl, dcl, show, call, create_udf, drop_function, create_procedure, create_function, drop_procedure, alter_procedure, alter_function, create_trigger, drop_trigger, create_event, alter_event, drop_event, create_db, drop_db, alter_db, create_user, drop_user, rename_user, alter_user, create_table, create_index, alter_table, drop_table, drop_index, create_view, drop_view, rename_table, update, insert, insert_select, delete, truncate, replace, replace_select, delete_multi, update_multi, load, select, call_procedure, connect, disconnect, grant, revoke, revoke_all, show_triggers, show_create_proc, show_create_func, show_procedure_code, show_function_code, show_create_event, show_events, show_create_trigger, show_grants, show_binlog_events, show_relaylog_events

predefinito: create_user, alter_user, grant e update
No
cloudsql_mysql_audit_data_masking_regex string
max_string_length: 2048
predefinito: fai clic qui.
No
cloudsql_mysql_audit_log_write_period integer
0...5000 millisecondi
valore predefinito: 500 millisecondi
No
cloudsql_mysql_audit_max_query_length integer
-1...1073741824
predefinito: -1
No
cloudsql_vector boolean on | off
valore predefinito: off
cloudsql_vector_max_mem_size integer
1073741824...innodb_buffer_pool_size/2
valore predefinito: 1073741824 in byte
completion_type enumeration
NO_CHAIN (valore predefinito), CHAIN o RELEASE
No
concurrent_insert enumeration
NEVER, AUTO (valore predefinito) o ALWAYS
No
connect_timeout integer
2 ... 31536000
predefinito: 10
No
cte_max_recursion_depth integer
0 ... 4294967295
predefinito: 1000
No
default_authentication_plugin string
mysql_native_password|caching_sha2_password
default_password_lifetime integer 0...65535
valore predefinito: 0
No
default_time_zone string
Esistono due modi per specificare i fusi orari: come offset e come nomi. Ad esempio, +00:00 è l'offset del fuso orario di Londra (che si trova nel fuso orario UTC) e Europe/London è il nome del fuso orario.

Utilizza i valori per specificare le differenze di fuso orario, da -12:59 a +13:00. Gli zeri iniziali sono obbligatori.

Quando si utilizzano i nomi dei fusi orari, è supportato l'adattamento automatico all'ora legale. Non è supportato quando si utilizzano gli offset dei fusi orari. Visualizza un elenco dei nomi dei fusi orari supportati da Cloud SQL per MySQL. Per tenerne conto, devi aggiornare questo flag manualmente nell'istanza principale e in tutte le repliche di lettura.

Per impostare il fuso orario senza causare un riavvio dell'istanza Cloud SQL, utilizza il comando set time_zone=timezone_offset o timezone_name con il flag init_connect.

default_week_format integer
0 ... 7
predefinito: 0
No
delay_key_write enumeration
OFF, ON (valore predefinito) o ALL
No
disconnect_on_expired_password boolean on | off
valore predefinito: on
div_precision_increment integer
0 ... 30
predefinito: 4
No
end_markers_in_json boolean
on | off
predefinito: off
No
eq_range_index_dive_limit integer
0 ... 2147483647
No
event_scheduler boolean
on | off

Se utilizzi la pianificazione degli eventi, configura la tua istanza con un criterio di attivazione di SEMPRE per assicurarti che gli eventi pianificati vengano eseguiti.

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
expire_logs_days integer
0 ... 99
Il valore predefinito è 0, il che significa che non viene eseguita alcuna rimozione automatica.

Nota: questo flag non è supportato in MySQL 8.4. Utilizza invece binlog_expire_logs_seconds. Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
explicit_defaults_for_timestamp boolean
on | off

No
flush_time integer
0 ... 31536000
predefinito: 0
No
foreign_key_checks boolean
on | off
predefinito: on

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
ft_max_word_len integer
10 ... 252
ft_min_word_len integer
1 ... 16
ft_query_expansion_limit integer
0 ... 1000
ft_stopword_file string
general_log boolean
on | off

Per ulteriori informazioni sui log generali, consulta la sezione Suggerimenti.

No
generated_random_password_length integer 5-255
valore predefinito: 20
No
group_concat_max_len integer
4 ... 17179869184
No
gtid_executed_compression_period integer
0 ... 4294967295
predefinito (fino alla versione 8.0.22): 1000
predefinito (versione 8.0.23 e successive): 0
No
histogram_generation_max_mem_size integer
1000000 ... 4294967295
predefinito: 20000000
No
init_connect string No
innodb_adaptive_hash_index boolean
on | off
No
innodb_adaptive_hash_index_parts integer
1 ... 512
innodb_adaptive_max_sleep_delay integer
0 ... 1000000
No
innodb_autoextend_increment integer
1 ... 1000
No
innodb_autoinc_lock_mode integer
0 ... 2
innodb_buffer_pool_chunk_size integer
1048576 ... (innodb_buffer_pool_size/innodb_buffer_pool_instances)

Questo valore del flag dipende da innodb_buffer_pool_size e innodb_buffer_pool_instances. MySQL può ottimizzare automaticamente il valore di innodb_buffer_pool_chunk_size in base a questi due flag.

innodb_buffer_pool_dump_pct integer
1 ... 100
Valore predefinito: 25
No
innodb_buffer_pool_dump_at_shutdown boolean
on | off
No
innodb_buffer_pool_dump_now boolean
on | off

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
innodb_buffer_pool_instances integer
1 ... 64
innodb_buffer_pool_load_abort boolean
on | off

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
innodb_buffer_pool_load_at_startup boolean
on | off
innodb_buffer_pool_load_now boolean
on | off

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
innodb_buffer_pool_size integer

L'impostazione di questo flag per MySQL 5.6 richiede un riavvio. Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
innodb_change_buffer_max_size integer
0 ... 50
No
innodb_change_buffering string

Opzioni: none, inserts, deletes, changes, purges, all.

No
innodb_checksum_algorithm string

Opzioni: crc32, strict_crc32, innodb, strict_innod, none, strict_none.

No
innodb_cmp_per_index_enabled boolean
on | off
No
innodb_commit_concurrency integer
0 ... 1000
innodb_compression_failure_threshold_pct integer
0 ... 100
No
innodb_compression_level integer
0 ... 9
No
innodb_compression_pad_pct_max integer
0 ... 75
No
innodb_concurrency_tickets integer
1 ... 4294967295
No
innodb_deadlock_detect boolean
on | off

Supportato in MySQL 5.7 e versioni successive.

Valore predefinito: on

No
innodb_disable_sort_file_cache boolean
on | off
No
innodb_doublewrite_batch_size integer
0 ... 256
Valore predefinito: 0
innodb_doublewrite_files integer
2 ... 128
innodb_doublewrite_pages integer
4 ... 512
Valore predefinito: 64
innodb_file_per_table boolean
on | off

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
innodb_fill_factor integer
10 ... 100
No
innodb_flush_log_at_timeout double
0.0001... 2700
Valore predefinito: 1

Supportato in MySQL 5.7 e versioni successive.

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
innodb_flush_log_at_trx_commit integer
1, 2
Valore predefinito: 1

Se promuovi una replica con questo flag abilitato, il flag viene rimosso automaticamente e la replica promossa avrà una durata completa per impostazione predefinita. Per utilizzare questo flag con una replica promossa, puoi aggiornarlo nella replica dopo la promozione.

Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

No
innodb_flush_neighbors enumeration
0 ... 2
Valori predefiniti:
  • MySQL 5.6: 0
  • MySQL 5.7 e versioni successive: 2
  • No
    innodb_flush_sync boolean
    on | off
    No
    innodb_ft_aux_table string

    Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

    innodb_ft_cache_size integer
    1600000 ... 80000000
    innodb_ft_enable_diag_print boolean
    on | off
    No
    innodb_ft_enable_stopword boolean
    on | off
    No
    innodb_ft_max_token_size integer
    10 ... 252
    innodb_ft_min_token_size integer
    0 ... 16
    innodb_ft_num_word_optimize integer
    1000 ... 10000
    No
    innodb_ft_result_cache_limit integer
    1000000 ... 4294967295
    No
    innodb_ft_server_stopword_table string No
    innodb_ft_sort_pll_degree integer
    1 ... 32
    innodb_ft_total_cache_size integer
    32000000 ... 1600000000
    innodb_ft_user_stopword_table string No
    innodb_io_capacity integer
    100 ... 100000
    Valore predefinito: 5000

    Per scoprire di più sulla configurazione delle prestazioni dei dischi, consulta la tabella VM E2 in Configurare i dischi per soddisfare i requisiti di prestazioni.

    No
    innodb_io_capacity_max integer
    100 ... 100000
    Valore predefinito: 10000

    Per scoprire di più sulla configurazione delle prestazioni dei dischi, consulta la tabella VM E2 in Configurare i dischi per soddisfare i requisiti di prestazioni.

    No
    innodb_large_prefix boolean
    on | off

    Supportato solo in MySQL 5.6.

    No
    innodb_lock_wait_timeout integer
    1 ... 1073741824
    No
    innodb_log_buffer_size integer
    262144 ... 4294967295
    innodb_log_checksums boolean
    on | off
    default: on
    No
    innodb_log_compressed_pages boolean
    on | off
    default: on
    No
    innodb_log_file_size integer
    MySQL 5.6: 1048576 ... 274877906944
    MySQL 5.7 e versioni successive: 4194304 ... 274877906944
    innodb_log_spin_cpu_abs_lwm integer
    0 ... 4294967295
    default: 80
    No
    innodb_log_spin_cpu_pct_hwm integer
    0 ... 100
    default: 50
    No
    innodb_log_wait_for_flush_spin_hwm integer
    0 ... 4294967295
    default: 400
    No
    innodb_log_write_ahead_size integer
    512 ... 65536
    default: 8192
    No
    innodb_lru_scan_depth integer
    100 ... 9223372036854775807
    No
    innodb_max_dirty_pages_pct float
    0 ... 99.99
    default: 90
    No
    innodb_max_dirty_pages_pct_lwm float
    0 ... 99.99
    default: 10
    No
    innodb_max_purge_lag integer
    0 ... 4294967295
    default: 0
    No
    innodb_max_undo_log_size integer
    10485760 ... 9223372036854775807
    default: 1073741824
    No
    innodb_max_purge_lag_delay integer
    0 ... 10000000
    default: 0
    No
    innodb_monitor_disable string No
    innodb_monitor_enable string No
    innodb_monitor_reset string
    counter, module, pattern, all
    No
    innodb_monitor_reset_all enumeration
    Valori validi: counter, module, pattern, all
    No
    innodb_old_blocks_pct integer
    5 ... 95
    No
    innodb_old_blocks_time integer
    0 ... 4294967295
    No
    innodb_online_alter_log_max_size integer
    65536 ... 9223372036854775807
    No
    innodb_open_files integer
    100 ... 2147483647
    valore predefinito:
    MySQL 5.7: 2000
    MySQL 8.0 e versioni successive: 4000
    8.0.28: No
    8.0.27: Sì
    innodb_optimize_fulltext_only boolean
    on | off
    No
    innodb_page_cleaners integer
    1 ... 64
    Supportato in MySQL 5.7 e versioni successive. Per MySQL 5.7 e 8.0, il valore predefinito è 4. Per MySQL 8.4, il valore predefinito è uguale al valore di configurato per il flag innodb_buffer_pool_instances.
    innodb_parallel_read_threads integer
    1 ... 256
    default: 4
    No
    innodb_print_all_deadlocks boolean
    on | off
    default: off
    No
    innodb_print_ddl_logs boolean
    on | off
    No
    innodb_purge_batch_size integer
    1 ... 5000
    default: 300
    No
    innodb_purge_rseg_truncate_frequency integer
    1 ... 128
    default: 128
    No
    innodb_purge_threads 1 ... 32

    Il valore predefinito è 1.

    innodb_random_read_ahead boolean
    on | off
    No
    innodb_read_ahead_threshold integer
    0 ... 64
    No
    innodb_read_io_threads integer
    1 ... 64
    innodb_redo_log_capacity integer
    MySQL 8.0.33 e versioni precedenti: 8388608 (8 MB) ... 137438953472 (128 GB) MySQL 8.0.34 e versioni successive: 8388608 (8 MB) ... 549755813888 (512 GB)

    Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

    No
    innodb_replication_delay integer
    0 ... 4294967295
    No
    innodb_rollback_on_timeout boolean
    on | off
    innodb_rollback_segments integer
    1 ... 128
    No
    innodb_segment_reserve_factor float
    .03 ... 40
    default: 12.5
    No
    innodb_sort_buffer_size integer
    65536 ... 67108864
    innodb_spin_wait_delay integer
    MySQL 5.7: 0 ... 1000000
    MySQL 8.0.13 e versioni successive: 0 ... 1000
    valore predefinito: 6
    No
    innodb_stats_auto_recalc boolean
    on | off
    No
    innodb_stats_include_delete_marked boolean
    on | off
    default: off
    No
    innodb_stats_method enumeration
    nulls_equal | nulls_unequal | nulls_ignored
    No
    innodb_stats_on_metadata boolean
    on | off
    No
    innodb_stats_persistent boolean
    on | off
    No
    innodb_stats_persistent_sample_pages integer
    1 ... 9223372036854775807
    No
    innodb_stats_sample_pages integer
    1 ... 9223372036854775807
    No
    innodb_stats_transient_sample_pages integer
    1 ... 9223372036854775807
    No
    innodb_status_output boolean
    on | off
    No
    innodb_status_output_locks boolean
    on | off
    No
    innodb_strict_mode boolean
    on | off
    No
    innodb_sync_array_size 1 ... 1024

    Il valore predefinito è 1.

    innodb_sync_spin_loops integer
    0 ... 4294967295
    valore predefinito: 30
    No
    innodb_table_locks boolean
    on | off
    default: on
    No
    innodb_thread_concurrency integer
    0 ... 1000
    No
    innodb_thread_sleep_delay integer
    0 ... 1000000
    No
    innodb_undo_log_truncate boolean
    on | off
    default: on
    No
    innodb_use_native_aio boolean
    on | off
    default: on
    innodb_write_io_threads integer
    1 ... 64
    interactive_timeout integer
    1 ... 31536000
    No
    internal_tmp_disk_storage_engine enumeration
    INNODB | MYISAM
    Valore predefinito: INNODB
    No
    internal_tmp_mem_storage_engine enumeration
    MEMORY, TempTable
    .
    No
    join_buffer_size integer
    128 ... 9223372036854775807
    No
    keep_files_on_create boolean
    on | off
    predefinito: off
    No
    key_buffer_size integer
    4096 ... 4294967295
    default: 8388608
    No
    key_cache_age_threshold integer
    100 ... 9223372036854775807
    default: 300
    No
    key_cache_block_size integer
    512 ... 16384
    default: 1024
    No
    key_cache_division_limit integer
    1 ... 100
    default: 100
    No
    lc_times_names string
    en_US | cs_CZ | da_DK | nl_NL | et_EE | fr_FR | de_DE | el_GR | hu_HU | it_IT | ja_JP | ko_KR | no_NO | nb_NO | pl_PL | pt_PT | ro_RO | ru_RU | sr_RS | sk_SK | es_ES | sv_SE | uk_UA
    valore predefinito: en_US
    No
    local_infile boolean
    on | off
    No
    lock_wait_timeout integer
    1 ... 31536000
    No
    log_bin_trust_function_creators boolean
    on | off
    No
    log_output set
    FILE | TABLE | NONE
    No
    log_error_verbosity integer
    1 ... 3
    valore predefinito:
    MySQL 5.7: 3
    MySQL 8.0 e versioni successive: 2
    No
    log_queries_not_using_indexes boolean
    on | off
    No
    log_slow_admin_statements boolean
    on | off
    default: off
    No
    log_slow_extra boolean
    on | off
    default: off
    No
    log_slow_replica_statements boolean
    on | off Valore predefinito: off
    No
    log_slow_slave_statements boolean
    on | off Valore predefinito: off
    No
    log_throttle_queries_not_using_indexes integer
    0 ... 9223372036854775807
    No
    log_timestamps string
    "UTC | SYSTEM"
    default: UTC
    No
    long_query_time float
    0 ... 30000000

    Cloud SQL offre la possibilità di impostare questo flag su un valore inferiore a 1, se necessario.

    Se è attivato anche il flag log_queries_not_using_indexes, potresti visualizzare query con un periodo di tempo inferiore a quello specificato qui.

    No
    lower_case_table_names 5.7 | 8.0 integer
    0 o 1
    Valore predefinito: 0

    Se utilizzi il valore predefinito 0 per questo flag, i nomi delle tabelle e dei database fanno distinzione tra lettere maiuscole e minuscole. Se impostato su 1, i nomi delle tabelle e dei database non fanno distinzione tra maiuscole e minuscole.

    Per le istanze MySQL 5.7, puoi modificare il valore di questo flag in qualsiasi momento. In questo caso, assicurati di comprendere in che modo la modifica influisce sulle tabelle e sui database esistenti.

    Per le istanze MySQL 8.0 e successive, puoi impostare il valore di questo flag su un valore desiderato solo durante la creazione di un'istanza. Una volta impostato questo valore, non potrai modificarlo. Inoltre, per un'istanza esistente non puoi modificare il valore di questo flag.

    Quando crei repliche di lettura per istanze MySQL 5.7, MySQL 8.0 o MySQL 8.4, la replica eredita questo valore del flag dall'istanza principale.

    mandatory_roles string role name
    valore predefinito: empty string
    No
    master_verify_checksum boolean
    on | off Valore predefinito: off
    No
    max_allowed_packet integer
    16384 ... 1073741824

    Questo valore deve essere un multiplo di 1024, se sql_mode=TRADITIONAL o sql_mode=STRICT_ALL_TABLES.

    No
    max_binlog_cache_size integer
    4096 ... 4294967296
    default: 4294967296
    No
    max_binlog_size integer
    4096 ... 1073741824
    No
    max_binlog_stmt_cache_size integer
    4096 ... 4294967296
    default: 4294967296
    No
    max_connect_errors integer
    1 ... 9223372036854775807
    default: 100
    No
    max_connections integer
    1 ... 100000
    No
    max_digest_length integer
    0 ... 1048576
    max_error_count integer
    0 ... 65535
    valore predefinito:
    MySQL 5.7 o versioni precedenti: 64
    MySQL 8.0 e versioni successive: 1024
    No
    max_execution_time integer
    0 ... 9223372036854775807
    No
    max_heap_table_size integer
    16384 ... 67108864

    Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

    No
    max_join_size integer
    16 ... 9223372036854775807
    No
    max_length_for_sort_data integer
    4 ... 8388608
    No
    max_points_in_geometry integer
    3 ... 1048576
    No
    max_prepared_stmt_count integer
    0 ... 1048576
    No
    max_seeks_for_key integer
    1 ... 9223372036854775807
    No
    max_sort_length integer
    4 ... 8388608
    No
    max_sp_recursion_depth integer
    0 ... 255
    No
    max_user_connections integer
    0 ... 4294967295
    No
    max_write_lock_count integer
    1 ... 9223372036854775807
    No
    min_examined_row_limit integer
    0 ... 4294967295
    default: 0
    No
    myisam_data_pointer_size integer
    2...7
    predefinito: 6
    No
    myisam_max_sort_file_size integer
    0...9223372036853727232
    predefinito: 9223372036853727232
    No
    myisam_mmap_size integer
    7...9223372036854775807
    predefinito: 9223372036854775807
    myisam_sort_buffer_size integer
    4096...4294967295
    predefinito: 8388608
    No
    myisam_stats_method string
    "nulls_unequal, nulls_equal, nulls_ignored"
    default: nulls_unequal
    No
    myisam_use_mmap boolean
    on | off
    predefinito: off
    No
    mysql_native_password_proxy_users boolean
    on | off
    predefinito: off
    No
    net_buffer_length integer
    1024 ... 1048576
    predefinito: 16384
    No
    net_read_timeout integer
    30 ... 4294967295
    No
    net_retry_count integer
    10 ... 4294967295
    No
    net_write_timeout integer
    60 ... 4294967295
    No
    ngram_token_size integer
    1 ... 10
    predefinito: 2
    optimizer_prune_level integer
    0 ... 1
    No
    optimizer_search_depth integer
    0 ... 62
    No
    optimizer_switch multi-value repeated string

    Per ulteriori informazioni sugli indicatori con più valori, consulta la sezione Suggerimenti.

    No
    optimizer_trace multi-value repeated string
    enabled=on, enabled=off, one_line=on, one_line=off

    Per ulteriori informazioni sugli indicatori con più valori, consulta la sezione Suggerimenti.

    No
    optimizer_trace_features multi-value repeated string

    Per ulteriori informazioni sugli indicatori con più valori, consulta la sezione Suggerimenti.

    No
    optimizer_trace_max_mem_size integer
    0 ... 9223372036854775807
    No
    optimizer_trace_offset integer
    -9223372036854775808 ... 9223372036854775807
    No
    parser_max_mem_size integer
    10000000 ... 9223372036854775807
    No
    password_history integer 0-4294967295
    valore predefinito: 0
    No
    password_require_current boolean on | off
    valore predefinito: off
    No
    password_reuse_interval integer 0-4294967295
    valore predefinito: 0
    No
    performance_schema boolean
    on | off

    predefinito: off, per MySQL 5.6, 5.7, 8.0 e 8.4 se la RAM dell'istanza è inferiore a 15 GB.

    predefinito: on, per MySQL 8.0 e versioni successive se la RAM dell'istanza è superiore a 15 GB

    Consulta la sezione Suggerimenti per ulteriori informazioni sui flag performance_schema.

    performance_schema_accounts_size integer
    -1 ... 1048576

    Consulta la sezione Suggerimenti per ulteriori informazioni sui flag performance_schema.

    performance_schema_digests_size integer
    -1 ... 1048576

    Consulta la sezione Suggerimenti per ulteriori informazioni sui flag performance_schema.

    performance_schema_error_size integer
    0 ... 1048576
    performance_schema_events_stages_history_long_size integer
    -1 ... 1048576
    performance_schema_events_stages_history_size integer
    -1 ... 1024

    Consulta la sezione Suggerimenti per ulteriori informazioni sui flag performance_schema.

    performance_schema_events_statements_history_long_size integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_events_statements_history_size integer
    -1 ... 1024

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_events_transactions_history_long_size integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_events_transactions_history_size integer
    -1 ... 1024

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_events_waits_history_long_size integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_events_waits_history_size integer
    -1 ... 1024

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_hosts_size integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_cond_classes integer
    0 ... 256

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_cond_instances integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_digest_length integer
    0 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_digest_sample_age integer
    0 ... 1048576
    predefinito: 60
    No
    performance_schema_max_file_classes integer
    0 ... 256

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_file_handles integer
    0 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_file_instances integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_index_stat integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_memory_classes integer
    0 ... 1024

    Consulta la sezione Suggerimenti per ulteriori informazioni sui flag performance_schema.

    performance_schema_max_metadata_locks integer
    -1 ... 104857600

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_mutex_classes integer
    0 ... 256

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_mutex_instances integer
    -1 ... 104857600

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_prepared_statements_instances integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_program_instances integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_rwlock_classes integer
    0 ... 256

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_rwlock_instances integer
    -1 ... 104857600

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_socket_classes integer
    0 ... 256

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_socket_instances integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_sql_text_length integer
    0 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_stage_classes integer
    0 ... 256

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_statement_classes integer
    0 ... 256

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_statement_stack integer
    1 ... 256

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_table_handles integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_table_instances integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_table_lock_stat integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_thread_classes integer
    0 ... 256

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_max_thread_instances integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_session_connect_attrs_size integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_setup_actors_size integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_setup_objects_size integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    performance_schema_users_size integer
    -1 ... 1048576

    Per ulteriori informazioni sui flag performance_schema, consulta la sezione Suggerimenti.

    preload_buffer_size integer
    1024 ... 1073741824
    predefinito: 32768
    No
    query_alloc_block_size integer
    1024 ... 4294967295
    No
    query_cache_limit integer
    0 ... 223338299392

    Questo flag non è disponibile per MySQL 8.0 e versioni successive perché la cache delle query è stata deprecata a partire da MySQL 5.7.20 e rimossa in MySQL 8.0.

    No
    query_cache_min_res_unit integer
    0 ... 9223372036854775807

    Questo flag non è disponibile per MySQL 8.0 e versioni successive perché la cache delle query è stata deprecata a partire da MySQL 5.7.20 e rimossa in MySQL 8.0.

    No
    query_cache_size integer
    0 ... 223338299392

    Questo flag non è disponibile per MySQL 8.0 e versioni successive perché la cache delle query è stata deprecata a partire da MySQL 5.7.20 e rimossa in MySQL 8.0.

    No
    query_cache_type enumeration
    0 ... 2

    Questo flag non è disponibile per MySQL 8.0 e versioni successive perché la cache delle query è stata deprecata a partire da MySQL 5.7.20 e rimossa in MySQL 8.0.

    query_cache_wlock_invalidate boolean
    on | off

    Questo flag non è disponibile per MySQL 8.0 e versioni successive perché la cache delle query è stata deprecata a partire da MySQL 5.7.20 e rimossa in MySQL 8.0.

    No
    query_prealloc_size integer
    8192 ... 9223372036854775807
    No
    range_alloc_block_size integer
    4096 ... 4294967295
    No
    range_optimizer_max_mem_size integer
    0 ... 9223372036854775807
    No
    read_buffer_size integer
    8192 ... 2147483647
    No
    read_only boolean
    on | off

    Non ha alcun effetto sulle repliche.

    No
    read_rnd_buffer_size integer
    1 ... 2147483647
    No
    regexp_stack_limit integer
    0 ... 2147483647
    No
    regexp_time_limit integer
    0 ... 2147483647
    predefinito: 32
    No
    replica_checkpoint_group integer
    32 ... 524280
    Il valore predefinito è 512.

    Questo flag non influisce sulle repliche per le quali non è attivo il multithreading.

    No
    replica_checkpoint_period integer
    1 ... 4294967295
    Il valore predefinito è 300.

    L'unità di misura è in millisecondi.

    No
    replica_compressed_protocol boolean
    on | off
    No
    replica_net_timeout integer
    1 ... 31536000

    L'unità di misura è in secondi.

    No
    replica_parallel_type enumeration
    DATABASE, LOGICAL_CLOCK
    Valore predefinito:
    MySQL 8.0.26 o versioni precedenti: DATABASE
    MySQL 8.0.27 o versioni successive: LOGICAL_CLOCK

    Per informazioni su come utilizzare questo flag e sui relativi valori accettabili, consulta Configurare la replica parallela.

    No
    replica_parallel_workers integer

    Per informazioni su come utilizzare questo flag e sui relativi valori accettabili, consulta Configurare la replica parallela.

    No
    replica_pending_jobs_size_max integer

    Per informazioni su come utilizzare questo flag e sui relativi valori accettabili, consulta Configurare la replica parallela.

    No
    replica_preserve_commit_order boolean

    Per informazioni su come utilizzare questo flag e sui relativi valori accettabili, consulta Configurare la replica parallela.

    No
    replica_skip_errors string
    Valore predefinito: OFF

    Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

    replica_sql_verify_checksum boolean
    on | off
    No
    replica_transaction_retries integer
    0 ... 9223372036854775807
    No
    replica_type_conversions String
    values: ALL_LOSSY, ALL_NON_LOSSY, ALL_SIGNED, ALL_UNSIGNED
    No
    replicate_do_db string

    Per ulteriori informazioni su come utilizzare questo flag, consulta la sezione Filtri di replica.

    No
    replicate_do_table string

    Per ulteriori informazioni su come utilizzare questo flag, consulta la sezione Filtri di replica.

    No
    replicate_ignore_db string

    Per ulteriori informazioni su come utilizzare questo flag, consulta la sezione Filtri di replica.

    No
    replicate_ignore_table string

    Per ulteriori informazioni su come utilizzare questo flag, consulta la sezione Filtri di replica.

    No
    replicate_wild_do_table string

    Per ulteriori informazioni su come utilizzare questo flag, consulta la sezione Filtri di replica.

    No
    replicate_wild_ignore_table string

    Per ulteriori informazioni su come utilizzare questo flag, consulta la sezione Filtri di replica.

    No
    rpl_read_size integer
    8192 ... 4294959104
    predefinito: 8192
    No
    schema_definition_cache integer
    256 ... 524288
    predefinito: 256
    No
    session_track_gtids string
    OFF | OWN_GTID | ALL_GTIDS
    predefinito: OFF
    No
    session_track_schema boolean
    on | off
    predefinito: on
    No
    session_track_state_change boolean
    on | off
    predefinito: off
    No
    session_track_transaction_info string
    OFF | STATE | CHARACTERISTICS
    predefinito: OFF
    No
    sha256_password_proxy_users boolean
    on | off
    predefinito: off
    No
    show_create_table_verbosity boolean
    on | off
    predefinito: off
    No
    show_compatibility_56 boolean
    on | off

    Supportato solo in MySQL 5.7.

    No
    skip_character_set_client_handshake boolean
    on | off
    predefinito: off
    skip_show_database flag
    on | off
    slave_checkpoint_group integer
    32 ... 524280
    Il valore predefinito è 512.

    Questo flag non influisce sulle repliche per le quali non è attivo il multithreading.

    No
    slave_checkpoint_period integer
    1 ... 4294967295
    Il valore predefinito è 300.

    L'unità di misura è in millisecondi.

    No
    slave_compressed_protocol boolean
    on | off
    No
    slave_net_timeout integer
    1 ... 31536000

    L'unità di misura è in secondi.

    No
    slave_parallel_type enumeration
    DATABASE, LOGICAL_CLOCK
    Valore predefinito:
    MySQL 8.0.26 o versioni precedenti: DATABASE
    MySQL 8.0.27 o versioni successive: LOGICAL_CLOCK

    Per informazioni su come utilizzare questo flag e sui relativi valori accettabili, consulta Configurare la replica parallela.

    No
    slave_parallel_workers integer

    Per informazioni su come utilizzare questo flag e sui relativi valori accettabili, consulta Configurare la replica parallela.

    No
    slave_preserve_commit_order boolean

    Per informazioni su come utilizzare questo flag e sui relativi valori accettabili, consulta Configurare la replica parallela.

    No
    slave_pending_jobs_size_max integer

    Per informazioni su come utilizzare questo flag e sui relativi valori accettabili, consulta Configurare la replica parallela.

    No
    slave_skip_errors string
    Valore predefinito: OFF

    Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

    slave_sql_verify_checksum boolean
    on | off
    No
    slave_transaction_retries integer
    0 ... 9223372036854775807
    No
    slave_type_conversions string
    values: ALL_LOSSY, ALL_NON_LOSSY, ALL_SIGNED, ALL_UNSIGNED
    No
    slow_launch_time Integer
    0 ... 31536000
    Valore predefinito: 2
    No
    slow_query_log boolean
    on | off

    Per ulteriori informazioni sui log delle query lente, consulta la sezione Suggerimenti.

    No
    sort_buffer_size integer
    32768 ... 9223372036854775807
    No
    source_verify_checksum boolean
    on | off
    Valore predefinito: off
    No
    sql_mode string

    Consulta la sezione Modalità SQL del server nella documentazione di MySQL per conoscere i valori consentiti, incluse le modalità combinate, come ANSI. NO_DIR_IN_CREATE non è supportato.

    Cloud SQL per MySQL non supporta valori vuoti per il sql_mode flag. Anziché utilizzare un valore vuoto, imposta questo flag sulla modalità NO_ENGINE_SUBSTITUTION.

    No
    sql_require_primary_key boolean
    on | off
    Valore predefinito: off
    No
    sql_select_limit integer 0...18446744073709551615
    predefinito: 18446744073709551615

    Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

    No
    stored_program_cache integer
    16 ... 524288
    No
    stored_program_definition_cache integer
    256 ... 524288
    Valore predefinito: 256
    No
    sync_binlog integer
    0 ... 4294967295

    L'impostazione predefinita 1 consente la sincronizzazione del log binario su disco prima che le transazioni vengano committate.

    Se promuovi una replica con questo flag abilitato, il flag viene rimosso automaticamente e la replica promossa avrà una durata completa per impostazione predefinita. Per utilizzare questo flag con una replica promossa, puoi aggiornarlo nella replica dopo la promozione.

    Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

    No
    sync_master_info integer
    0 ... 4294967295
    Valore predefinito: 10000
    No
    sync_relay_log integer
    0 ... 4294967295
    Valore predefinito: 10000
    No
    sync_relay_log_info integer
    0 ... 4294967295
    Valore predefinito: 10000
    No
    sync_source_info integer
    0 ... 4294967295
    Valore predefinito: 10000
    No
    sysdate_is_now boolean
    on | off
    predefinito: off
    table_definition_cache integer
    400 ... 524288
    No
    tablespace_definition_cache integer
    256 ... 524288
    Valore predefinito: 256
    No
    table_open_cache integer
    1 ... 524288
    No
    table_open_cache_instances integer
    1 ... 64
    temptable_max_mmap integer
    0 ... 68719476736
    Valore predefinito: 1073741824
    No
    temptable_max_ram integer
    2097152 ... 68719476736
    Valore predefinito: 1073741824
    No
    thread_cache_size integer
    0 ... 16384
    No
    thread_stack integer
    131072 ... 9223372036854775807
    tls_version String

    Dalla versione 5.7 alla versione 8.0.27: TLSv1, TLSv1.1
    Versione 8.0.28 o successive: TLSv1.2
    Versione 5.7: Sì

    Versione 8.0 o successive: No
    tmp_table_size integer
    1024 ... 67108864

    Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

    No
    transaction_alloc_block_size integer
    1024 ... 131072
    No
    transaction_isolation enumeration
    READ-UNCOMMITTED | READ-COMMITTED | REPEATABLE-READ | SERIALIZABLE
    transaction_prealloc_size integer
    1024 ... 131072
    No
    transaction_write_set_extraction enumeration

    Per informazioni su come utilizzare questo flag e sui relativi valori accettabili, consulta Configurare la replica parallela. Questo flag non è supportato in MySQL 8.4.

    No
    unique_checks boolean
    on | off
    predefinito: on

    Per ulteriori informazioni su questo flag, consulta la sezione Suggerimenti.

    No
    updatable_views_with_limit integer
    0 ... 1
    No
    wait_timeout integer
    1 ... 31536000
    No
    windowing_use_high_precision boolean
    on | off
    Valore predefinito: on
    No

    Nomi dei fusi orari

    In questa sezione vengono descritti i nomi dei fusi orari supportati da Cloud SQL per MySQL.

    La tabella in questa sezione mostra quanto segue:

    • Nome del fuso orario: il nome supportato da Cloud SQL per MySQL.
    • STD: l'offset del fuso orario in ora standard (STD).
    • DST: l'offset del fuso orario in ora legale.
    • Nomi dei sinonimi: i nomi dei fusi orari che potresti voler utilizzare, ma che non sono supportati da Cloud SQL per MySQL. In questo caso, utilizza il nome del fuso orario corrispondente.
    nome-fuso-orario MST DST Nomi dei sinonimi
    Africa/Cairo +02:00 +02:00 Egitto
    Africa/Casablanca +01:00 +00:00
    Africa/Harare +02:00 +02:00 Africa/Maputo
    Africa/Monrovia +00:00 +00:00
    Africa/Nairobi +03:00 +03:00 Africa/Addis_Ababa
    Africa/Asmera
    Africa/Dar_es_Salaam
    Africa/Djibouti
    Africa/Kampala
    Africa/Mogadishu
    Indian/Antananarivo
    Indian/Comoro
    Indian/Mayotte
    Africa/Tripoli +02:00 +02:00 Libia
    Africa/Windhoek +02:00 +02:00
    America/Araguaina -03:00 -03:00
    America/Asunción -04:00 -03:00
    America/Bogota -05:00 -05:00
    America/Buenos_Aires -03:00 -03:00 America/Argentina/Buenos_Aires
    America/Caracas -04:00 -04:00
    America/Chicago -06:00 -05:00
    America/Chihuahua -07:00 -06:00 America/Ojinaga
    America/Cuiaba -04:00 -04:00
    America/Denver -07:00 -06:00 America/Shiprock
    Navajo
    MST7MDT
    US/Mountain
    America/Detroit -05:00 -04:00
    America/Fortaleza -03:00 -03:00
    America/Guatemala -06:00 -06:00
    America/Halifax -04:00 -03:00 Canada/Atlantico
    America/Los_Angeles -08:00 -07:00
    America/Manaus -04:00 -04:00 Brasile/Ovest
    America/Matamoros -06:00 -05:00
    America/Mexico_City -06:00 -05:00
    America/Monterrey -06:00 -05:00
    America/Montevideo -03:00 -03:00
    America/New_York -05:00 -04:00
    America/Phoenix -07:00 -07:00 US/Arizona
    MST
    America/Creston
    America/Santiago -04:00 -03:00 Cile/Continentale
    America/San_Paolo -03:00 -03:00
    America/Tijuana -08:00 -07:00 Mexico/BajaNorte
    America/Ensenada
    America/Santa_Isabel
    Asia/Amman +02:00 +03:00
    Asia/Ashgabat +05:00 +05:00 Asia/Ashkhabad
    Asia/Baghdad +03:00 +03:00
    Asia/Baku +04:00 +04:00
    Asia/Bangkok +07:00 +07:00 Asia/Phnom_Penh
    Asia/Vientiane
    Asia/Beirut +02:00 +03:00
    Asia/Calcutta +05:30 +05:30 Asia/Kolkata
    Asia/Damasco +02:00 +03:00
    Asia/Dacca +06:00 +06:00 Asia/Dacca
    Asia/Irkutsk +08:00 +08:00
    Asia/Gerusalemme +02:00 +03:00 Asia/Tel_Aviv
    Israele
    Asia/Kabul +04:30 +04:30
    Asia/Karachi +05:00 +05:00
    Asia/Kathmandu +05:45 +05:45 Asia/Katmandu
    Asia/Kolkata +05:30 +05:30
    Asia/Krasnoyarsk +07:00 +07:00
    Asia/Magadan +11:00 +11:00
    Asia/Muscat +04:00 +04:00 Asia/Dubai
    Asia/Novosibirsk +07:00 +07:00
    Asia/Riyadh +03:00 +03:00 Asia/Kuwait
    Antartide/Syowa
    Asia/Aden
    Asia/Seoul +09:00 +09:00 ROK
    Asia/Shanghai +08:00 +08:00 Asia/Chongqing
    Asia/Chungking
    Asia/Harbin
    PRC
    Asia/Singapore +08:00 +08:00 Singapore
    Asia/Taipei +08:00 +08:00 ROC
    Asia/Teheran +03:30 +04:30 Iran
    Asia/Tokyo +09:00 +09:00 Giappone
    Asia/Ulaanbaatar +08:00 +08:00 Asia/Ulan_Bator
    Asia/Vladivostok +10:00 +10:00
    Asia/Yakutsk +09:00 +09:00
    Asia/Yerevan +04:00 +04:00
    Atlantico/Azzorre -01:00 +00:00
    Australia/Adelaide +09:30 +10:30 Australia/South
    Australia/Brisbane +10:00 +10:00 Australia/Queensland
    Australia/Darwin +09:30 +09:30 Australia/North
    Australia/Hobart +10:00 +11:00 Australia/Currie
    Australia/Tasmania
    Australia/Perth +08:00 +08:00 Australia/Ovest
    Australia/Sydney +10:00 +11:00 Australia/NSW
    Australia/ACT
    Australia/Canberra
    Brasile/Est -03:00 -03:00 America/San_Paolo
    Canada/Terranova -03:30 -02:30 America/St_Johns
    Canada/Saskatchewan -06:00 -06:00 America/Regina
    Canada/Yukon -07:00 -07:00 America/Whitehorse
    Europa/Amsterdam +01:00 +02:00
    Europa/Atene +02:00 +03:00
    Europa/Dublino +01:00 +00:00 Eire
    Europa/Helsinki +02:00 +03:00 Europa/Mariehamn
    Europe/Istanbul +03:00 +03:00 Turchia
    Asia/Istanbul
    Europa/Kaliningrad +02:00 +02:00
    Europa/Madrid +01:00 +02:00
    Europa/Mosca +03:00 +03:00 W-SU
    Europa/Parigi +01:00 +02:00 MET
    CET
    Europa/Praga +01:00 +02:00 Europe/Bratislava
    Europa/Sarajevo +01:00 +02:00 Europe/Belgrade
    Europe/Ljubljana
    Europe/Podgorica
    Europe/Skopje
    Europe/Zagreb
    Pacifico/Auckland +12:00 +13:00 NZ
    Antarctica/McMurdo
    Antarctica/South_Pole
    Pacifico/Fiji +12:00 +13:00
    Pacifico/Guam +10:00 +10:00 Pacifico/Saipan
    Pacifico/Honolulu -10:00 -10:00 US/Hawaii
    Pacific/Johnston
    HST
    Pacifico/Samoa -11:00 -11:00 Pacifico/Pago_Pago
    US/Samoa
    US/Alaska -09:00 -08:00 America/Anchorage
    America/Juneau
    America/Metlakatla
    America/Nome
    America/Sitka
    America/Yakutat
    US/Central -06:00 -05:00 America/Chicago
    Stati Uniti/fuso orario orientale -05:00 -04:00 America/New_York
    Stati Uniti/Est-Indiana -05:00 -04:00 America/Indiana/Indianapolis
    America/Indianapolis
    America/Fort_Wayne
    US/Mountain -07:00 -06:00 America/Denver
    Stati Uniti/Pacifico -08:00 -07:00 America/Los_Angeles
    UTC +00:00 +00:00 Etc/UTC
    Etc/UCT
    Etc/Universal
    Etc/Zulu

    Le tabelle dei fusi orari in Cloud SQL potrebbero richiedere l'aggiornamento con i dati più recenti. Ad esempio, un paese potrebbe passare da una differenza di fuso orario con ora legale a una con ora standard o un paese potrebbe introdurre un nuovo fuso orario.

    Per ogni release dell'agente di servizio critico (CSA) per Cloud SQL, le tabelle dei fusi orari vengono aggiornate con i dati più recenti. In questo caso, durante il periodo di non manutenzione, le istanze di replica vengono aggiornate. Le istanze principali vengono quindi aggiornate durante il periodo di manutenzione.

    Puoi attendere la periodo di manutenzione regolare per il rilascio del CSA o eseguire la manutenzione self-service per aggiornare le tabelle dei fusi orari con i dati più recenti. Per ulteriori informazioni su come visualizzare le versioni di manutenzione disponibili, consulta Determinare la versione di manutenzione di destinazione.

    Suggerimenti per lavorare con i flag

    general_log, slow_query_log

    Per rendere disponibili i log general o slow query, attiva il flag corrispondente e imposta il flag log_output su FILE. In questo modo, l'output del log sarà disponibile utilizzando il Visualizzatore dei log nella console Google Cloud. Tieni presente che si applicano i costi di registrazione di Google Cloud Observability. Per ridurre al minimo il costo dello spazio di archiviazione dell'istanza, i log general e slow query sul disco dell'istanza vengono girati quando il file di log è stato creato più di 24 ore fa (e non sono state apportate modifiche durante questo periodo) o se ha una dimensione superiore a 100 MB. I vecchi file di log vengono eliminati automaticamente dopo la rotazione.

    Se log_output è impostato su NONE, non puoi accedere ai log. Se imposti log_output su TABLE, l'output del log viene inserito in una tabella del database di sistema MySQL. Potrebbe consumare una notevole quantità di spazio su disco. Se questa tabella diventa di grandi dimensioni, può influire sul tempo di riavvio dell'istanza o causare la perdita della copertura dello SLA (accordo sul livello del servizio). Per questo motivo, l'opzione TABLE non è consigliata. Inoltre, i contenuti dei log non sono disponibili in Esplora log e non vengono ruotati. Se necessario, puoi troncare le tabelle dei log utilizzando l'API. Per ulteriori informazioni, consulta la pagina di riferimento di instances.truncateLog.

    expire_logs_days, binlog_expire_logs_seconds
    Se attivi il recupero in un determinato istante, il periodo di scadenza dei log di tipo binario viene determinato dal periodo di conservazione dei log delle transazioni più breve e dai valori di questi flag. Puoi utilizzare questi flag per gestire il tempo di archiviazione dei log binari sulle repliche. Il flag expire_logs_days viene rimosso da MySQL 8.4 e versioni successive. Per ulteriori informazioni, consulta la pagina sulla conservazione dei log delle transazioni.
    innodb_buffer_pool_size

    Il valore di questo flag è la dimensione in byte del pool di buffer. La dimensione del pool di buffer deve sempre essere uguale o un multiplo del valore ottenuto moltiplicando innodb_buffer_pool_chunk_size per innodb_buffer_pool_instances. Se modifichi la dimensione del pool di buffer impostandola su un valore non uguale o un multiplo di innodb_buffer_pool_chunk_size moltiplicato per innodb_buffer_pool_instances, Cloud SQL regola automaticamente la dimensione del pool di buffer. Non puoi attivare questo flag sulle istanze con meno di 3840 MiB di RAM.

    Non puoi configurare questo flag per i tipi di macchine con core condivisi (f1_micro e g1_small). La modifica di questo flag su MySQL 5.6 richiede un riavvio.

    In Cloud SQL, i valori predefiniti, minimi e massimi consentiti del flag innodb_buffer_pool_size dipendono dalla memoria dell'istanza. Questi valori possono essere calcolati approssimativamente come percentuale della RAM dell'istanza. Per impostazione predefinita, il valore di questo flag viene impostato in genere vicino al valore massimo consentito. La percentuale di allocazione massima consentita aumenta con la dimensione dell'istanza. In genere, il valore minimo consentito è pari al 20% circa della RAM dell'istanza.

    Valori approssimativi per questo flag:

    Intervallo di RAM delle istanze% min% predefinito% max
    0-4 GB di RAM~34%
    4,0 GB - 7,5 GB~20%~34%~34%
    7,5 GB - 12 GB~20%~52%~52%
    12GB - 24GB~20%~67%~67%
    Da 24 GB in su~20%~72%~72%

    I valori esatti potrebbero variare. Per calcolare il valore corrente per la tua istanza, puoi eseguire la query:

      show global variables like 'innodb_buffer_pool_size';
      

    Come riferimento, sono forniti i valori minimo, predefinito e massimo consentiti per i tipi di macchine riportati di seguito.

    Tipo di macchina RAM dell'istanza (GB) Min (GB)
    (% del totale)
    Valore predefinito (GB)
    (%) del totale
    Massimo (GB)
    (% del totale)
    db-f1-micro 0,6 - 0,053 -
    db-g1-small 1,7 - 0,625 -
    db-custom-1-3840 3,75 0,875
    (23%)
    1,375
    (37%)
    1,375
    (37%)
    db-custom-2-7680 7,5 1,5
    (20%)
    4
    (53%)
    4
    (53%)
    db-custom-4-15360 15 3
    (20%)
    10,5
    (70%)
    10,5
    (70%)
    db-custom-8-30720 30 6
    (20%)
    22
    (73%)
    22
    (73%)
    db-custom-16-61440 60 12
    (20%)
    44
    (73%)
    44
    (73%)
    db-custom-32-122880 120 24
    (20%)
    87
    (73%)
    87
    (73%)
    db-custom-64-245760 240 48
    (20%)
    173
    (72%)
    173
    (72%)
    db-custom-96-368640 360 72
    (20%)
    260
    (72%)
    260
    (72%)
    db-custom-2-13312 13 3
    (23%)
    9
    (69%)
    9
    (69%)
    db-custom-4-26624 26 6
    (23%)
    19
    (73%)
    19
    (73%)
    db-custom-8-53248 52 11
    (21%)
    38
    (73%)
    38
    (73%)
    db-custom-16-106496 104 21
    (20%)
    75
    (72%)
    75
    (72%)
    db-custom-32-212992 208 42
    (20%)
    150
    (72%)
    150
    (72%)
    db-custom-64-425984 416 84
    (20%)
    300
    (72%)
    300
    (72%)
    db-custom-96-638976 624 125
    (20%)
    450
    (72%)
    450
    (72%)

    innodb_file_per_table

    Per tutte le versioni MySQL 5.6 e successive, il valore predefinito è ON.

    innodb_flush_log_at_trx_commit, sync_binlog
    Per la conformità completa ad ACID e per mantenere la durabilità e la coerenza in una configurazione di replica, i flag innodb_flush_log_at_trx_commit e sync_binlog devono essere impostati sul valore predefinito 1. Se modifichi il valore predefinito, la durabilità potrebbe diminuire, il che potrebbe portare a incoerenze tra l'istanza principale e le repliche. Di conseguenza, l'istanza perde la copertura dello SLA. Inoltre, potrebbero verificarsi una delle seguenti situazioni:
    • Perdita di dati in determinate situazioni, ad esempio arresto anomalo della VM o failover per l'istanza HA regionale
    • Dati non sincronizzati nei file di log binario e di dati InnoDB
    • Perdita o errore dei dati PITR
    • Incoerenza dei dati tra un'istanza principale e le relative repliche
    • Una interruzione della replica

    L'impostazione del valore del flag innodb_flush_log_at_trx_commit o sync_binlog su valori non predefiniti per le istanze principali, autonome e HA causa una durata ridotta.

    Se hai bisogno di un rendimento più elevato per le repliche di lettura, ti consigliamo di impostare il valore innodb_flush_log_at_trx_commit su 2. Cloud SQL non supporta l'impostazione del valore di questo flag su 0. Se impostate il valore del flag su 2, dovete disattivare il log binario sulla replica o impostare sync_binlog su un valore diverso da 1 per un rendimento migliore.

    Cloud SQL potrebbe modificare temporaneamente i valori dei flag innodb_flush_log_at_trx_commit e sync_binlog in predefinito durante il backup. Ciò potrebbe causare un calo delle prestazioni durante i backup. Per evitare che ciò influisca sulla tua istanza, puoi modificare la finestra di backup quando l'utilizzo dell'istanza è ridotto. Per saperne di più, consulta Creare e gestire i backup on demand e automatici.

    innodb_flush_log_at_timeout

    innodb_flush_log_at_timeout ti consente di modificare la frequenza degli svuotamenti della pagina per evitare di influire sul rendimento del commit del gruppo di log binario. L'impostazione predefinita è una volta al secondo.

    Cloud SQL ha esteso questo flag per supportare la specifica di un periodo di tempo in microsecondi.

    Esempi:

    • 0.001 per specificare 1 ms
    • 0.0001 per specificare 100 us
    • 12.5 per specificare 12,5 secondi
    • 12.005 per specificare 12 secondi e 5 ms
    • 0.005100 per specificare 5 ms e 100 us

    Per determinati carichi di lavoro, l'utilizzo di una granularità di un secondo intero per la pulizia delle pagine potrebbe non essere accettabile in termini di potenziale perdita di transazioni. In alternativa, puoi svuotare le pagine utilizzando una granularità di microsecondi per mantenere le prestazioni senza compromettere in modo significativo la durabilità.

    I periodi di tempo in microsecondi per il flag innodb_flush_log_at_timeout sono applicabili solo quando il flag di durata innodb_flush_log_at_trx_commit è impostato su 2.

    Lo svuotamento delle pagine potrebbe avvenire con una frequenza maggiore o minore rispetto al valore specificato per innodb_flush_log_at_timeout e il valore non è il limite superiore.

    innodb_redo_log_capacity, innodb_log_file_size

    Se configuri un valore per il innodb_redo_log_capacity innodb_log_file_size, Cloud SQL ignora qualsiasi valore definito per il innodb_log_file_size.

    Se non configuri alcun valore per gli indicatori innodb_redo_log_capacity o innodb_log_file_size, Cloud SQL utilizza il valore predefinito dell'indicatore innodb_redo_log_capacity o 104857600 (100 MB).

    Se non configuri il flag innodb_redo_log_capacity, ma configuri il flag innodb_log_file_size, il valore della dimensione del log di redo innodb viene calcolato come innodb_log_file_size * innodb_log_file_in_group. Ad esempio, se configuri innodb_log_file_size su un valore di 10 GB e il valore predefinito di innodb_log_file_in_group è 2, il valore effettivo della dimensione del log di transazioni innodb è 20 GB.

    max_heap_table_size, tmp_table_size

    L'esaurimento della memoria dell'istanza disponibile può verificarsi quando imposti tmp_table_size e max_heap_table_size su valori troppo elevati per il numero di query simultanee elaborate dall'istanza. L'esaurimento della memoria provoca un arresto anomalo e il riavvio dell'istanza.

    Per ulteriori informazioni sull'utilizzo di questi flag, consulta Come MySQL utilizza le tabelle temporanee interne e Il motore di archiviazione MEMORY.

    performance_schema

    Non puoi attivare questo flag nelle istanze con un core condiviso (meno di 3 GB di RAM). Se attivi questo flag, non puoi modificare il tipo di macchina impostandolo su una dimensione che non supporta il flag. Devi prima disattivare questo flag.

    event_scheduler
    Gli eventi MySQL, noti anche come eventi pianificati, sono attività che puoi pianificare. Gli eventi pianificati sono un gruppo di una o più istruzioni SQL impostate per essere eseguite a uno o più intervalli specificati. Il valore predefinito per MySQL 5.7 è OFF e il valore predefinito per MySQL 8.0 è ON. Per approfondire il flag event_scheduler, consulta event_scheduler. Se il flag event_scheduler è impostato su ON per una replica di lettura, possono verificarsi errori in base al tipo di istruzioni definite negli eventi:
    • Se l'evento pianificato è un evento write su una replica di lettura, viene generato un errore perché le repliche di lettura sono di sola lettura. Per ulteriori informazioni, consulta Repliche di lettura.
    • Se l'evento pianificato contiene un'operazione di arresto, ad esempio kill, event_scheduler la applica alla replica. La replica viene interrotta ed eliminata.
    Per evitare questi errori, imposta il flag event_scheduler su OFF quando crei le repliche.

    Per ulteriori informazioni su come attivare o disattivare event_scheduler, consulta Configurare i flag di database.

    replica_skip_errors,slave_skip_errors
    L'impostazione del flag replica_skip_errors o slave_skip_errors può causare problemi di replica. In genere, se si verifica un errore durante l'esecuzione di un'istruzione, la replica viene interrotta. L'utilizzo di questo flag comporterà il salto dell'errore e la continuazione della replica, con conseguente incoerenza tra l'istanza principale e la replica. Inoltre, può rendere più difficile la risoluzione dei problemi di replica.

    Cloud SQL consiglia di utilizzare questo flag solo se necessario. Se si verificano errori di replica, consulta Risoluzione dei problemi di Cloud SQL: replica per ulteriori informazioni su come risolvere questo problema.

    character_set_client
    character_set_connection
    character_set_results
    collation_connection
    innodb_buffer_pool_dump_now
    innodb_buffer_pool_load_abort
    innodb_buffer_pool_load_now
    innodb_ft_aux_table
    foreign_key_checks
    sql_select_limit
    unique_checks
    Questi flag non possono essere selezionati direttamente nella console Google Cloud o utilizzando gcloud CLI. Per utilizzare questi flag, usa il seguente comando:

    SET GLOBAL FLAG_NAME=FLAG_VALUE

    L'utilizzo del comando SET GLOBAL richiede il privilegio CLOUDSQL_SPECIAL_SYSEM_VARIABLES_ADMIN, che viene concesso al ruolo cloudsqlsuperuser.

    Per ulteriori informazioni su come concedere l'accesso con privilegi speciali a un utente specifico, consulta Informazioni sugli utenti MySQL. Questi flag non vengono memorizzati. Quando l'istanza Cloud SQL viene ricreata o riavviata, le impostazioni dei flag vengono reimpostate sul valore predefinito.

    binlog_order_commits

    Il valore predefinito per il flag binlog_order_commits è ON. Cloud SQL consiglia di non modificare il valore predefinito di questo flag. Se il valore predefinito viene modificato in OFF, le transazioni nello stesso gruppo di log binario verranno committate in un ordine diverso rispetto a quando sono state scritte nel log binario. Ciò influisce sulle seguenti operazioni che eseguono transazioni nell'ordine del log binario:

    • Replica: potrebbe portare a incoerenze dei dati tra l'origine e le repliche
    • Point-in-time-recovery: potrebbe portare a incoerenze dei dati tra lo stato ripristinato del PITR e lo stato storico

    optimizer_switch,optimizer_trace,optimizer_trace_features

    I flag dell'ottimizzatore hanno valori separati da virgole. Puoi impostare questi flag utilizzando la console o gcloud. Per ulteriori informazioni su come impostare questo flag utilizzando la console, consulta Configurare i flag di database. Se utilizzi gcloud, puoi specificare il valore di questi flag in due modi diversi:

    Per impostare più flag secondari dell'ottimizzatore in un unico comando, utilizza il delimitatore virgola per separare ciascun nome di flag. Se imposti un singolo valore di flag secondario utilizzando il comando gcloud, vengono sovrascritti tutti i flag secondari impostati in precedenza. Ad esempio, se esegui il seguente comando, il valore previsto per il flag secondario batched_key_access è impostato su on e tutti gli altri flag secondari per optimizer_flags sono impostati sui valori predefiniti.
    gcloud sql instances patch my-instance --database-flags=^~^optimizer_switch=batched_key_access=on
    Se esegui il seguente comando, il valore del parametro block_nested_loop viene impostato su on e tutti gli altri parametri per optimizer_switch vengono sovrascritti e impostati sui valori predefiniti.
    gcloud sql instances patch my-instance --database-flags=^~^optimizer_switch=block_nested_loop=on
    Sono inclusi batched_key_access, impostato su on dall'ultimo comando. Per mantenere tutti i flag secondari impostati in precedenza e aggiungerne di nuovi, devi aggiungere i valori di tutti i flag secondari che vuoi impostare quando aggiungi un nuovo flag secondario.

    Flag di sistema modificati in Cloud SQL

    Tutti gli altri flag di sistema di database non elencati nella sezione flag supportati sono chiamati flag gestiti. Per alcuni flag gestiti, Cloud SQL imposta il flag su un valore diverso dall'impostazione predefinita per garantire l'esecuzione affidabile delle istanze Cloud SQL. Non puoi modificare i valori di questi flag di sistema.

    Di seguito sono elencati gli indicatori gestiti con un'impostazione non predefinita.

    Nome variabile Impostazione in Cloud SQL. Note
    binlog_format riga Differisce solo in MySQL 5.6
    binlog_error_action ABORT_SERVER Differisce solo in MySQL 5.6
    innodb_doublewrite_pages 64 Si applica a MySQL 8.0.26 e versioni successive
    innodb_file_format Barracuda Differisce solo in MySQL 5.6
    innodb_flush_method O_DIRECT
    memlock true
    skip_name_resolve ON
    relay_log_info_repository TABELLA Rimosso in MySQL 8.4
    relay_log_recovery ON
    master_info_repository TABELLA Rimosso in MySQL 8.4
    rpl_semi_sync_master_enabled 1
    rpl_semi_sync_master_timeout 3000
    admin_address 127.0.0.1 È diverso in MySQL 8.0 e versioni successive.
    create_admin_listener_thread ON
    port-open-timeout 120 È diverso in MySQL 8.0 e versioni successive.
    partial_revokes ON MySQL 8.0 e versioni successive. Per ulteriori informazioni su questo flag, consulta Flag di sistema per i revocali parziali in MySQL 8.0.

    Flag di sistema partial_revokes in MySQL 8.0 e versioni successive

    Il flag partial_revokes consente di limitare l'accesso degli utenti allo schema di un database. In Cloud SQL per MySQL versione 8.0 e successive, il flag partial_revokes è impostato su ON. Ciò limita l'utilizzo dei caratteri jolly quando vengono concessi o revocati i privilegi utente agli schemi di database in MySQL 8.0. Aggiorna l'istruzione GRANT in modo da utilizzare il nome completo dello schema del database anziché i caratteri jolly.

    Ad esempio, se utilizzi il seguente comando con il carattere jolly %\ per concedere privilegi a un utente in MySQL 5.7, all'utente verranno concessi i privilegi per tutti i database che terminano con _foobar.

    GRANT ALL PRIVILEGES ON `%\_foobar`.*  TO  'testuser'@'%';
    

    Tuttavia, in MySQL 8.0, agli utenti verrà concesso l'accesso solo al database corrispondente esattamente a %\_foobar.

    Esistono due diversi modi per concedere l'accesso a più database in MySQL 8.0 e versioni successive.

    1. Puoi concedere autorizzazioni a database specifici utilizzando i nomi completi dei database, come mostrato nel comando seguente:

        grant select on test1_foobar.* to 'testuser'@'%';
        grant select on test2_foobar.* to 'testuser'@'%';
        grant select on test3_foobar.* to 'testuser'@'%';
      
    2. Con partial_revokes, puoi utilizzare i comandi grant e revoke per concedere privilegi utente a tutti gli schemi di database, limitare l'accesso ad alcuni schemi di database.

        grant select on *.* to 'testuser'@'%';
        revoke select on test3_foobar.* from 'testuser'@'%';
      

      In questo modo viene concesso l'accesso a tutti gli schemi di database, limitando al contempo l'accesso a test3_foobar.*.

    Filtri di replica

    I filtri di replica possono essere impostati solo sulle repliche Cloud SQL. Ogni filtro di replica viene impostato come un singolo flag per più database, dove ogni nome di database è separato da una virgola. Puoi configurare un filtro di replica su una replica Cloud SQL utilizzando la console o il seguente comando:

    gcloud sql instances patch REPLICA_NAME --database-flags=^~^REPLICATION_FILTER_NAME=DATABASE_NAME1,DATABASE_NAME, etc

    I filtri di replica non supportano i nomi dei database che contengono valori con virgole. Il valore ^~^ nel comando precedente è necessario per i flag del database che sono valori separati da virgole.

    Quando imposti un flag di filtro di replica, tieni presente quanto segue:

    • Se la replica non è più in stato attivo, i dati filtrati dai filtri di replica possono essere visualizzati sulla replica perché Cloud SQL utilizza i dati di origine dell'istanza principale per ricostruire la replica dell'istanza.
    • Non puoi impostare filtri di replica nello schema mysql.
    • Le regole dei filtri di replica non si applicano alle esportazioni serverless.

    Flag di Index Advisor

    Di seguito è riportato un elenco di flag del database utilizzati da Cloud SQL per MySQL per attivare e gestire le funzionalità specifiche dell'Advisor per gli indici.

    Nome del flag Tipo
    Valori accettabili e note
    Riavvio
    necessario?
    cloudsql_index_advisor boolean
    on | off
    predefinito: off
    cloudsql_index_advisor_auto_advisor_schedule string
    predefinito: 00:00
    No
    cloudsql_index_advisor_run_at_timestamp Datetime
    predefinito: 00:00:00
    No

    Flag con alias

    L'elenco seguente contiene i nomi degli indicatori che sono stati modificati da Cloud SQL per le versioni MySQL 8.0.26 e successive.

    Nome del flag deprecato Nome del nuovo flag
    log_slow_slave_statements log_slow_replica_statements
    master_verify_checksum source_verify_checksum
    slave_checkpoint_group replica_checkpoint_group
    slave_checkpoint_period replica_checkpoint_period
    slave_compressed_protocol replica_compressed_protocol
    slave_net_timeout replica_net_timeout
    slave_parallel_type replica_parallel_type
    slave_parallel_workers replica_parallel_workers
    slave_pending_jobs_size_max replica_pending_jobs_size_max
    slave_preserve_commit_order replica_preserve_commit_order
    slave_skip_errors replica_skip_errors
    slave_sql_verify_checksum replica_sql_verify_checksum
    slave_transaction_retries replica_transaction_retries
    slave_type_conversions replica_type_conversions
    sync_master_info sync_source_info

    Se la tua istanza Cloud SQL utilizza un nome di flag deprecato, modifica l'istanza Cloud SQL, elimina il nome del flag deprecato e aggiungi il nuovo flag all'istanza. Per ulteriori informazioni, consulta Configurare un flag di database.

    Risoluzione dei problemi

    Problema Risoluzione dei problemi
    Dopo aver attivato un flag, l'istanza passa da un panico all'altro e si arresta in modo anomalo. Contatta l' assistenza clienti per richiedere la rimozione dell'avvertimento, seguita da un hard drain. In questo modo, l'istanza viene forzata a riavviare su un host diverso con una configurazione nuova senza il flag o l'impostazione indesiderati.
    Viene visualizzato il messaggio di errore Bad syntax for dict arg quando provi a impostare un flag. I valori dei parametri complessi, come gli elenchi separati da virgole, richiedono un trattamento speciale se utilizzati con i comandi gcloud.

    Passaggi successivi