Configura flag di database

Questa pagina descrive come configurare i flag di database per Cloud SQL e 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 attivare la registrazione 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 Google Cloud console, 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 nell'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 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.

Preparare la directory

Ogni file di configurazione 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 chiamato 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 opzione è 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 eseguire 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 Terraform eseguendo questo comando e inserendo yes al prompt: 
    terraform apply

    Attendi che Terraform visualizzi il messaggio "Apply complete!".

  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, imposta l'argomento deletion_protection su false nel file di configurazione Terraform. 
    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 questo 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 sostituzioni seguenti:

  • 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 sostituzioni seguenti:

  • 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 sono presenti flag esistenti 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 sostituzioni seguenti:

  • 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 sostituzioni seguenti:

  • 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 sono presenti flag esistenti configurati per il database, 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 Google Cloud console, 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

Per reimpostare 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 sostituzioni seguenti:

  • 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 sostituzioni seguenti:

  • 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:

Visualizza 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 consoleGoogle Cloud , seleziona il progetto che contiene l'istanza Cloud SQL per cui vuoi visualizzare i flag di 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

Ottieni 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, 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 sostituzioni seguenti:

  • 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 sostituzioni seguenti:

  • 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 più richiesti per MySQL. I flag non menzionati in questa sezione 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

Flag Cloud SQL Tipo
Valori accettabili e note		 Riavvio
necessario?
activate_all_roles_on_login boolean
on | off
default: off
No
activate_mandatory_roles boolean
on | off
default: on
 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
MySQL 8.4 and earlier: 4000
MySQL 9.7 and later: 10000 		Sì
binlog_cache_size integer
4096 ... 9223372036854775807		 No
binlog_expire_logs_seconds integer
0 o 86400 (1 day) ... 4294967295 (max value)
Il valore predefinito è 86400, ovvero 1 giorno.

Per saperne di più 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 saperne di più 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
1 ... 10000000 default:
- MySQL 8.4 e versioni precedenti: 25000
- MySQL 9.7 e versioni successive: 10000000

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

 No
binlog_transaction_dependency_tracking enumeration

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

 No
block_encryption_mode string
aes-keylen-mode
default: aes-128-ECB
No
bulk_insert_buffer_size integer
0 ... 4294967295
default: 8388608		 No
caching_sha2_password_storage_format string
CRYPT5 | PBKDF2_SHA512
default: CRYPT5 		No
caching_sha2_password_enforce_storage_format boolean
1 (true) | 0 (false)
default: 0 (false) 		No
caching_sha2_password_proxy_users boolean
on | off
predefinito: OFF

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

 No
collation_connection string
predefinito:
MySQL 8.0 e versioni successive - utf8mb4_0900_ai_ci

Per saperne di più 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 saperne di più 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 saperne di più 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 saperne di più 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_avoid_parse_session_logging boolean on | off
default: off 		No
cloudsql_iam_authentication boolean on | off
default: off
Supported in MySQL 5.7 and later for 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: consulta Impostazioni del plug-in di controllo. 		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
default: -1 		No
cloudsql_parameterized_secure_view boolean
on | off
default: off
No
cloudsql_vector boolean on | off
default: off
Sì
cloudsql_vector_iterative_filtering boolean

predefinito: off
No
cloudsql_vector_iterative_filtering_max_neighbors integer
10...1000
predefinito: 500
No
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
connection_memory_chunk_size integer
0 ... 536870912
Predefinito:
MySQL 8.0.28 - 8.0.33: 8912
MySQL 8.0.34 e versioni successive: 8192
No
connection_memory_limit integer
2097152 ... 9223372036854775807
No
connection_memory_status_limit integer
16777216 ... 9223372036854775807
default: 9223372036854775807 		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, è supportata la regolazione automatica 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 questo flag manualmente 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_tmp_storage_engine string
INNODB|MEMORY
default: INNODB 		No
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 criteri di attivazione ALWAYS per assicurarti che gli eventi pianificati vengano eseguiti.

Per saperne di più 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 saperne di più 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 saperne di più 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
global_connection_memory_limit integer
16777216 ... 9223372036854775807
No
global_connection_memory_status_limit integer
16777216 ... 9223372036854775807
default: 9223372036854775807 		No
global_connection_memory_tracking boolean
on | off
Predefinito: off
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
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ò regolare 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 saperne di più 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 saperne di più 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 saperne di più 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
default:
- MySQL 8.4 e versioni precedenti: 25
- MySQL 9.7 e versioni successive: 5		 No
innodb_change_buffering string

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

Predefinito:
- MySQL 8.0 e versioni precedenti: none
- MySQL 8.4 e versioni successive: all		 No
innodb_checksum_algorithm string

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

No
innodb_cloudsql_managed_buffer_pool boolean
on | off
Predefinito: off
No
innodb_cloudsql_managed_buffer_pool_threshold_pct integer
50 ... 99
Intervallo di RAM dell'istanzaPredefinito
< 3 GB di RAMN/A (con core condiviso non supportato)
3-8 GB di RAM90
8-15 GB di RAM92
15-100 GB di RAM95
> 100 GB di RAM97
 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 saperne di più 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 saperne di più 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, 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 saperne di più su questo flag, consulta la sezione Suggerimenti.

 No
innodb_flush_method string

Opzioni: fsync, O_DIRECT, O_DSYNC

Valore predefinito: O_DIRECT		 Sì
innodb_flush_neighbors enumeration
0 ... 2
Valori predefiniti:
- MySQL 5.6: 0
- MySQL 5.7 a MySQL 8.0:2
- MySQL 8.4 e versioni successive: 0 		No
innodb_flush_sync boolean
on | off		 No
innodb_flushing_avg_loops integer
1 ... 1000
Predefinito: 30		 No
innodb_fsync_threshold integer
0 ... 9223372036854775807
Valore predefinito: 0 		No
innodb_ft_aux_table string

Per saperne di più 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_idle_flush_pct integer
0 ... 100
Predefinito: 100 		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 Configura 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 Configura 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 a 8.4: 4194304 ... 274877906944
- MySQL 9.7: rimosso dal database

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

 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_native_foreign_keys boolean
on | off
default: off 		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
default: 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 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
Predefinito: 0

Se utilizzi il valore predefinito 0 per questo flag, i nomi di tabelle e database fanno distinzione tra lettere 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. Una volta 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 il valore di questo 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 saperne di più 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
predefinito: off per MySQL 8.0 e versioni successive istanze con RAM inferiore a 12 GB
predefinito: on per MySQL 8.0 e versioni successive istanze con RAM maggiore o uguale a 12 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

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

 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 pperformance_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_logger_classes integer
0 ... 200
default: 80

Per saperne di più sui flag di performance_schema, consulta la sezione Suggerimenti.

 Sì
performance_schema_max_memory_classes integer
0 ... 1024

Per saperne di più sui flag di 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_show_processlist boolean
on | off
Predefinito: off
No
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 è abilitato 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
default: 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
default: 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 è abilitato 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_generate_invisible_primary_key boolean
on | off
Valore predefinito: off
No
sql_mode string

Consulta la sezione Modalità SQL del server 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 i 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...9223372036854775807
default: 18446744073709551615

Per saperne di più 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 saperne di più su questo flag, consulta la sezione Suggerimenti.

 No
sync_master_info integer
0 ... 4294967295
Valore 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
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
default: 256		 No
table_open_cache integer
1 ... 524288		 No
table_open_cache_instances integer
1 ... 64		 Sì
table_open_cache_triggers integer
1 ... 524288
default: 524288
 No
temptable_max_mmap integer
0 ... 68719476736

Valori predefiniti:

  • MySQL 8.0 e versioni precedenti: 1073741824
  • MySQL 8.4 e versioni successive: 0
 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 saperne di più 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 saperne di più 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: la differenza di fuso orario nell'ora standard (STD).
  • Ora legale: l'offset del fuso orario nell'ora legale.
  • Nomi dei sinonimi: i nomi dei fusi orari che potresti voler utilizzare, ma non sono supportati da Cloud SQL per MySQL. In questo caso, utilizza il nome del fuso orario corrispondente.
nome-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 Stati Uniti/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/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
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
Pacifico/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 STD 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 il 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 saperne di più, 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 per quanto tempo vengono archiviati i log binari nelle repliche. Il flag expire_logs_days è stato rimosso da MySQL 8.4 e versioni successive. Per saperne di più, consulta la sezione Conservazione del 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 massima di allocazione 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 %% predefinitoMassima %
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 o più~20%~72%~72%

I valori esatti potrebbero variare. Quando è abilitato il buffer pool gestito, vengono apportate modifiche al innodb_buffer_pool_size che non si riflettono nella console Google Cloud . Per calcolare il valore attuale per la tua istanza, puoi eseguire la query:

  show global variables like 'innodb_buffer_pool_size';

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

Tipo di macchina RAM dell'istanza (GB) Minuti (GB)
(% del totale)		 Predefinita (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%)

Se la memoria utilizzata è elevata per la tua istanza e si verificano eventi out of memory (OOM), puoi attivare il flag innodb_cloudsql_managed_buffer_pool per ridurre temporaneamente il valore di innodb_buffer_pool_size. Per saperne di più, vedi Abilitare il buffer pool gestito.

Quando il buffer pool gestito apporta modifiche al valore di innodb_buffer_pool_size, le modifiche non vengono riflesse nel valore del flag visualizzato nella console Google Cloud . Per visualizzare il valore corrente di innodb_buffer_pool_size quando è abilitato il buffer pool gestito, puoi interrogare il valore del flag utilizzando il client MySQL: 
show global variables like 'innodb_buffer_pool_size';
innodb_cloudsql_optimized_write
Questo flag è disponibile solo per le istanze della 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. Inoltre, questo flag attiva un algoritmo di recupero migliorato per ridurre il tempo di recupero dagli arresti anomali e utilizza in modo adattivo la velocità effettiva di I/O del disco inutilizzata per accelerare il riscaldamento del buffer pool. Per la maggior parte dei casi d'uso, puoi ottenere prestazioni migliori, come un throughput migliorato e una latenza ridotta, con 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 abilitato 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 più elevato 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 ottenere prestazioni migliori. Cloud SQL potrebbe modificare temporaneamente i valori dei flag innodb_flush_log_at_trx_commit e sync_binlog in modo predefinito 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 Creazione e gestione dei 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

Per Cloud SQL per MySQL versione 8.4 e precedenti, 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 redo log 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 redo log di InnoDB è 20 GB.

In Cloud SQL per MySQL versione 9.7 e successive, i flag innodb_log_file_size e innodb_log_file_in_group vengono rimossi da Cloud SQL. I valori predefiniti per il flag innodb_redo_log_capacity si basano sull'edizione e sulla capacità RAM dell'istanza e sono elencati nella tabella seguente.

Versione Cloud SQLRAMValore predefinito
Versione Enterprise di Cloud SQLQualsiasi dimensione1 GB
Versione Cloud SQL Enterprise Plus<100 GB1 GB
Versione Cloud SQL Enterprise Plus>100 GB1,5 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 saperne di più 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 con una dimensione che non lo supporta. Devi prima disabilitarlo.

Per le istanze MySQL 8.0 e successive con RAM da 12 GB a 15 GB, il valore predefinito di performance_schema è on; tuttavia, gli strumenti dello schema delle prestazioni predefiniti sono disabilitati. Per ulteriori informazioni sugli strumenti dello schema delle prestazioni predefiniti, consulta La tabella setup_instruments (MySQL 8.0) o La tabella setup_instruments (MySQL 8.4). Se vuoi attivare e utilizzare gli strumenti dello schema delle prestazioni in un'istanza RAM da 12 GB a 15 GB, devi impostare esplicitamente il flag performance_schema su on anziché rimandare al valore predefinito. Per le istanze MySQL 8.0 e successive con ≥15 GB di RAM, il valore predefinito di performance_schema è on gli strumenti dello schema delle prestazioni predefiniti sono abilitati.

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, consulta 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, 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 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, 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 riscontri errori di replica, consulta la pagina Risoluzione dei problemi di Cloud SQL: replica per saperne di più 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, utilizza 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. Nota: il privilegio CLOUDSQL_SPECIAL_SYSEM_VARIABLES_ADMIN è disponibile solo in MySQL 8.0 per Cloud SQL. 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.
caching_sha2_password_proxy_users

Utilizza il flag caching_sha2_password_proxy_users per la connettività dell'utente proxy in MySQL 9.7. Poiché il metodo di autenticazione mysql_native_password non è più disponibile in MySQL 9.7, non puoi utilizzare il flag mysql_native_password_proxy_users.

Il flag caching_sha2_password_proxy_users controlla se il plug-in di autenticazione integrata caching_sha2_password supporta gli utenti proxy. Il flag non ha effetto a meno che non sia attivata la variabile di sistema check_proxy_users.

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ò comportare un'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 Google Cloud o gcloud CLI. Per saperne di più su come impostare questo flag utilizzando la console, consulta Configurare i flag di database. Se utilizzi gcloud CLI, 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 del flag secondario utilizzando il comando gcloud CLI, 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 è 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.

In Cloud SQL per MySQL 9.7, puoi specificare il flag hypergraph_optimizer=on per abilitare lo strumento di ottimizzazione degli ipergrafi. Per ulteriori informazioni sulle ottimizzazioni commutabili e sull'ottimizzatore di ipergrafi, consulta Ottimizzazioni commutabili e L'ottimizzatore di ipergrafi è ora disponibile in MySQL 9.7 Community Edition.

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. Il seguente elenco mostra 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
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 saperne di più 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 del 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 si 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 le autorizzazioni a database specifici utilizzando i nomi completi dei database, come mostrato nel seguente comando:

      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 del database, limitando l'accesso a pochi schemi del 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 è 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 della primaria per ricostruire 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 le 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

Il seguente elenco contiene i nomi dei flag modificati da Cloud SQL per MySQL versioni 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, allora 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 quando vengono utilizzati con i comandi gcloud.

Passaggi successivi