Configura flag di database

Questa pagina descrive come configurare i flag di database per Cloud SQL ed elenca i flag che puoi impostare per la tua istanza. Utilizzi i flag di database per molte operazioni, tra cui la modifica dei parametri MySQL, la modifica 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 flag per abilitare completamente la funzionalità che vuoi utilizzare. Ad esempio, per abilitare il logging 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 lo rimuovi. Se l'istanza è l'origine di una replica e viene riavviata, anche la replica viene riavviata per allinearsi alla configurazione attuale dell'istanza.

Configura flag di database

Le sezioni seguenti illustrano le attività comuni di gestione dei flag.

Imposta un flag di database

Console

  1. Nella consoleGoogle Cloud , seleziona il progetto che contiene l'istanza Cloud SQL per cui vuoi impostare un flag di database.
  2. Apri l'istanza e fai clic su Modifica.
  3. Vai alla sezione Flag.
  4. Per impostare un flag che non è stato impostato in precedenza sull'istanza, fai clic su Aggiungi elemento, scegli il flag dal menu a discesa e imposta il relativo 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 in modo specifico viene impostato sul 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 di Terraform in un progetto Google Cloud , completa i passaggi nelle sezioni seguenti.

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 eseguirlo 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 la propria directory (chiamata anche modulo radice).

  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 viene 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.

    (Facoltativo) Copia il codice da GitHub. Questa operazione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

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

    (Facoltativo) Per utilizzare l'ultima versione del provider Google, includi l'opzione -upgrade: 

    terraform init -upgrade

Applica le modifiche

  1. Rivedi la configurazione e verifica che le risorse che Terraform creerà o aggiornerà corrispondano alle tue aspettative: 
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

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

    Attendi che Terraform visualizzi il messaggio "Apply complete!" (Applicazione completata).

  3. Apri il tuo Google Cloud progetto 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 dall'eliminazione, nel file di configurazione Terraform imposta l'argomento deletion_protection su false. 
    deletion_protection =  "false"
  2. Applica la configurazione Terraform aggiornata eseguendo il comando seguente 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 l'utilizzo di 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": "general_log",
        "value": "on"
      }
    ]
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Se per il database sono configurati flag esistenti, 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 l'utilizzo di 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": "general_log",
        "value": "on"
      }
    ]
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Cancella tutti i flag e ripristina i valori predefiniti

Console

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

gcloud

Cancella tutti i flag e ripristina i valori predefiniti di 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 la seguente istruzione:

 SHOW VARIABLES;

Tieni presente che puoi modificare il valore solo per i flag supportati (come elencato di seguito).

Determinare 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 Google Cloud console, seleziona il progetto che contiene l'istanza Cloud SQL per cui vuoi visualizzare i flag 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 raccolta databaseFlags. Per saperne di più sulla rappresentazione dei flag nell'output, vedi 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 quelli più comunemente 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 saperne di più 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
default: 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
default: max_connections
Sì
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 		Sì
binlog_order_commits boolean
on | off
predefinito: on

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

 No
binlog_row_image enumeration
full (predefinito), minimal o noblob		 No
binlog_row_metadata enumeration
full o minimal (impostazione predefinita)		 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 valori accettabili, consulta Configurazione della replica parallela.

 No
binlog_transaction_dependency_tracking enumeration

Per informazioni su come utilizzare questo flag e sui valori accettabili, consulta Configurazione della 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
default: 8388608		 No
collation_connection string
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
default:
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
default:
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)		 Sì
check_proxy_users boolean
on | off
predefinito: off 		No
cloudsql_allow_analyze_table boolean on | off
default: off
No
cloudsql_iam_authentication boolean on | off
default: off
Supportato in MySQL 5.7 e versioni successive per Cloud SQL. 		No
cloudsql_ignore_innodb_encryption boolean on | off
default: 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

default: 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
predefinito: 500 millisecondi 		No
cloudsql_mysql_audit_max_query_length integer
-1...1073741824
default: -1 		No
cloudsql_vector boolean on | off
default: off
Sì
cloudsql_vector_max_mem_size integer
1073741824...innodb_buffer_pool_size/2
default: 1073741824 in bytes
Sì
completion_type enumeration
NO_CHAIN (predefinito), CHAIN o RELEASE		 No
concurrent_insert enumeration
NEVER, AUTO (predefinita) o ALWAYS		 No
connect_timeout integer
2 ... 31536000
default: 10		 No
cte_max_recursion_depth integer
0 ... 4294967295
default: 1000		 No
default_authentication_plugin string
mysql_native_password|caching_sha2_password
Sì
default_password_lifetime integer 0...65535
default: 0
No
default_time_zone string
Esistono due modi per specificare i fusi orari: come offset del fuso orario e come nomi dei fusi orari. Ad esempio, +00:00 è l'offset del fuso orario per Londra (che si trova nel fuso orario UTC) e Europe/London è il nome del fuso orario.

Utilizzi i valori per specificare gli offset del fuso orario, da -12:59 a +13:00. Gli zeri iniziali sono obbligatori.

Quando si utilizzano i nomi dei fusi orari, è supportato l'adeguamento automatico all'ora legale. Quando utilizzi gli scarti di fuso orario, non è supportato. Visualizza un elenco dei nomi dei fusi orari supportati da Cloud SQL per MySQL. Per tenerne conto, devi aggiornare manualmente questo flag sull'istanza principale e su tutte le repliche di lettura.

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

 Sì
default_week_format integer
0 ... 7
default: 0		 No
delay_key_write enumeration
OFF, ON (predefinito) o ALL		 No
disconnect_on_expired_password boolean on | off
default: on
Sì
div_precision_increment integer
0 ... 30
default: 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 Event Scheduler, configura l'istanza con un criterio di attivazione ALWAYS 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 nessuna 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
default: 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		 Sì
ft_min_word_len integer
1 ... 16		 Sì
ft_query_expansion_limit integer
0 ... 1000		 Sì
ft_stopword_file string
 Sì
general_log boolean
on | off

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

 No
generated_random_password_length integer 5-255
default: 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+): 0 		No
histogram_generation_max_mem_size integer
1000000 ... 4294967295
default: 20000000 		No
init_connect string No
innodb_adaptive_hash_index boolean
on | off		 No
innodb_adaptive_hash_index_parts integer
1 ... 512		 Sì
innodb_adaptive_max_sleep_delay integer
0 ... 1000000		 No
innodb_autoextend_increment integer
1 ... 1000		 No
innodb_autoinc_lock_mode integer
0 ... 2		 Sì
innodb_buffer_pool_chunk_size integer
1048576 ... (innodb_buffer_pool_size/innodb_buffer_pool_instances)

Il valore di questo 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.

Sì
innodb_buffer_pool_dump_pct integer
1 ... 100
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		 Sì
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		 Sì
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_cloudsql_optimized_write boolean

Questo flag è disponibile solo per le istanze con la versione Cloud SQL Enterprise Plus. Per saperne di più su questo flag, consulta la sezione Suggerimenti.

 Sì
innodb_cmp_per_index_enabled boolean
on | off		 No
innodb_commit_concurrency integer
0 ... 1000		 Sì
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
Predefinito: 0		 Sì
innodb_doublewrite_files integer
2 ... 128		 Sì
innodb_doublewrite_pages integer
4 ... 512
Predefinito: 64		 Sì
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
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
Predefinito: 1

Se promuovi una replica con questo flag abilitato, il flag viene rimosso automaticamente, facendo in modo che la replica promossa abbia una durabilità completa per impostazione predefinita. Per utilizzare questo flag con una replica promossa, puoi aggiornarlo alla 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.

    		 Sì
    innodb_ft_cache_size integer
    1600000 ... 80000000    		 Sì
    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    		 Sì
    innodb_ft_min_token_size integer
    0 ... 16    		 Sì
    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    		 Sì
    innodb_ft_total_cache_size integer
    32000000 ... 1600000000    		 Sì
    innodb_ft_user_stopword_table string No
    innodb_io_capacity integer
    100 ... 100000
    Predefinito: 5000

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

    		No
    innodb_io_capacity_max integer
    100 ... 100000
    Predefinito: 10000

    Per scoprire di più sulla configurazione delle prestazioni del disco, 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    		 Sì
    innodb_log_checksums boolean
    on | off
    default: on    		 No
    innodb_log_file_size integer
    MySQL 5.6: 1048576 ... 274877906944
    MySQL 5.7 e versioni successive: 4194304 ... 274877906944     		Sì
    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
    default:
    MySQL 5.7: 2000
    MySQL 8.0 and later: 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 configurato per il flag innodb_buffer_pool_instances.    		 Sì
    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 integer
    1 ... 32
    Valori predefiniti:
  • MySQL 5.6: 1
  • MySQL 5.7 e versioni successive: 4
    		•  Sì
    innodb_random_read_ahead boolean
    on | off    		 No
    innodb_read_ahead_threshold integer
    0 ... 64    		 No
    innodb_read_io_threads integer
    1 ... 64     		Sì
    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 saperne di più su questo flag, consulta la sezione Suggerimenti.

    		 No
    innodb_replication_delay integer
    0 ... 4294967295    		 No
    innodb_rollback_on_timeout boolean
    on | off    		 Sì
    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    		 Sì
    innodb_spin_wait_delay integer
    MySQL 5.7: 0 ... 1000000
    MySQL 8.0.13+: 0 ... 1000
    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.

    		 Sì
    innodb_sync_spin_loops integer
    0 ... 4294967295
    default: 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    		 Sì
    innodb_write_io_threads integer
    1 ... 64    		 Sì
    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
    default: 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
    default:
    MySQL 5.7: 3
    MySQL 8.0 and later: 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 Predefinito: off     		No
    log_slow_slave_statements boolean
    on | off 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 consente 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
    Predefinito: 0

    Se utilizzi il valore predefinito 0 per questo flag, i nomi di tabelle e database fanno distinzione tra maiuscole e minuscole. Se impostato su 1, i nomi di tabelle e 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 l'impatto della modifica sulle tabelle e sui database esistenti.

    Per le istanze MySQL 8.0 e successive, puoi impostare il valore di questo flag sul valore desiderato solo durante la creazione di un'istanza. Dopo aver impostato questo valore, non potrai più 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.

    		Sì
    mandatory_roles string role name
    default: empty string
    		No
    master_verify_checksum boolean
    on | off 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    		 Sì
    max_error_count integer
    0 ... 65535
    default:
    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     		Sì
    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
    default: 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
    default: 2     		Sì
    optimizer_prune_level integer
    0 ... 1    		 No
    optimizer_search_depth integer
    0 ... 62    		 No
    optimizer_switch multi-value repeated string

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

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

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

    		 No
    optimizer_trace_features multi-value repeated string

    Per ulteriori informazioni sui flag multivalore, 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
    default: 0
    		No
    password_require_current boolean on | off
    default: off
    		No
    password_reuse_interval integer 0-4294967295
    default: 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

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

    		 Sì
    performance_schema_accounts_size integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_digests_size integer
    -1 ... 1048576

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

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

    Consulta la sezione Suggerimenti per ulteriori informazioni sui flag performance_schema.

    		 Sì
    performance_schema_events_statements_history_long_size integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_events_statements_history_size integer
    -1 ... 1024

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

    		 Sì
    performance_schema_events_transactions_history_long_size integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_events_transactions_history_size integer
    -1 ... 1024

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

    		 Sì
    performance_schema_events_waits_history_long_size integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_events_waits_history_size integer
    -1 ... 1024

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

    		 Sì
    performance_schema_hosts_size integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_max_cond_classes integer
    0 ... 256

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

    		 Sì
    performance_schema_max_cond_instances integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_max_digest_length integer
    0 ... 1048576

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

    		 Sì
    performance_schema_max_digest_sample_age integer
    0 ... 1048576
    default: 60     		No
    performance_schema_max_file_classes integer
    0 ... 256

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

    		 Sì
    performance_schema_max_file_handles integer
    0 ... 1048576

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

    		 Sì
    performance_schema_max_file_instances integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_max_index_stat integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_max_memory_classes integer
    0 ... 1024

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

    		 Sì
    performance_schema_max_metadata_locks integer
    -1 ... 104857600

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

    		 Sì
    performance_schema_max_mutex_classes integer
    0 ... 256

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

    		 Sì
    performance_schema_max_mutex_instances integer
    -1 ... 104857600

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

    		 Sì
    performance_schema_max_prepared_statements_instances integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_max_program_instances integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_max_rwlock_classes integer
    0 ... 256

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

    		 Sì
    performance_schema_max_rwlock_instances integer
    -1 ... 104857600

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

    		 Sì
    performance_schema_max_socket_classes integer
    0 ... 256

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

    		 Sì
    performance_schema_max_socket_instances integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_max_sql_text_length integer
    0 ... 1048576

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

    		 Sì
    performance_schema_max_stage_classes integer
    0 ... 256

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

    		 Sì
    performance_schema_max_statement_classes integer
    0 ... 256

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

    		 Sì
    performance_schema_max_statement_stack integer
    1 ... 256

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

    		 Sì
    performance_schema_max_table_handles integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_max_table_instances integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_max_table_lock_stat integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_max_thread_classes integer
    0 ... 256

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

    		 Sì
    performance_schema_max_thread_instances integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_session_connect_attrs_size integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_setup_actors_size integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_setup_objects_size integer
    -1 ... 1048576

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

    		 Sì
    performance_schema_users_size integer
    -1 ... 1048576

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

    		 Sì
    preload_buffer_size integer
    1024 ... 1073741824
    default: 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, in quanto la cache delle query è deprecata a partire da MySQL 5.7.20 ed è stata 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, in quanto la cache delle query è deprecata a partire da MySQL 5.7.20 ed è stata rimossa in MySQL 8.0.

    		 No
    query_cache_size integer
    0 ... 223338299392

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

    		 No
    query_cache_type enumeration
    0 ... 2

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

    		 Sì
    query_cache_wlock_invalidate boolean
    on | off

    Questo flag non è disponibile per MySQL 8.0 e versioni successive, in quanto la cache delle query è deprecata a partire da MySQL 5.7.20 ed è stata 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
    default: 32     		No
    replica_checkpoint_group integer
    32 ... 524280
    Il valore predefinito è 512.

    Questo flag non influisce sulle repliche per cui non è attivato il multithreading.

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

    L'unità è in millisecondi.

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

    L'unità è in secondi.

    		 No
    replica_parallel_type enumeration
    DATABASE, LOGICAL_CLOCK
    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 valori accettabili, consulta Configurazione della replica parallela.

    		 No
    replica_parallel_workers integer

    Per informazioni su come utilizzare questo flag e sui valori accettabili, consulta Configurazione della replica parallela.

    		 No
    replica_pending_jobs_size_max integer

    Per informazioni su come utilizzare questo flag e sui valori accettabili, consulta Configurazione della replica parallela.

    		 No
    replica_preserve_commit_order boolean

    Per informazioni su come utilizzare questo flag e sui valori accettabili, consulta Configurazione della replica parallela.

    		 No
    replica_skip_errors string
    Predefinito: OFF

    Per saperne di più su questo flag, consulta la sezione Suggerimenti.

    		 Sì
    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 saperne di più su come utilizzare questo flag, consulta la sezione Filtri di replica.

    		 No
    replicate_do_table string

    Per saperne di più su come utilizzare questo flag, consulta la sezione Filtri di replica.

    		 No
    replicate_ignore_db string

    Per saperne di più su come utilizzare questo flag, consulta la sezione Filtri di replica.

    		 No
    replicate_ignore_table string

    Per saperne di più su come utilizzare questo flag, consulta la sezione Filtri di replica.

    		 No
    replicate_wild_do_table string

    Per saperne di più su come utilizzare questo flag, consulta la sezione Filtri di replica.

    		 No
    replicate_wild_ignore_table string

    Per saperne di più su come utilizzare questo flag, consulta la sezione Filtri di replica.

    		 No
    rpl_read_size integer
    8192 ... 4294959104
    default: 8192     		No
    schema_definition_cache integer
    256 ... 524288
    default: 256     		No
    session_track_gtids string
    OFF | OWN_GTID | ALL_GTIDS
    predefinito: OFF     		No
    session_track_schema boolean
    on | off
    default: on     		No
    session_track_state_change boolean
    on | off
    default: 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
    default: 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     		Sì
    skip_show_database flag
    on | off    		 Sì
    slave_checkpoint_group integer
    32 ... 524280
    Il valore predefinito è 512.

    Questo flag non influisce sulle repliche per cui non è attivato il multithreading.

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

    L'unità è in millisecondi.

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

    L'unità è in secondi.

    		 No
    slave_parallel_type enumeration
    DATABASE, LOGICAL_CLOCK
    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 valori accettabili, consulta Configurazione della replica parallela.

    		 No
    slave_parallel_workers integer

    Per informazioni su come utilizzare questo flag e sui valori accettabili, consulta Configurazione della replica parallela.

    		 No
    slave_preserve_commit_order boolean

    Per informazioni su come utilizzare questo flag e sui valori accettabili, consulta Configurazione della replica parallela.

    		 No
    slave_pending_jobs_size_max integer

    Per informazioni su come utilizzare questo flag e sui valori accettabili, consulta Configurazione della replica parallela.

    		 No
    slave_skip_errors string
    Predefinito: OFF

    Per saperne di più su questo flag, consulta la sezione Suggerimenti.

    		 Sì
    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
    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
    Predefinito: off     		No
    sql_mode string

    Consulta la sezione Server SQL Modes nella documentazione di MySQL per 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 flag sql_mode. Anziché utilizzare un valore vuoto, imposta questo flag sulla modalità NO_ENGINE_SUBSTITUTION.

    		 No
    sql_require_primary_key boolean
    on | off
    Predefinito: off    		 No
    sql_select_limit integer 0...18446744073709551615
    default: 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
    Predefinito: 256    		 No
    sync_binlog integer
    0 ... 4294967295

    L'impostazione predefinita 1 attiva la sincronizzazione del log binario su disco prima del commit delle transazioni.

    Se promuovi una replica con questo flag abilitato, il flag viene rimosso automaticamente, facendo in modo che la replica promossa abbia una durabilità completa per impostazione predefinita. Per utilizzare questo flag con una replica promossa, puoi aggiornarlo alla replica dopo la promozione.

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

    		 No
    sync_master_info integer
    0 ... 4294967295
    Predefinito: 10000     		No
    sync_relay_log integer
    0 ... 4294967295
    Predefinito: 10000    		 No
    sync_relay_log_info integer
    0 ... 4294967295
    Predefinito: 10000    		 No
    sync_source_info integer
    0 ... 4294967295
    Valore predefinito: 10000     		No
    sysdate_is_now boolean
    on | off
    predefinito: off     		Sì
    table_definition_cache integer
    400 ... 524288    		 No
    tablespace_definition_cache integer
    256 ... 524288
    Predefinito: 256    		 No
    table_open_cache integer
    1 ... 524288    		 No
    table_open_cache_instances integer
    1 ... 64    		 Sì
    temptable_max_mmap integer
    0 ... 68719476736
    Predefinito: 1073741824    		 No
    temptable_max_ram integer
    2097152 ... 68719476736
    Predefinito: 1073741824    		 No
    thread_cache_size integer
    0 ... 16384    		 No
    thread_stack integer
    131072 ... 9223372036854775807    		 Sì
    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    		 Sì
    transaction_prealloc_size integer
    1024 ... 131072    		 No
    transaction_write_set_extraction enumeration

    Per informazioni su come utilizzare questo flag e sui valori accettabili, consulta Configurazione della 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
    Predefinito: on     		No

    Nomi dei fusi orari

    In questa sezione, scoprirai 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 nell'ora solare (STD).
    • Ora legale: l'offset del fuso orario durante l'ora legale.
    • Nomi dei sinonimi: i nomi dei fusi orari che potresti voler utilizzare, ma non sono supportati da Cloud SQL per MySQL. Se si verifica questa situazione, utilizza il nome del fuso orario corrispondente.
    nome del fuso orario STD 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/Asuncion −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 Messico/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/Dhaka +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
    Antarctica/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/Tehran +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/West
    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
    Europa/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 Europa/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/Centrali −06:00 −05:00 America/Chicago
    US/Eastern −05:00 −04:00 America/New_York
    US/East-Indiana −05:00 −04:00 America/Indiana/Indianapolis
    America/Indianapolis
    America/Fort_Wayne
    US/Mountain −07:00 −06:00 America/Denver
    US/Pacifico −08:00 −07:00 America/Los_Angeles
    UTC +00:00 +00:00 Etc/UTC
    Etc/UCT
    Etc/Universal
    Etc/Zulu

    Potrebbe essere necessario aggiornare le tabelle dei fusi orari in Cloud SQL con i dati più recenti. Ad esempio, un paese potrebbe passare da un offset del fuso orario dell'ora legale a un offset dell'ora solare oppure potrebbe introdurre un nuovo fuso orario.

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

    Puoi attendere la normale periodo di manutenzione per il rilascio della CSA oppure eseguire la manutenzione self-service per aggiornare le tabelle dei fusi orari con i dati più recenti. Per saperne di più sulla visualizzazione delle 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 è disponibile utilizzando il visualizzatore log nella console Google Cloud . Tieni presente che si applicano i costi di logging di Google Cloud Observability. Per ridurre al minimo il costo di archiviazione dell'istanza, i log general e slow query sul disco dell'istanza vengono ruotati quando il file di log ha più di 24 ore (e non sono state apportate modifiche in questo periodo) o ha una dimensione superiore a 100 MB. I file di log precedenti 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 nel database di sistema MySQL. Potrebbe consumare una quantità considerevole di spazio su disco. Se questa tabella diventa grande, può influire sul tempo di riavvio dell'istanza o causare la perdita della copertura dello SLA. 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 instances.truncateLog.

    expire_logs_days, binlog_expire_logs_seconds
    Se abiliti il recupero point-in-time, il periodo di scadenza dei log binari è determinato dal periodo di conservazione dei log delle transazioni e dai valori di questi flag. Puoi utilizzare questi flag per gestire il periodo di tempo durante il quale i log binari vengono archiviati nelle repliche. Il flag expire_logs_days è stato rimosso da MySQL 8.4 e versioni successive. Per maggiori informazioni, consulta la pagina Conservazione dei log delle transazioni.
    innodb_buffer_pool_size

    Il valore di questo flag è la dimensione in byte del buffer pool. La dimensione del buffer pool deve essere sempre uguale o un multiplo del valore ottenuto moltiplicando innodb_buffer_pool_chunk_size per innodb_buffer_pool_instances. Se modifichi le dimensioni del pool di buffer con un valore non uguale o multiplo di innodb_buffer_pool_chunk_size moltiplicato per innodb_buffer_pool_instances, Cloud SQL regola automaticamente le dimensioni 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 è in genere impostato vicino al valore massimo consentito. La percentuale di allocazione massima consentita aumenta con le dimensioni dell'istanza. Il valore minimo consentito è in genere circa il 20% della RAM dell'istanza.

    Valori approssimativi per questo flag:

    Intervallo di RAM dell'istanzaMin %Percentuale predefinita% max
    0 - 4 GB di RAM~34%
    4 GB - 7,5 GB~20%~34%~34%
    7,5 GB - 12 GB~20%~52%~52%
    12GB - 24GB~20%~67%~67%
    24 GB e versioni successive~20%~72%~72%

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

      show global variables like 'innodb_buffer_pool_size';

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

    Tipo di macchina RAM dell'istanza (GB) Min (GB)
    (% del totale)    		 Predefinito (GB)
    (% del totale)    		 Max (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_cloudsql_optimized_write
    Questo flag è disponibile solo per le istanze con la versione Cloud SQL Enterprise Plus. Il valore predefinito è ON.

    Questo flag migliora le prestazioni di scrittura ottimizzando l'algoritmo di svuotamento, controllando i limiti di svuotamento e modificando l'attività in background per dare la priorità alle operazioni di scrittura del database.

    Per la maggior parte dei casi d'uso, puoi ottenere prestazioni migliori, come un throughput migliorato e una latenza ridotta, se questo flag è abilitato. Tuttavia, se le operazioni di scrittura del database causano un carico estremamente elevato sul server, il flag può ritardare alcune attività in background. Questo ritardo può causare un leggero aumento dell'utilizzo del disco, che diminuisce automaticamente dopo che il carico si attenua.

    Per impostazione predefinita, il flag innodb_cloudsql_optimized_write è attivato per tutte le istanze Cloud SQL Enterprise Plus nuove e aggiornate. Per le istanze Cloud SQL Enterprise Plus esistenti, questo flag viene attivato dopo l'applicazione dell'aggiornamento della manutenzione correlato.

    Se devi disattivare il flag, esegui il seguente comando.

    gcloud sql instances patch INSTANCE_NAME \
 --database-flags="innodb_cloudsql_optimized_write=OFF"

    La modifica del valore del flag richiede il riavvio dell'istanza.

    innodb_file_per_table

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

    innodb_flush_log_at_trx_commit, sync_binlog
    Per la piena conformità 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 comportare incoerenza tra l'istanza principale e le repliche. Pertanto, l'istanza perde la copertura dello SLA. Inoltre, potrebbe verificarsi una delle seguenti situazioni:
    • Perdita di dati in determinate situazioni, ad esempio un arresto anomalo della VM o un failover per l'istanza HA regionale
    • Dati non sincronizzati nel log binario e nei file di dati InnoDB
    • Perdita o errore dei dati PITR
    • Incoerenza dei dati tra un'istanza principale e le relative repliche
    • 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 durabilità ridotta.

    Se hai bisogno di un rendimento migliore per le repliche di lettura, ti consigliamo di impostare il valore di innodb_flush_log_at_trx_commit su 2. Cloud SQL non supporta l'impostazione del valore di questo flag su 0. Se imposti il valore del flag su 2, devi 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 quelli predefiniti durante l'esecuzione di un backup. Ciò potrebbe causare una riduzione delle prestazioni durante l'esecuzione dei backup. Per evitare che ciò influisca sulla tua istanza, puoi modificare la finestra di backup quando l'utilizzo dell'istanza è basso. Per saperne di più, consulta Creare e gestire i backup on demand e automatici.

    innodb_flush_log_at_timeout

    innodb_flush_log_at_timeout consente di modificare la frequenza dei flush di pagina per evitare di influire sul rendimento del commit del gruppo di log binari. 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 alcuni workload, l'utilizzo della granularità di un secondo intero per lo svuotamento delle pagine potrebbe essere inaccettabile in termini di potenziale perdita di transazioni. Puoi invece 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 durabilità 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 flag innodb_redo_log_capacity, Cloud SQL ignora qualsiasi valore definito per il flag innodb_log_file_size.

    Se non configuri alcun valore per i flag innodb_redo_log_capacity o innodb_log_file_size, Cloud SQL utilizza il valore predefinito del flag innodb_redo_log_capacity, ovvero 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 ripristino di InnoDB viene calcolato come innodb_log_file_size * innodb_log_file_in_group. Ad esempio, se configuri innodb_log_file_size con un valore di 10 GB e il valore predefinito di innodb_log_file_in_group è 2, il valore effettivo della dimensione del log di ripetizione di 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 comporta l'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 sulle istanze con un core condiviso (meno di 3 GB di RAM). Se abiliti questo flag, non puoi modificare il tipo di macchina in una dimensione che non lo supporta. Devi prima disabilitarlo.

    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 l'esecuzione a uno o più intervalli specificati. Il valore predefinito per MySQL 5.7 è OFF e il valore predefinito per MySQL 8.0 è ON. Per scoprire di più sul 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, si verifica un errore perché le repliche di lettura sono di sola lettura. Per ulteriori informazioni, vedi Repliche di lettura.
    • Se l'evento pianificato contiene un'operazione di interruzione, ad esempio kill, event_scheduler la applica alla replica. Questa operazione interrompe la replica ed elimina la replica.
    Per evitare questi errori, imposta il flag event_scheduler su OFF quando crei repliche.

    Per ulteriori informazioni su come attivare o disattivare event_scheduler, vedi Configurazione dei 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 generale, se si verifica un errore durante l'esecuzione di un'istruzione, la replica viene interrotta. L'utilizzo di questo flag comporta l'ignoramento dell'errore e la continuazione della replica, il che porta a un'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 comando seguente:

    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 sono persistenti. Quando l'istanza Cloud SQL viene ricreata o riavviata, le impostazioni dei flag vengono ripristinate al valore predefinito.

    binlog_order_commits

    Il valore predefinito del 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 binari verranno commit 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: può causare incoerenza dei dati tra l'origine e le repliche
    • Point-in-time-recovery: potrebbe causare incoerenza dei dati tra lo stato ripristinato del recupero point-in-time e lo stato storico

    optimizer_switch,optimizer_trace,optimizer_trace_features

    I flag di ottimizzazione hanno valori separati da virgole. Puoi impostare questi flag utilizzando la console o gcloud. Per maggiori informazioni su come impostare questo flag utilizzando la console, vedi 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 ogni nome del flag. Se imposti un singolo valore di flag secondario utilizzando il comando gcloud, questo sovrascrive 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 flag secondario block_nested_loop viene impostato su on e tutti gli altri flag secondari per optimizer_switch vengono sovrascritti e impostati sui valori predefiniti. 
    gcloud sql instances patch my-instance --database-flags=^~^optimizer_switch=block_nested_loop=on
     Ciò include batched_key_access, che è stato impostato su on dal comando precedente. 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 ne aggiungi uno nuovo.

    Flag di sistema modificati in Cloud SQL

    Tutti gli altri flag del sistema di database non elencati nella sezione Flag supportati sono chiamati flag gestiti. Per determinati flag gestiti, Cloud SQL imposta il flag su un valore diverso dall'impostazione predefinita per garantire che le istanze Cloud SQL vengano eseguite in modo affidabile. Non puoi modificare i valori di questi flag di sistema.

    Di seguito sono elencati i flag gestiti con un'impostazione non predefinita.

    Nome variabile Impostazione in Cloud SQL. Note
    binlog_format ROW 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 Differisce in MySQL 8.0 e versioni successive.
    create_admin_listener_thread ON
    port-open-timeout 120 Differisce in MySQL 8.0 e versioni successive.
    partial_revokes ON MySQL 8.0 e versioni successive. Per ulteriori informazioni su questo flag, consulta Partial revokes system flag 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 a uno schema di database. In Cloud SQL per MySQL versione 8.0 e successive, il flag partial_revokes è impostato su ON. Ciò limita l'utilizzo di caratteri jolly quando si concedono o revocano i privilegi utente agli schemi di database in MySQL 8.0. Aggiorna l'istruzione GRANT per utilizzare il nome completo dello schema del database anziché utilizzare 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 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 che corrisponde esattamente a %\_foobar.

    Esistono due modi diversi 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 riportato di seguito:

        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 i privilegi utente su tutti gli schemi di database e limitare l'accesso a pochi schemi di database.

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

      Ciò concede l'accesso a tutti gli schemi di database limitando 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 singolo flag per più database in cui 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 di database che contengono valori di virgola. 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ù integra, i dati filtrati dai filtri di replica possono essere visualizzati sulla replica poiché Cloud SQL utilizza i dati di origine dalla primaria per ricreare la replica dell'istanza.
    • Non puoi impostare filtri di replica sullo schema mysql.
    • Le regole di filtro della replica non si applicano alle esportazioni serverless.

    Flag di Index Advisor

    Di seguito è riportato un elenco di flag di database utilizzati da Cloud SQL per MySQL per attivare e gestire funzionalità specifiche di index advisor.

    Nome del contrassegno Tipo
    Valori accettabili e note    		 Riavvio
    necessario?
    cloudsql_index_advisor_auto_advisor_schedule string
    default: 00:00     		No
    cloudsql_index_advisor_run_at_timestamp Datetime
    default: 00:00:00     		No

    Flag con alias

    L'elenco seguente contiene i nomi dei flag modificati da Cloud SQL per MySQL versione 8.0.26 e successive.

    Nome flag deprecato Nuovo nome del 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 flag ritirato, modifica l'istanza Cloud SQL, elimina il nome flag ritirato e aggiungi il nuovo flag all'istanza. Per saperne di più, consulta Configurare un flag di database.

    Risoluzione dei problemi

    Problema Risoluzione dei problemi
    Dopo aver attivato un flag, l'istanza esegue un loop tra panico e arresto anomalo. Contatta l' assistenza clienti per richiedere la rimozione del flag seguita da un hard drain. In questo modo, l'istanza viene riavviata su un host diverso con una nuova configurazione senza il flag o l'impostazione indesiderati.
    Visualizzi 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