配置数据库标志

本页面介绍如何为 Cloud SQL 配置数据库标志，并列出了可以为实例设置的标志。您可以将数据库标志用于许多操作，包括调整 MySQL 参数、调整选项以及配置和优化实例。

在某些情况下，设置一个标志时，可能需要设置另一个标志才能完全启用所需功能。例如，如需启用慢查询日志记录，您必须将 slow_query_log 标志设置为 on 并将 log_output 标志设置为 FILE，才能使用 Google Cloud Console 日志查看器来阅读日志。

当您设置、移除或修改数据库实例的标志时，该数据库可能会重启。除非您主动移除，否则实例的此标志值会一直保留。如果实例是副本的来源，则副本也会重启以与实例的当前配置保持一致。

配置数据库标志

设置数据库标志

控制台

  1. 在 Google Cloud Console 中，创建新的 Cloud Console 项目，或者选择项目名称以打开现有项目。
  2. 打开实例，然后点击修改。
  3. 向下滚动至标志部分。
  4. 要在实例上设置先前未设置的标志，请点击添加一项，从下拉菜单中选择该标志，然后设置其值。
  5. 点击保存以保存更改。
  6. 在“概览”页的标志下确认更改。

gcloud

修改实例：

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

此命令将覆盖之前设置的所有数据库标志。如需保留这些标志并添加新标志，请为您要在实例上设置的所有标志添加值；任何未明确添加的标志都会设置为默认值。对于不带值的标志，请指定标志名称并后接一个等号（“=”）。

例如，如需设置 general_log、skip_show_database 和 wait_timeout 标志，您可以使用以下命令：

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

REST v1beta4

设置现有数据库的标志：

在使用下面的任何请求数据之前，请先进行以下替换：

  • project-id：项目 ID
  • instance-id：实例 ID

HTTP 方法和网址：

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

请求 JSON 正文： 

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

如需发送您的请求，请展开以下选项之一：

您应该会收到类似以下内容的 JSON 响应：

例如，如需为现有数据库设置 general_log 标志，请按如下所示操作：

在使用下面的任何请求数据之前，请先进行以下替换：

  • project-id：项目 ID
  • instance-id：实例 ID

HTTP 方法和网址：

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

请求 JSON 正文： 

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

如需发送您的请求，请展开以下选项之一：

您应该会收到类似以下内容的 JSON 响应：

如果数据库存在已配置的现有标志，请修改先前的命令，将其包含在内。PATCH 命令会使用请求中指定的标志覆盖现有标志。

将所有标志恢复为其默认值

控制台

  1. 在 Google Cloud Console 中，创建新的 Cloud Console 项目，或者选择项目名称以打开现有项目。
  2. 打开实例，然后点击修改。
  3. 打开数据库标志部分。
  4. 点击显示的所有标志旁的 X。
  5. 点击保存以保存更改。

gcloud

将实例上的所有标志恢复为其默认值：

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

系统会提示您确认实例将重启。

REST v1beta4

清除现有实例的所有标志：

在使用下面的任何请求数据之前，请先进行以下替换：

  • project-id：项目 ID
  • instance-id：实例 ID

HTTP 方法和网址：

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

请求 JSON 正文： 

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

如需发送您的请求，请展开以下选项之一：

您应该会收到类似以下内容的 JSON 响应：

查看数据库标志的当前值

如需查看 MySQL 系统变量的所有当前值，请使用 mysql 客户端登录到您的实例，然后输入以下语句：

 SHOW VARIABLES;

请注意，您只能更改受支持标志的值（如下所列）。

确定已为实例设置的数据库标志

查看已为 Cloud SQL 实例设置的标志：

控制台

  1. 在 Google Cloud Console 中，创建新的 Cloud Console 项目，或者选择项目名称以打开现有项目。
  2. 选择实例，打开其实例概览页面。

    数据库标志部分列出了已设置的数据库标志。

gcloud

获取实例状态：

gcloud sql instances describe [INSTANCE_NAME]

在输出中，数据库标志作为 databaseFlags 集合列在 settings 下。如需详细了解输出中标志的表示法，请参阅实例资源表示法。

REST v1beta4

列出实例的已配置标志：

在使用下面的任何请求数据之前，请先进行以下替换：

  • project-id：项目 ID
  • instance-id：实例 ID

HTTP 方法和网址：

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

如需发送您的请求，请展开以下选项之一：

您应该收到类似以下内容的 JSON 响应：

在输出中，查找 databaseFlags 字段。

支持的标志

Cloud SQL 中支持的标志是请求最频繁的 MySQL 标志。

对于给定标志，Cloud SQL 支持的范围可能与对应的 MySQL 参数或选项有所不同。

除非另有说明，否则标志适用于 Cloud SQL 支持的所有 MySQL 版本。

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

Cloud SQL 标志 类型
可接受值及备注		 是否需要
重启？		 是否
为 Beta 版？
activate_all_roles_on_login boolean
on | off
默认值：off
否 否
auto_increment_increment integer
1 至 65535		 否 否
auto_increment_offset integer
1 至 65535		 否 否
binlog_cache_size integer
4096 至 9223372036854775807		 否 否
binlog_row_image enumeration
full（默认）、minimal 或 noblob		 否 否
binlog_stmt_cache_size 4096 至 9223372036854775807 否 否
character_set_server string
utf8 或 utf8mb4（推荐）		 是 否
default_password_lifetime integer 0...65535
默认值：0
否 否
default_time_zone string
将值指定为时区偏移量，范围为 -12:59 到 +13:00。必须添加前导零。

例如，伦敦采用世界协调时间 (UTC) 时区，因此此标志支持的值为 +00:00。Cloud SQL 不支持已命名的区域，例如“欧洲/伦敦”。

 是 否
disconnect_on_expired_password boolean on | off
默认值：on
是 否
eq_range_index_dive_limit integer
0 至 2147483647		 否 否
event_scheduler boolean
on | off

如果您使用的是 Event Scheduler，请将实例的激活政策配置为 ALWAYS，以确保预定事件正常运行。

 否 否
explicit_defaults_for_timestamp boolean
on | off		 否 否
ft_max_word_len integer
10 至 252		 是 否
ft_min_word_len integer
1 至 16		 是 否
ft_query_expansion_limit integer
0 至 1000		 是 否
general_log boolean
on | off

如需详细了解常规日志，请参阅提示部分。

 否 否
generated_random_password_length integer 5-255
默认值：20
否 否
group_concat_max_len integer
4 至 17179869184		 否 否
init_connect string 否 否
innodb_adaptive_hash_index boolean
on | off		 否 否
innodb_adaptive_hash_index_parts integer
1 至 512		 是 否
innodb_adaptive_max_sleep_delay integer
0 至 1000000		 否 否
innodb_autoinc_lock_mode integer
0 至 2		 是 否
innodb_change_buffer_max_size integer
0 至 50		 否 否
innodb_concurrency_tickets integer
1 至 4294967295		 否 否
innodb_file_per_table boolean
on | off

如需详细了解此标志，请参阅提示部分。

 否 否
innodb_fill_factor integer
10 至 100		 否 否
innodb_ft_cache_size integer
1600000 至 80000000		 是 否
innodb_ft_enable_diag_print boolean
on | off		 否 否
innodb_ft_enable_stopword boolean
on | off		 否 否
innodb_ft_max_token_size integer
10 至 252

仅受 MySQL 5.6 及更高版本支持。

 是 否
innodb_ft_min_token_size integer
0 至 16

仅受 MySQL 5.6 及更高版本支持。

 是 否
innodb_ft_num_word_optimize integer
1000 至 10000		 否 否
innodb_ft_result_cache_limit integer
1000000 至 4294967295		 否 否
innodb_ft_server_stopword_table string

仅受 MySQL 5.6 及更高版本支持。

 否 否
innodb_ft_sort_pll_degree integer
1 至 32		 是 否
innodb_ft_total_cache_size integer
32000000 至 1600000000		 是 否
innodb_ft_user_stopword_table string 否 否
innodb_large_prefix boolean
on | off

仅受 MySQL 5.6 支持。

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

如果需要，Cloud SQL 可为此标志设置一个小于 1 的值。

如果还启用了 log_queries_not_using_indexes 标志，您可能会看到查询的时间少于此处指定的时间。

 否 否
lower_case_table_names integer
0 或 1

大多数情况下，使用默认值 0，这会使表和数据库的名称区分大小写。如果需要更改此标志的值，请确保您了解此更改对现有表和数据库产生的影响。MySQL 8 for Cloud SQL 不支持此标志。

 是 否
mandatory_roles string role name
默认值：empty string
否 否
max_allowed_packet integer
16384 至 1073741824

如果 sql_mode=TRADITIONAL 或 sql_mode=STRICT_ALL_TABLES，则此值必须为 1024 的倍数。

 否 否
max_binlog_size integer
4096 至 1073741824		 否 否
max_connections integer
25 至 100000		 否 否
max_digest_length integer
0 至 1048576		 是 否
max_execution_time integer
0 至 9223372036854775807		 否 否
max_heap_table_size integer
16384 至 67108864

如需详细了解此标志，请参阅提示部分。

 否 否
max_join_size integer
16 至 9223372036854775807		 否 否
max_length_for_sort_data integer
4 至 8388608		 否 否
max_points_in_geometry integer
3 至 1048576		 否 否
max_prepared_stmt_count integer
0 至 1048576		 否 否
max_seeks_for_key integer
1 至 9223372036854775807		 否 否
max_sort_length integer
4 至 8388608		 否 否
max_sp_recursion_depth integer
0 至 255		 否 否
max_user_connections integer
0 至 4294967295		 否 否
max_write_lock_count integer
1 至 9223372036854775807		 否 否
net_read_timeout integer
30 至 4294967295		 否 否
net_retry_count integer
10 至 4294967295		 否 否
net_write_timeout integer
60 至 4294967295		 否 否
optimizer_prune_level integer
0 至 1		 否 否
optimizer_search_depth integer
0 至 62		 否 否
optimizer_trace_max_mem_size integer
0 至 9223372036854775807		 否 否
optimizer_trace_offset integer
-9223372036854775808 至 9223372036854775807		 否 否
parser_max_mem_size integer
10000000 至 9223372036854775807		 否 否
password_history integer 0-4294967295
默认值：0
否 否
password_require_current boolean on | off
默认值：off
否 否
password_reuse_interval integer 0-4294967295
默认值：0
否 否
performance_schema boolean
on | off（默认）

如需详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_accounts_size integer
-1 至 1048576

如需详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_digests_size integer
-1 至 1048576

如需详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_events_stages_history_long_size integer
-1 至 1048576		 是 否
performance_schema_events_stages_history_size integer
-1 至 1024

如需详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_events_statements_history_long_size integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_events_statements_history_size integer
-1 至 1024

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_events_transactions_history_long_size integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_events_transactions_history_size integer
-1 至 1024

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_events_waits_history_long_size integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_events_waits_history_size integer
-1 至 1024

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_hosts_size integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_cond_classes integer
0 至 256

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_cond_instances integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_digest_length integer
0 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_file_classes integer
0 至 256

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_file_handles integer
0 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_file_instances integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_index_stat integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_memory_classes integer
0 ... 1024

如需详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_metadata_locks integer
-1 至 104857600

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_mutex_classes integer
0 至 256

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_mutex_instances integer
-1 至 104857600

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_prepared_statements_instances integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_program_instances integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_rwlock_classes integer
0 至 256

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_rwlock_instances integer
-1 至 104857600

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_socket_classes integer
0 至 256

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_socket_instances integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_sql_text_length integer
0 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_stage_classes integer
0 至 256

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_statement_classes integer
0 至 256

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_statement_stack integer
1 至 256

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_table_handles integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_table_instances integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_table_lock_stat integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_thread_classes integer
0 至 256

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_max_thread_instances integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_session_connect_attrs_size integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_setup_actors_size integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_setup_objects_size integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
performance_schema_users_size integer
-1 至 1048576

要详细了解 performance_schema 标志，请参阅提示部分。

 是 否
query_alloc_block_size integer
1024 至 4294967295		 否 否
query_cache_limit integer
0 至 223338299392		 否 否
query_cache_min_res_unit integer
0 至 9223372036854775807		 否 否
query_cache_size integer
0 至 223338299392

如需详细了解此标志，请参阅提示部分。

 否 否
query_cache_type enumeration
0 至 2

如需详细了解此标志，请参阅提示部分。

 是 否
query_cache_wlock_invalidate boolean
on | off		 否 否
query_prealloc_size integer
8192 至 9223372036854775807		 否 否
range_alloc_block_size integer
4096 至 4294967295		 否 否
range_optimizer_max_mem_size integer
0 至 9223372036854775807		 否 否
read_buffer_size integer
8192 至 2147483647		 否 否
read_only boolean
on | off

此标志不会影响副本。

 否 否
read_rnd_buffer_size integer
1 至 2147483647		 否 否
show_compatibility_56 boolean
on | off

仅受 MySQL 5.7 支持。

 否 否
skip_show_database flag
on | off		 是 否
slow_query_log integer
0 | 1

如需详细了解慢查询日志，请参阅提示部分。

 否 否
sort_buffer_size integer
32768 至 9223372036854775807		 否 否
sql_mode string

如需了解允许的值（包括 ANSI 等组合模式），请参阅 MySQL 文档中的 Server SQL 模式。不支持 NO_DIR_IN_CREATE。

 否 否
stored_program_cache integer
16 至 524288		 否 否
sync_binlog integer
0 ... 4294967295

仅受 MySQL 5.7 和 8.0 支持，而且仅在副本实例上。如果提升使用此标志的副本，则此标志会被移除。在独立主实例上不受支持。

  • 0 = 禁止将二进制日志同步到磁盘。
  • 1（默认）= 允许在提交事务之前将二进制日志同步到磁盘。这是最安全的设置，但因为磁盘写入次数增多，会对性能造成负面影响。
  • N = 其中 N 是 0 或 1 以外的值：收集了 N 个二进制日志提交组后，二进制日志会同步到磁盘。由于磁盘写入次数增加，此设置可能会对性能产生不利影响。值越高，性能就越高，但数据丢失的风险也会降低。
 否 否
table_definition_cache integer
400 至 524288		 否 否
table_open_cache integer
1 至 524288		 否 否
table_open_cache_instances integer
1 至 64		 是 否
thread_cache_size integer
0 至 16384		 否 否
thread_stack integer
131072 至 9223372036854775807		 是 否
tmp_table_size integer
1024 至 67108864

要详细了解此标志，请参阅提示部分。

 否 否
transaction_alloc_block_size integer
1024 至 131072		 否 否
transaction_isolation enumeration
READ-UNCOMMITTED | READ-COMMITTED | REPEATABLE-READ | SERIALIZABLE		 是 否
transaction_prealloc_size integer
1024 至 131072		 否 否
updatable_views_with_limit integer
0 至 1		 否 否
wait_timeout integer
1 至 31536000		 否 否

有关使用标志的提示

general_log、slow_query_log

要使您的 general 或 slow query 日志可供使用，请启用相应的标志并将 log_output 标志设置为 FILE。 这样您便可以使用 Google Cloud Console 中的日志查看器阅读日志输出内容。 请注意，您需要支付 Google Cloud 的运维套件日志记录费用。为了最大限度地降低实例存储费用，如果日志文件的大小超过 24 小时或大于 100MB，则实例磁盘上的 general 和 slow query 日志会被轮替，并且在轮替后会自动删除旧的日志文件。

如果 log_output 设置为 NONE，则您将无法访问日志。如果将 log_output 设置为 TABLE，则日志输出将被放入数据库的一个表中。如果此表扩大，则可能会影响实例重启时间，或者导致实例脱离其服务等级协议 (SLA) 覆盖范围；因此，建议不要使用 TABLE 选项。如果需要，您可以使用 API 截断日志表。如需了解详情，请参阅 instances.truncateLog 参考页面。

innodb_file_per_table

对于所有 MySQL 5.6 版及更高版本，默认值为 ON。

max_heap_table_size、tmp_table_size

如果 tmp_table_size 和 max_heap_table_size 的值对于实例处理的并发查询数来说设置得过高，可能会耗尽可用的实例内存。内存耗尽会导致实例崩溃和重启。

这些标志的某些值可能导致您的实例不再受 SLA 保障。 了解详情。 如需详细了解如何使用这些标志，请参阅 MySQL 如何使用内部临时表和 MEMORY 存储引擎。

performance_schema*

必须使用 API 更改此标志的值。不可在层级大小小于 db-n1-standard-8 或 db-n1-highmem-4 的实例上启用该标志。如果启用此标志，则无法将层更改为不支持该标志的大小；必须首先停用该标志。

query_cache_size、query_cache_type

这些标志的某些值可能导致您的实例不再受 SLA 保障。 了解详情。

由 Cloud SQL 管理的标志

Cloud SQL 会根据实例层级调整某些系统标志。您无法调整这些值。

Cloud SQL 标志 值及备注
innodb_buffer_pool_instances 如需详细了解此标志，请参阅下文的缓冲池实例部分。
innodb_buffer_pool_size 如需详细了解此标志，请参阅下文的缓冲池大小部分。
innodb_buffer_pool_instances
  • 对于 f1-micro、g1-small 和 n1-standard-1，此标志的值为 1。
  • 对于 n1-standard-2，此标志的值为 2。
  • 对于 n1-standard-4 和 n1-highmem-2，此标志的值为 4。
  • 对于其他所有层级，此标志的值为 8。

innodb_buffer_pool_size

此标志表示近似大小。

  • 对于 f1-micro、g1-small 和 n1-standard-1，此标志的值约为 1.5 GB。
  • 对于 n1-standard-2，此标志的值约为 4 GB。
  • 对于 n1-standard-4，此标志的值约为 11 GB。
  • 对于 n1-standard-8，此标志的值约为 22 GB。
  • 对于 n1-standard-16，此标志的值约为 46 GB。
  • 对于 n1-standard-32，此标志的值约为 92 GB。
  • 对于 n1-standard-64，此标志的值约为 186 GB。
  • 对于 n1-highmem-2，此标志的值约为 10 GB。
  • 对于 n1-highmem-4，此标志的值约为 20 GB。
  • 对于 n1-highmem-8，此标志的值约为 40 GB。
  • 对于 n1-highmem-16，此标志的值约为 80 GB。
  • 对于 n1-highmem-32，此标志的值约为 160 GB。
  • 对于 n1-highmem-64，此标志的值约为 320 GB。

问题排查

点击表中的链接可查看详细信息：

针对此问题… 可能的原因… 请尝试以下操作…
包含字符集 utf8mb4 的数据。 此字符集不受支持。 从数据中过滤掉 utf8mb4 字符串。
启用标志使实例崩溃。 max_connections 标志值可能设置得过高。 与客户服务联系，请求移除标志。
无法添加 performance_schema 标志。 实例大小太小。 更新为更大的实例。
时区不会自动更改。 不支持自动更改时区。 必须手动更改时间。了解详情。
Bad syntax for dict arg。 复杂的参数值需要特殊处理。 了解详情。

包含字符集 utf8mb4 的数据

无法导入包含字符集 utf8mb4 的数据。

可能的原因

字符集 utf8mb4 不受支持（即使文档之前表明支持该字符集）。

可以尝试的操作

从数据中过滤掉 utf8mb4 字符串。

启用标志使实例崩溃

启用标志后，实例会在错误和崩溃之间循环。

可能的原因

如果 max_connections 标志值设置得过高，则会导致此错误。

可以尝试的操作

请与客户服务联系，请求移除标志，然后执行 hard drain。这会强制实例在使用新配置（没有不需要的标志或设置）的其他主机上重启。

无法添加 performance_schema 标志

您无法添加 performance_schema 标志，因为该标志不在受支持标志的下拉菜单中。

可能的原因

无法在小于 db-n1-standard-8 或 db-n1-highmem-4 的实例上启用 performance_schema 及其变体（performance_schema_accounts_size、performance_schema_accounts_size 等）。

可以尝试的操作

如果需要使用此标志，请修改实例以升级到更大的大小。

时区不会自动更改

时区未根据夏令时自动更改。

可能的原因

Cloud SQL 不支持自动更改时区，必须手动更改，并且要按时区偏移值（而不是按字符串）进行更改。

可以尝试的操作

修改实例以更改 default_time_zone 标志。已命名的区域不受支持。例如：Europe/London 采用 UTC 时区，这是 default_time_zone 标志支持的值 +00:00。

dict 参数语法错误

尝试设置标志时，您看到错误消息 Bad syntax for dict arg。

可能的原因

与 gcloud 命令搭配使用时，复杂的参数值（例如以英文逗号分隔的列表）需要特殊处理。

可以尝试的操作

使用 gcloud --flags-file 参数，该参数指定的 YAML 或 JSON 文件包含适用于复杂标志值的 --flag:value 字典。

后续步骤