Datenbank-Flags konfigurieren

Auf dieser Seite wird gezeigt, wie Sie Datenbank-Flags für Cloud SQL konfigurieren und welche Flags Sie für Ihre Instanz festlegen können. Sie können Datenbank-Flags für viele Vorgänge verwenden, z. B. für das Anpassen von MySQL-Parametern und Optionen sowie für das Konfigurieren und Optimieren einer Instanz.

In einigen Fällen muss vor dem Setzen eines Flags ein anderes Flag gesetzt werden, damit die Funktionalität in vollem Umfang genutzt werden kann. Beispiel: Zum Aktivieren des langsamen Abfrage-Loggings müssen Sie sowohl das Flag slow_query_log auf on als auch das Flag log_output auf FILE setzen. Nur so sind die Logs in der Loganzeige der Google Cloud Console verfügbar.

Wenn Sie ein Flag für eine Datenbankinstanz festlegen, entfernen oder ändern, wird die Datenbank möglicherweise neu gestartet. Der Wert des Flags wird dann für die Instanz beibehalten, bis Sie es entfernen. Wenn die Instanz die Quelle für ein Replikat ist, wird das Replikat ebenfalls neu gestartet, um es an die aktuelle Konfiguration der Instanz anzupassen.

Datenbank-Flags konfigurieren

Wert für Datenbank-Flag festlegen

Console

  1. Erstellen Sie in der Google Cloud Console ein neues Cloud Console-Projekt oder rufen Sie ein vorhandenes Projekt durch Auswahl des Projektnamens auf.
  2. Öffnen Sie die Instanz und klicken Sie auf Bearbeiten.
  3. Scrollen Sie nach unten zum Abschnitt Flags.
  4. Zum Setzen eines neuen Flags, das noch nicht in der Instanz gesetzt wurde, klicken Sie auf Zeile hinzufügen, wählen Sie das Flag aus dem Drop-down-Menü aus und legen Sie dessen Wert fest.
  5. Klicken Sie auf Speichern, um die Änderungen zu speichern.
  6. Bestätigen Sie die Änderungen auf der Übersichtsseite unter Flags.

gcloud

Bearbeiten Sie die Instanz:

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

Mit diesem Befehl werden alle zuvor festgelegten Datenbank-Flags überschrieben. Wenn Sie diese Flags beibehalten und neue Flags hinzuzufügen möchten, geben Sie die Werte für alle Flags an, die Sie für die Instanz festlegen möchten. Für alle Flags, die nicht ausdrücklich angegeben werden, gilt der Standardwert. Für Flags, die keinen Wert haben, geben Sie den Flag-Namen gefolgt von einem Gleichheitszeichen ("=") ein.

Die Flags general_log, skip_show_database und wait_timeout können Sie beispielsweise mit folgendem Befehl festlegen:

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

REST

Mit der Anfrage unten legen Sie ein Flag für eine vorhandene Datenbank fest.

Ersetzen Sie diese Werte in den folgenden Anweisungen:

  • project-id: die Projekt-ID
  • instance-id: die Instanz-ID

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

So legen Sie beispielsweise das Flag general_log für eine vorhandene Datenbank fest:

Ersetzen Sie diese Werte in den folgenden Anweisungen:

  • project-id: die Projekt-ID
  • instance-id: die Instanz-ID

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

Wenn bereits konfigurierte Flags für die Datenbank vorhanden sind, ändern Sie den obigen Befehl und fügen diese ein. Der Befehl PATCH überschreibt vorhandene Flags mit den Flags, die in der Anfrage festgelegt sind.

Alle Flags auf Standardwert zurücksetzen

Console

  1. Erstellen Sie in der Google Cloud Console ein neues Cloud Console-Projekt oder rufen Sie ein vorhandenes Projekt durch Auswahl des Projektnamens auf.
  2. Öffnen Sie die Instanz und klicken Sie auf Bearbeiten.
  3. Öffnen Sie den Bereich Datenbank-Flags.
  4. Klicken Sie neben allen angezeigten Flags auf X.
  5. Klicken Sie auf Speichern, um die Änderungen zu speichern.

gcloud

Setzen Sie alle Flags in einer Instanz auf ihren Standardwert zurück:

gcloud sql instances patch [INSTANCE_NAME] --clear-database-flags

Sie werden aufgefordert, den Neustart der Instanz zu bestätigen.

REST

So löschen Sie alle Flags in einer vorhandenen Instanz:

Ersetzen Sie diese Werte in den folgenden Anweisungen:

  • project-id: die Projekt-ID
  • instance-id: die Instanz-ID

HTTP-Methode und URL:

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

Aktuelle Werte von Datenbank-Flags abrufen

Zum Abrufen aller aktuellen Werte der MySQL-Systemvariablen melden Sie sich mit dem mysql-Client bei Ihrer Instanz an und geben die folgende Anweisung ein:

 SHOW VARIABLES;

Sie können den Wert nur für unterstützte Flags ändern (wie unten aufgeführt).

Für eine Instanz festgelegte Datenbank-Flags ermitteln

So rufen Sie alle für eine Cloud SQL-Instanz festgelegten Flags auf:

Console

  1. Erstellen Sie in der Google Cloud Console ein neues Cloud Console-Projekt oder rufen Sie ein vorhandenes Projekt durch Auswahl des Projektnamens auf.
  2. Wählen Sie die Instanz aus, um die Seite Instanzübersicht zu öffnen.

    Die gesetzten Flags werden im Bereich Datenbank-Flags aufgelistet.

gcloud

Rufen Sie den Status der Instanz ab:

gcloud sql instances describe [INSTANCE_NAME]

In der Ausgabe werden Datenbank-Flags unter settings als databaseFlags-Sammlung aufgelistet. Weitere Informationen zur Darstellung der Flags in der Ausgabe finden Sie unter Darstellung von Instanzressourcen.

REST

So listen Sie Flags auf, die für eine Instanz konfiguriert sind:

Ersetzen Sie diese Werte in den folgenden Anweisungen:

  • project-id: die Projekt-ID
  • instance-id: die Instanz-ID

HTTP-Methode und URL:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

Suchen Sie in der Ausgabe nach dem Feld databaseFlags.

Unterstützte Flags

Cloud SQL unterstützt die Flags, die in MySQL am häufigsten verwendet werden.

Für bestimmte Flags unterstützt Cloud SQL eventuell einen anderen Wertebereich als der entsprechende MySQL-Parameter oder die entsprechende MySQL-Option.

Die Flags gelten für alle Versionen von MySQL, die von Cloud SQL unterstützt werden, sofern nichts anderes angemerkt ist.

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

Cloud SQL-Flag Typ
Gültige Werte und Hinweise
Neustart
erforderlich?
In der
Betaphase?
auto_increment_increment integer
1 ... 65535
Nein Nein
auto_increment_offset integer
1 ... 65535
Nein Nein
binlog_cache_size integer
4096 ... 9223372036854775807
Nein Ja
binlog_row_image enumeration
full (Standard), minimal oder noblob
Nein Nein
binlog_stmt_cache_size 4096 ... 9223372036854775807 Nein Ja
character_set_server string
utf8 oder utf8mb4 (empfohlen)
Ja Nein
default_time_zone string
Geben Sie Werte als Zeitzonenversätze von -12:59 bis +13:00 an. Führende Nullen sind erforderlich.

Beispiel: London liegt in der Zeitzone UTC, was in den unterstützten Werten für dieses Flag +00:00 bedeutet. Benannte Bereiche wie "Europa/London" werden von Cloud SQL nicht unterstützt.

Ja Nein
eq_range_index_dive_limit integer
0 ... 2147483647
Nein Nein
event_scheduler boolean
on | off

Konfigurieren Sie bei Verwendung des Event Schedulers die Instanz mithilfe einer Aktivierungsrichtlinie mit der Einstellung ALWAYS, damit geplante Ereignisse ausgeführt werden.

Nein Nein
explicit_defaults_for_timestamp boolean
on | off
Nein Nein
ft_max_word_len integer
10 ... 252
Ja Nein
ft_min_word_len integer
1 ... 16
Ja Nein
ft_query_expansion_limit integer
0 ... 1000
Ja Nein
general_log boolean
on | off

Im Abschnitt Tipps finden Sie weitere Informationen zu allgemeinen Logs.

Nein Nein
group_concat_max_len integer
4 ... 17179869184
Nein Nein
init_connect string Nein Ja
innodb_adaptive_hash_index boolean
on | off
Nein Ja
innodb_adaptive_hash_index_parts integer
1 ... 512
Ja Ja
innodb_adaptive_max_sleep_delay integer
0 ... 1000000
Nein Nein
innodb_autoinc_lock_mode integer
0 ... 2
Ja Nein
innodb_change_buffer_max_size integer
0 ... 50
Nein Ja
innodb_concurrency_tickets integer
1 ... 4294967295
Nein Nein
innodb_file_per_table boolean
on | off

Im Abschnitt Tipps finden Sie weitere Informationen zu diesem Flag.

Nein Nein
innodb_fill_factor integer
10 ... 100
Nein Nein
innodb_ft_cache_size integer
1600000 ... 80000000
Ja Ja
innodb_ft_enable_diag_print boolean
on | off
Nein Nein
innodb_ft_enable_stopword boolean
on | off
Nein Nein
innodb_ft_max_token_size integer
10 ... 252

Nur in MySQL 5.6 und höheren Versionen unterstützt.

Ja Nein
innodb_ft_min_token_size integer
0 ... 16

Nur in MySQL 5.6 und höheren Versionen unterstützt.

Ja Nein
innodb_ft_num_word_optimize integer
1000 ... 10000
Nein Nein
innodb_ft_result_cache_limit integer
1000000 ... 4294967295
Nein Ja
innodb_ft_server_stopword_table string

Nur in MySQL 5.6 und höheren Versionen unterstützt.

Nein Nein
innodb_ft_sort_pll_degree integer
1 ... 32
Ja Nein
innodb_ft_total_cache_size integer
32000000 ... 1600000000
Ja Ja
innodb_ft_user_stopword_table string Nein Nein
innodb_large_prefix boolean
on | off

Wird nur in MySQL 5.6 unterstützt.

Nein Nein
innodb_lock_wait_timeout integer
1 ... 1073741824
Nein Nein
innodb_log_buffer_size integer
262144 ... 4294967295
Ja Ja
innodb_log_file_size integer
MySQL 5.6: 1048576 ... 274877906944
MySQL 5.7: 4194304 ... 274877906944
Ja Ja
innodb_lru_scan_depth integer
100 ... 9223372036854775807
Nein Nein
innodb_old_blocks_pct integer
5 ... 95
Nein Nein
innodb_old_blocks_time integer
0 ... 4294967295
Nein Nein
innodb_online_alter_log_max_size integer
65536 ... 9223372036854775807
Nein Nein
innodb_optimize_fulltext_only boolean
on | off
Nein Nein
innodb_print_all_deadlocks boolean
on | off
Nein Nein
innodb_random_read_ahead boolean
on | off
Nein Nein
innodb_read_ahead_threshold integer
0 ... 64
Nein Nein
innodb_read_io_threads integer
1 ... 64
Ja Nein
innodb_replication_delay integer
0 ... 4294967295
Nein Ja
innodb_rollback_on_timeout boolean
on | off
Ja Nein
innodb_rollback_segments integer
1 ... 128
Nein Nein
innodb_sort_buffer_size integer
65536 ... 67108864
Ja Ja
innodb_stats_auto_recalc boolean
on | off
Nein Nein
innodb_stats_method enumeration
nulls_equal | nulls_unequal | nulls_ignored
Nein Nein
innodb_stats_on_metadata boolean
on | off
Nein Nein
innodb_stats_persistent boolean
on | off
Nein Nein
innodb_stats_persistent_sample_pages integer
1 ... 9223372036854775807
Nein Nein
innodb_stats_sample_pages integer
1 ... 9223372036854775807
Nein Nein
innodb_stats_transient_sample_pages integer
1 ... 9223372036854775807
Nein Nein
innodb_status_output boolean
on | off
Nein Nein
innodb_status_output_locks boolean
on | off
Nein Nein
innodb_strict_mode boolean
on | off
Nein Nein
innodb_thread_concurrency integer
0 ... 1000
Nein Nein
innodb_thread_sleep_delay integer
0 ... 1000000
Nein Nein
innodb_write_io_threads integer
1 ... 64
Ja Nein
interactive_timeout integer
1 ... 31536000
Nein Nein
join_buffer_size integer
128 ... 9223372036854775807
Nein Ja
local_infile boolean
on | off
Nein Nein
lock_wait_timeout integer
1 ... 31536000
Nein Nein
log_bin_trust_function_creators boolean
on | off
Nein Nein
log_output set
FILE | TABLE | NONE
Nein Nein
log_queries_not_using_indexes boolean
on | off
Nein Nein
log_throttle_queries_not_using_indexes integer
0 ... 9223372036854775807
Nein Nein
long_query_time float
0 ... 30000000

In Cloud SQL können Sie dieses Flag auf einen niedrigeren Wert als 1 setzen, wenn nötig.

Wenn das Flag log_queries_not_using_indexes ebenfalls aktiviert ist, sehen Sie möglicherweise Abfragen, die kürzer als die hier angegebene Zeit sind.

Nein Nein
lower_case_table_names integer
0 oder 1

In den meisten Fällen sollte der Standardwert 0 verwendet werden. Dadurch ist bei Tabellen- und Datenbanknamen die Groß-/Kleinschreibung zu beachten. Wenn Sie den Wert dieses Flags ändern müssen, sollten Sie sich darüber im Klaren sein, wie sich die Änderung auf Ihre vorhandenen Tabellen und Datenbanken auswirkt.

Ja Nein
max_allowed_packet integer
16384 ... 1073741824

Dieser Wert muss ein Vielfaches von 1.024 sein, wenn sql_mode=TRADITIONAL oder sql_mode=STRICT_ALL_TABLES ist.

Nein Nein
max_binlog_size integer
4096 ... 1073741824
Nein Ja
max_connections integer
25 ... 100000
Nein Ja
max_digest_length integer
0 ... 1048576
Ja Ja
max_execution_time integer
0 ... 9223372036854775807
Nein Nein
max_heap_table_size integer
16384 ... 67108864

Im Abschnitt Tipps finden Sie weitere Informationen zu diesem Flag.

Nein Nein
max_join_size integer
16 ... 9223372036854775807
Nein Nein
max_length_for_sort_data integer
4 ... 8388608
Nein Nein
max_points_in_geometry integer
3 ... 1048576
Nein Nein
max_prepared_stmt_count integer
0 ... 1048576
Nein Nein
max_seeks_for_key integer
1 ... 9223372036854775807
Nein Nein
max_sort_length integer
4 ... 8388608
Nein Ja
max_sp_recursion_depth integer
0 ... 255
Nein Ja
max_user_connections integer
0 ... 4294967295
Nein Ja
max_write_lock_count integer
1 ... 9223372036854775807
Nein Nein
net_read_timeout integer
30 ... 4294967295
Nein Nein
net_retry_count integer
10 ... 4294967295
Nein Nein
net_write_timeout integer
60 ... 4294967295
Nein Nein
optimizer_prune_level integer
0 ... 1
Nein Nein
optimizer_search_depth integer
0 ... 62
Nein Nein
optimizer_trace_max_mem_size integer
0 ... 9223372036854775807
Nein Ja
optimizer_trace_offset integer
-9223372036854775808 ... 9223372036854775807
Nein Nein
parser_max_mem_size integer
10000000 ... 9223372036854775807
Nein Ja
performance_schema boolean
on | off (Standardeinstellung)

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Nein
performance_schema_accounts_size integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_digests_size integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_events_stages_history_long_size integer
-1 ... 1048576
Ja Ja
performance_schema_events_stages_history_size integer
-1 ... 1024

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_events_statements_history_long_size integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_events_statements_history_size integer
-1 ... 1024

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_events_transactions_history_long_size integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_events_transactions_history_size integer
-1 ... 1024

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_events_waits_history_long_size integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_events_waits_history_size integer
-1 ... 1024

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_hosts_size integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_cond_classes integer
0 ... 256

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_cond_instances integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_digest_length integer
0 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_file_classes integer
0 ... 256

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_file_handles integer
0 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_file_instances integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_index_stat integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_memory_classes integer
0 ... 1024

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_metadata_locks integer
-1 ... 104857600

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_mutex_classes integer
0 ... 256

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_mutex_instances integer
-1 ... 104857600

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_präparierte_Statements_instanzen integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_program_instances integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_rwlock_classes integer
0 ... 256

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_rwlock_instances integer
-1 ... 104857600

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_socket_classes integer
0 ... 256

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_socket_instances integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_sql_text_length integer
0 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_stage_klassen integer
0 ... 256

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_statement_classes integer
0 ... 256

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_statement_stack integer
1 ... 256

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_table_handles integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_table_instances integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_table_lock_stat integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_thread_classes integer
0 ... 256

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_max_thread_instances integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_session_connect_attrs_size integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_setup_actors_size integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_setup_objects_size integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
performance_schema_users_size integer
-1 ... 1048576

Im Bereich Tipps finden Sie weitere Informationen zu performance_schema-Flags.

Ja Ja
query_alloc_block_size integer
1024 ... 4294967295
Nein Ja
query_cache_limit integer
0 ... 223338299392
Nein Nein
query_cache_min_res_unit integer
0 ... 9223372036854775807
Nein Ja
query_cache_size integer
0 ... 223338299392

Im Abschnitt Tipps finden Sie weitere Informationen zu diesem Flag.

Nein Nein
query_cache_type enumeration
0 ... 2

Im Abschnitt Tipps finden Sie weitere Informationen zu diesem Flag.

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

Hat keine Auswirkungen auf Replikate.

Nein Nein
read_rnd_buffer_size integer
1 ... 2147483647
Nein Ja
show_compatibility_56 boolean
on | off

Wird nur in MySQL 5.7 unterstützt.

Nein Nein
skip_show_database flag
on | off
Ja Nein
slow_query_log boolean
on | off

Im Abschnitt Tipps finden Sie weitere Informationen zu langsamen Abfragelogs.

Nein Nein
sort_buffer_size integer
32768 ... 9223372036854775807
Nein Ja
sql_mode string

Die zulässigen Werte und kombinierten Modi wie ANSI finden Sie in der MySQL-Dokumentation unter Server SQL-Modi. NO_DIR_IN_CREATE wird nicht unterstützt.

Ja Nein
stored_program_cache integer
16 ... 524288
Nein Ja
table_definition_cache integer
400 ... 524288
Nein Ja
table_open_cache integer
1 ... 524288
Nein Ja
table_open_cache_instances integer
1 ... 64
Ja Ja
thread_cache_size integer
0 ... 16384
Nein Ja
thread_stack integer
131072 ... 9223372036854775807
Ja Ja
tmp_table_size integer
1024 ... 67108864

Im Bereich Tipps finden Sie weitere Informationen zu diesem Flag.

Nein Nein
transaction_alloc_block_size integer
1024 ... 131072
Nein Ja
transaction_isolation enumeration
READ-UNCOMMITTED | READ-COMMITTED | REPEATABLE-READ | SERIALIZABLE
Ja Ja
transaction_prealloc_size integer
1024 ... 131072
Nein Ja
updatable_views_with_limit integer
0 ... 1
Nein Nein
wait_timeout integer
1 ... 31536000
Nein Nein

Tipps für die Arbeit mit Flags

general_log, slow_query_log

Wenn Sie die general- oder slow query-Logs anzeigen lassen möchten, aktivieren Sie das entsprechende Flag und setzen das Flag log_output auf FILE. Dadurch wird die Logausgabe über die Loganzeige in der Google Cloud Console verfügbar. Beachten Sie, dass Logging-Gebühren für die Operations-Suite von Google Cloud anfallen. Um die Speicherkosten für Instanzen zu minimieren, werden die Logs general und slow query auf dem Instanzlaufwerk rotiert, wenn die Logdatei älter als 24 Stunden oder größer als 100 MB ist. Nach der Rotation werden alte Logdateien automatisch gelöscht.

Wenn für log_output der Wert NONE festgelegt ist, können Sie nicht auf die Logs zugreifen. Wenn Sie für log_output den Wert TABLE angeben, wird die Logausgabe in einer Tabelle in Ihrer Datenbank abgelegt. Eine sehr große Tabelle kann sich auf die Zeitdauer auswirken, die für einen Neustart der Instanz benötigt wird, bzw. dazu führen, dass die Instanz nicht mehr vom SLA abgedeckt ist. Darum wird die Option TABLE nicht empfohlen. Bei Bedarf können Sie Ihre Logtabellen mithilfe der API kürzen. Weitere Informationen finden Sie auf der Referenzseite zu instances.truncateLog.

innodb_file_per_table

Bei allen MySQL-Versionen 5.6 und höher ist der Standardwert ON.

max_heap_table_size, tmp_table_size

Eine Überlastung des verfügbaren Instanzarbeitsspeichers kann dann auftreten, wenn Sie für tmp_table_size und max_heap_table_size einen zu hohen Wert für die Anzahl an gleichzeitigen Abfragen festgelegt haben und die Instanz diese nicht mehr verarbeiten kann. Eine Überlastung des Arbeitsspeichers hat einen Absturz und Neustart der Instanz zur Folge.

Einige der möglichen Werte für diese Flags können dazu führen, dass Ihre Instanz nicht mehr vom SLA abgedeckt ist. Weitere Informationen Weitere Informationen zur Verwendung dieser Flags finden Sie unter Verwendung interner temporärer Tabellen in MySQL und MEMORY Storage Engine.

performance_schema*

Der Wert dieses Flags wird mit der API geändert. Das Flag kann auf Instanzen einer niedrigeren Stufe als db-n1-standard-8 oder db-n1-highmem-4 nicht aktiviert werden. Wenn dieses Flag aktiviert ist, lässt sich keine Stufe festlegen, die dieses Flag nicht unterstützt. Dazu müssen Sie dieses Flag deaktivieren.

query_cache_size, query_cache_type

Einige der möglichen Werte für diese Flags können dazu führen, dass Ihre Instanz nicht mehr vom SLA abgedeckt ist. Weitere Informationen

Von Cloud SQL verwaltete Flags

Cloud SQL passt bestimmte System-Flags abhängig von der Instanzstufe an. Sie können diese Werte nicht anpassen.

Cloud SQL-Flag Werte und Hinweise
innodb_buffer_pool_instances Weitere Informationen zu diesem Flag finden Sie unten im Abschnitt zu Pufferpoolinstanzen.
innodb_buffer_pool_size Weitere Informationen zu diesem Flag finden Sie unten im Abschnitt zur Pufferpoolgröße unten.
innodb_buffer_pool_instances
  • 1 für f1-micro, g1-small und n1-standard-1.
  • 2 für n1-standard-2.
  • 4 für n1-standard-4 und n1-highmem-2.
  • 8 für alle anderen Stufen.

innodb_buffer_pool_size

Ungefähre Größen.

  • ~ 1,5 GB für f1-micro, g1-small und n1-standard-1.
  • ~ 4 GB für n1-standard-2.
  • ~ 11 GB für n1-standard-4.
  • ~ 22 GB für n1-standard-8.
  • ~ 46 GB für n1-standard-16.
  • ~ 92 GB für n1-standard-32.
  • ~ 186 GB für n1-standard-64.
  • ~ 10 GB für n1-highmem-2.
  • ~ 20 GB für n1-highmem-4.
  • ~ 40 GB für n1-highmem-8.
  • ~ 80 GB für n1-highmem-16.
  • ~ 160 GB für n1-highmem-32.
  • ~ 320 GB für n1-highmem-64.

Fehlerbehebung

Klicken Sie auf die Links in der Tabelle, um weitere Informationen zu erhalten:

Problem Mögliche Ursache Lösungsvorschlag
Daten mit dem Zeichensatz utf8mb4. Dieser Zeichensatz wird nicht unterstützt. Filtern Sie utf8mb4-Strings aus Ihren Daten.
Instanz stürzt ab, wenn ein Flag aktiviert wird. Der Wert des Flags max_connections ist möglicherweise zu hoch. Wenden Sie sich an den Kundensupport, um die Entfernung eines Flags anzufordern.
Das Flag performance_schema kann nicht hinzugefügt werden. Die Instanzgröße ist zu klein. Aktualisieren Sie auf eine größere Instanz.
Die Zeitzone wird nicht automatisch geändert. Die automatische Änderung der Zeitzone wird nicht unterstützt. Die Zeit muss manuell geändert werden. Mehr erfahren
Bad syntax for dict arg. Komplexe Parameterwerte erfordern eine besondere Behandlung. Mehr erfahren

Daten mit dem Zeichensatz utf8mb4

Der Import von Daten mit dem Zeichensatz utf8mb4 ist fehlgeschlagen.

Mögliche Ursache

Der Zeichensatz utf8mb4 wird nicht unterstützt, auch wenn dies bisher in der Dokumentation angegeben wurde.

Lösungsvorschlag

Filtern Sie utf8mb4-Strings aus Ihren Daten.


Instanz stürzt ab, wenn ein Flag aktiviert wird

Nach dem Aktivieren eines Flags wechseln die Instanzen zwischen einer Panik und einem Absturz.

Mögliche Ursache

Dieser Fehler tritt auf, wenn Sie den Wert des Flags max_connections zu hoch festlegen.

Lösungsvorschlag

Wenden Sie sich an den Kundensupport, um ein Entfernen des Flags mit anschließendem hard drain anzufordern. Dadurch wird die Instanz auf einem anderen Host mit einer neuen Konfiguration und ohne das Flag bzw. ohne die Einstellung neu gestartet.


Das Flag "performance_schema" kann nicht hinzugefügt werden

Sie können das Flag performance_schema nicht hinzufügen, da es nicht im Drop-down-Menü der unterstützten Flags enthalten ist.

Mögliche Ursache

Das performance_schema und seine Varianten (performance_schema_accounts_size, performance_schema_accounts_size usw.) können nicht auf Instanzen aktiviert werden, die kleiner als db-n1-standard-8 oder db-n1-highmem-4 sind.

Lösungsvorschlag

Bearbeiten Sie die Instanz und erhöhen Sie deren Größe, wenn Sie dieses Flag verwenden müssen.


Die Zeitzone wird nicht automatisch geändert

Die Zeitzone für die Sommerzeit wurde nicht automatisch geändert.

Mögliche Ursache

Automatisierte Zeitzonenänderungen werden in Cloud SQL nicht unterstützt. Änderungen der Zeitzone müssen manuell vorgenommen werden, und zwar nicht per String, sondern per Zeitzonen-Offset-Wert.

Lösungsvorschlag

Bearbeiten Sie die Instanz und ändern Sie das Flag default_time_zone. Benannte Bereiche werden nicht unterstützt. Beispiel: Europe/London London liegt in der UTC-Zeitzone. Der unterstützte Wert für das Flag default_time_zone ist dann +00:00.


Falsche Syntax für dict arg

Beim Festlegen eines Flags wird die Fehlermeldung Bad syntax for dict arg angezeigt.

Mögliche Ursache

Komplexe Parameterwerte wie durch Kommas getrennte Listen erfordern eine besondere Behandlung, wenn sie mit gcloud-Befehlen verwendet werden.

Lösungsvorschlag

Verwenden Sie den gcloud-Parameter --flags-file, der eine YAML- oder JSON-Datei mit einem --flag:value-Wörterbuch angibt, das für komplexe Flag-Werte nützlich ist.

Weitere Informationen