性能模式系统变量
性能架构实现了几个提供配置信息的系统变量：
mysql>SHOW VARIABLES LIKE 'perf%'; +---------------------------------------------------------- +------- + | Variable_name | Value | +---------------------------------------------------------- +------- + | performance_schema | ON | | performance_schema_accounts_size |-1 | | performance_schema_digests_size | 10000 | | performance_schema_events_stages_history_long_size | 10000 | | performance_schema_events_stages_history_size | 10 | | performance_schema_events_statements_history_long_size | 10000 | | performance_schema_events_statements_history_size | 10 | | performance_schema_events_transactions_history_long_size | 10000 | | performance_schema_events_transactions_history_size | 10 | | performance_schema_events_waits_history_long_size | 10000 | | performance_schema_events_waits_history_size | 10 | | performance_schema_hosts_size |-1 | | performance_schema_max_cond_classes | 80 | | performance_schema_max_cond_instances |-1 | | performance_schema_max_digest_length | 1024 | | performance_schema_max_file_classes | 50 | | performance_schema_max_file_handles | 32768 | | performance_schema_max_file_instances |-1 | | performance_schema_max_index_stat |-1 | | performance_schema_max_memory_classes | 320 | | performance_schema_max_metadata_locks |-1 | | performance_schema_max_mutex_classes | 220 | | performance_schema_max_mutex_instances |-1 | | performance_schema_max_prepared_statements_instances |-1 | | performance_schema_max_program_instances |-1 | | performance_schema_max_rwlock_classes | 40 | | performance_schema_max_rwlock_instances |-1 | | performance_schema_max_socket_classes | 10 | | performance_schema_max_socket_instances |-1 | | performance_schema_max_sql_text_length | 1024 | | performance_schema_max_stage_classes | 150 | | performance_schema_max_statement_classes | 192 | | performance_schema_max_statement_stack | 10 | | performance_schema_max_table_handles |-1 | | performance_schema_max_table_instances |-1 | | performance_schema_max_table_lock_stat |-1 | | performance_schema_max_thread_classes | 50 | | performance_schema_max_thread_instances |-1 | | performance_schema_session_connect_attrs_size | 512 | | performance_schema_setup_actors_size |-1 | | performance_schema_setup_objects_size |-1 | | performance_schema_users_size |-1 | +---------------------------------------------------------- +------- +
可以在服务器启动时在命令行或选项文件中设置Performance Schema系统变量，并且可以在运行时设置许多变量。请参见“性能模式选项和变量参考”。
如果未明确设置性能模式，则在服务器启动时，性能模式会自动调整其几个参数的值。有关更多信息，请参见“性能架构启动配置”。
Performance Schema系统变量具有以下含义：
performance_schema属性 值 命令行格式 --performance-schema[={OFF|ON}] 系统变量 performance_schema 范围 Global 动态 没有 SET_VAR提示适用没有 类型 布尔型 默认值 ON 该变量的值是
ON或OFF指示是否启用了性能模式。默认情况下，值为ON。在服务器启动时，您可以指定此变量，不带任何值或值为ON或1来启用它，或指定为OFF或0 值以禁用它。即使在性能模式被禁用，则继续填充
global_variables，session_variables，global_status，和session_status表格。这是必要的，以便允许从这些表中提取SHOW VARIABLES和SHOW STATUS语句的结果。当禁用时，性能架构也会填充一些复制表。performance_schema_accounts_size属性 值 命令行格式 --performance-schema-accounts-size=# 系统变量 performance_schema_accounts_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）最低值 -1（表示自动缩放；请勿分配此文字值）最大值 1048576 accounts表中的行数。如果此变量为0，则性能架构将不维护accounts表中的连接统计信息或表中的状态变量信息status_by_account。performance_schema_digests_size属性 值 命令行格式 --performance-schema-digests-size=# 系统变量 performance_schema_digests_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动调整大小；不分配此文字值）最低值 -1 最大值 1048576 表中的最大行数
events_statements_summary_by_digest。如果超过了该最大值，则无法检测到摘要，则性能架构将增加Performance_schema_digest_lost状态变量。有关语句摘要的更多信息，请参见“性能模式语句摘要和采样”。
performance_schema_error_size属性 值 命令行格式 --performance-schema-error-size=# 系统变量 performance_schema_error_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 number of server error codes 最低值 0 最大值 1048576 检测到的服务器错误代码的数量。默认值为服务器错误代码的实际数量。尽管该值可以设置为从0到最大值之间的任意值，但预期的用途是将其设置为默认值（以检测所有错误）或0（以检测无错误）。
错误信息汇总在摘要表中；请参见“错误摘要表”。如果发生了未检测到的错误，则有关该错误的信息将汇总到
NULL每个摘要表中的行；也就是说，该行有ERROR_NUMBER=0，ERROR_NAME=NULL和SQLSTATE=NULL。performance_schema_events_stages_history_long_size属性 值 命令行格式 --performance-schema-events-stages-history-long-size=# 系统变量 performance_schema_events_stages_history_long_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动调整大小；不分配此文字值）events_stages_history_long表中的行数。performance_schema_events_stages_history_size属性 值 命令行格式 --performance-schema-events-stages-history-size=# 系统变量 performance_schema_events_stages_history_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动调整大小；不分配此文字值）events_stages_history表中每个线程的行数。performance_schema_events_statements_history_long_size属性 值 命令行格式 --performance-schema-events-statements-history-long-size=# 系统变量 performance_schema_events_statements_history_long_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动调整大小；不分配此文字值）events_statements_history_long表中的行数。performance_schema_events_statements_history_size属性 值 命令行格式 --performance-schema-events-statements-history-size=# 系统变量 performance_schema_events_statements_history_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动调整大小；不分配此文字值）events_statements_history表中每个线程的行数。performance_schema_events_transactions_history_long_size属性 值 命令行格式 --performance-schema-events-transactions-history-long-size=# 系统变量 performance_schema_events_transactions_history_long_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动调整大小；不分配此文字值）events_transactions_history_long表中的行数。performance_schema_events_transactions_history_size属性 值 命令行格式 --performance-schema-events-transactions-history-size=# 系统变量 performance_schema_events_transactions_history_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动调整大小；不分配此文字值）events_transactions_history表中每个线程的行数。performance_schema_events_waits_history_long_size属性 值 命令行格式 --performance-schema-events-waits-history-long-size=# 系统变量 performance_schema_events_waits_history_long_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动调整大小；不分配此文字值）events_waits_history_long表中的行数。performance_schema_events_waits_history_size属性 值 命令行格式 --performance-schema-events-waits-history-size=# 系统变量 performance_schema_events_waits_history_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动调整大小；不分配此文字值）events_waits_history表中每个线程的行数。performance_schema_hosts_size属性 值 命令行格式 --performance-schema-hosts-size=# 系统变量 performance_schema_hosts_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）最低值 -1（表示自动缩放；请勿分配此文字值）最大值 1048576 hosts表中的行数。如果此变量为0，则性能架构将不维护hosts表中的连接统计信息或表中的状态变量信息status_by_host。performance_schema_max_cond_classes属性 值 命令行格式 --performance-schema-max-cond-classes=# 系统变量 performance_schema_max_cond_classes 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 80 最低值 0 最大值（≥8.0.12） 1024 最大值（8.0.11） 256 条件仪器的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_cond_instances属性 值 命令行格式 --performance-schema-max-cond-instances=# 系统变量 performance_schema_max_cond_instances 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）已检测条件对象的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_digest_length属性 值 命令行格式 --performance-schema-max-digest-length=# 系统变量 performance_schema_max_digest_length 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 1024 最低值 0 最大值 1048576 每个语句保留的最大内存字节数，用于计算性能模式中的规范化语句摘要值。这个变量与
max_digest_length;请参见“服务器系统变量”中对该变量的描述。有关语句摘要的更多信息，包括有关内存使用的注意事项，请参见“性能模式语句摘要和采样”。
performance_schema_max_digest_sample_age属性 值 命令行格式 --performance-schema-max-digest-sample-age=# 系统变量 performance_schema_max_digest_sample_age 范围 Global 动态 是 SET_VAR提示适用没有 类型 整数 默认值 60 最低值 0 最大值 1048576 此变量影响表的语句采样
events_statements_summary_by_digest。插入新表行时，将产生行摘要值的语句存储为与摘要关联的当前样本语句。此后，当服务器看到其他具有相同摘要值的语句时，它将确定是否使用新语句替换当前的样本语句（即是否重新采样）。重采样策略基于当前示例语句和新语句的比较等待时间，以及可选的当前示例语句的寿命：- 基于等待时间的重采样：如果新语句的等待时间的等待时间大于当前示例语句的等待时间，则它将成为当前示例语句。
- 根据年龄进行重采样：如果
performance_schema_max_digest_sample_age系统变量的值大于零，并且当前样本语句的存在时间超过了几秒钟，则当前语句被视为“过旧”，而新语句将其替换。即使新语句的等待时间小于当前示例语句的等待时间，也会发生这种情况。
有关语句采样的信息，请参见“性能模式语句摘要和采样”。
performance_schema_max_file_classes属性 值 命令行格式 --performance-schema-max-file-classes=# 系统变量 performance_schema_max_file_classes 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 80 最低值 0 最大值（≥8.0.12） 1024 最大值（8.0.11） 256 文件工具的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_file_handles属性 值 命令行格式 --performance-schema-max-file-handles=# 系统变量 performance_schema_max_file_handles 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 32768 已打开文件对象的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
的值
performance_schema_max_file_handles应大于的值open_files_limit：open_files_limit影响服务器可以支持的打开文件句柄的最大数量，并performance_schema_max_file_handles影响可以检测这些文件句柄的数量。performance_schema_max_file_instances属性 值 命令行格式 --performance-schema-max-file-instances=# 系统变量 performance_schema_max_file_instances 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）已检测文件对象的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_index_stat属性 值 命令行格式 --performance-schema-max-index-stat=# 系统变量 performance_schema_max_index_stat 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动调整大小；不分配此文字值）性能架构为其维护统计信息的最大索引数。如果超过了该最大值，从而导致索引统计信息丢失，则性能架构将增加
Performance_schema_index_stat_lost状态变量。默认值使用的值自动调整大小performance_schema_max_table_instances。performance_schema_max_memory_classes属性 值 命令行格式 --performance-schema-max-memory-classes=# 系统变量 performance_schema_max_memory_classes 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 450 内存仪器的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_metadata_locks属性 值 命令行格式 --performance-schema-max-metadata-locks=# 系统变量 performance_schema_max_metadata_locks 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）元数据锁定工具的最大数量。此值控制
metadata_locks表的大小。如果超过了该最大值，使得无法检测到元数据锁，则性能架构将增加Performance_schema_metadata_lock_lost状态变量。performance_schema_max_mutex_classes属性 值 命令行格式 --performance-schema-max-mutex-classes=# 系统变量 performance_schema_max_mutex_classes 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值（≥8.0.12） 300 预设值（8.0.11） 250 最低值 0 最大值（≥8.0.12） 1024 最大值（8.0.11） 256 互斥乐器的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_mutex_instances属性 值 命令行格式 --performance-schema-max-mutex-instances=# 系统变量 performance_schema_max_mutex_instances 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）已检测的互斥对象的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_prepared_statements_instances属性 值 命令行格式 --performance-schema-max-prepared-statements-instances=# 系统变量 performance_schema_max_prepared_statements_instances 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）表中的最大行数
prepared_statements_instances。如果超过了该最大值，从而无法检测到准备好的语句，则性能架构将增加Performance_schema_prepared_statements_lost状态变量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。该变量的默认值将根据
max_prepared_stmt_count系统变量的值自动调整大小。performance_schema_max_rwlock_classes属性 值 命令行格式 --performance-schema-max-rwlock-classes=# 系统变量 performance_schema_max_rwlock_classes 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 40 最低值 0 最大值（≥8.0.12） 1024 最大值（8.0.11） 256 rwlock仪器的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_program_instances属性 值 命令行格式 --performance-schema-max-program-instances=# 系统变量 performance_schema_max_program_instances 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）性能模式为其维护统计信息的最大存储程序数。如果超过此最大值，则性能架构将增加
Performance_schema_program_lost状态变量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。performance_schema_max_rwlock_instances属性 值 命令行格式 --performance-schema-max-rwlock-instances=# 系统变量 performance_schema_max_rwlock_instances 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）检测的rwlock对象的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_socket_classes属性 值 命令行格式 --performance-schema-max-socket-classes=# 系统变量 performance_schema_max_socket_classes 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 10 最低值 0 最大值（≥8.0.12） 1024 最大值（8.0.11） 256 插座乐器的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_socket_instances属性 值 命令行格式 --performance-schema-max-socket-instances=# 系统变量 performance_schema_max_socket_instances 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）已检测的套接字对象的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_sql_text_length属性 值 命令行格式 --performance-schema-max-sql-text-length=# 系统变量 performance_schema_max_sql_text_length 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 1024 最低值 0 最大值 1048576 用于存储SQL语句的最大字节数。该值适用于以下列所需的存储：
- 在
SQL_TEXT该列events_statements_current，events_statements_history和events_statements_history_long语句事件表。 - 摘要表的
QUERY_SAMPLE_TEXT列events_statements_summary_by_digest。
超过的任何字节
performance_schema_max_sql_text_length都将被丢弃，并且不会出现在该列中。只有在该列中的许多初始字节不可区分之后，语句才有所不同。减小该
performance_schema_max_sql_text_length值会减少内存使用量，但如果仅在末尾不同，则更多的语句将变得难以区分。增加该值会增加内存使用量，但可以区分更长的语句。- 在
performance_schema_max_stage_classes属性 值 命令行格式 --performance-schema-max-stage-classes=# 系统变量 performance_schema_max_stage_classes 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 150 最低值 0 最大值（≥8.0.12） 1024 最大值（8.0.11） 256 舞台乐器的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_statement_classes属性 值 命令行格式 --performance-schema-max-statement-classes=# 系统变量 performance_schema_max_statement_classes 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动调整大小；不分配此文字值）声明工具的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
默认值是在服务器构建时根据客户端/服务器协议中的命令数量和服务器支持的SQL语句类型的数量计算的。
除非将其设置为0以禁用所有语句检测并保存与之关联的所有内存，否则请勿更改此变量。将变量设置为默认值以外的非零值没有任何好处；特别是，大于默认值的值将导致需要分配更多的内存。
performance_schema_max_statement_stack属性 值 命令行格式 --performance-schema-max-statement-stack=# 系统变量 performance_schema_max_statement_stack 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 10 性能模式为其维护统计信息的嵌套存储程序调用的最大深度。当超过此最大值时，性能模式
Performance_schema_nested_statement_lost将为每个执行的存储程序语句增加状态变量。performance_schema_max_table_handles属性 值 命令行格式 --performance-schema-max-table-handles=# 系统变量 performance_schema_max_table_handles 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）已打开表格对象的最大数量。此值控制
table_handles表的大小。如果超过了该最大值，使得无法检测到表句柄，则“性能模式”将增加Performance_schema_table_handles_lost状态变量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。performance_schema_max_table_instances属性 值 命令行格式 --performance-schema-max-table-instances=# 系统变量 performance_schema_max_table_instances 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）检测表对象的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_table_lock_stat属性 值 命令行格式 --performance-schema-max-table-lock-stat=# 系统变量 performance_schema_max_table_lock_stat 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动调整大小；不分配此文字值）性能模式为其维护锁统计信息的最大表数。如果超过此最大值，导致表锁统计信息丢失，则性能架构将增加
Performance_schema_table_lock_stat_lost状态变量。performance_schema_max_thread_classes属性 值 命令行格式 --performance-schema-max-thread-classes=# 系统变量 performance_schema_max_thread_classes 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 100 最低值 0 最大值（≥8.0.12） 1024 最大值（8.0.11） 256 线程工具的最大数量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。
performance_schema_max_thread_instances属性 值 命令行格式 --performance-schema-max-thread-instances=# 系统变量 performance_schema_max_thread_instances 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）已检测的线程对象的最大数量。该值控制
threads表的大小。如果超过了该最大值，导致无法检测线程，则性能架构将增加Performance_schema_thread_instances_lost状态变量。有关如何设置和使用此变量的信息，请参见“性能模式状态监视”。该
max_connections系统变量会影响多少个线程可以在服务器端运行。performance_schema_max_thread_instances影响可以检测多少个正在运行的线程。在
variables_by_thread和status_by_thread表格只包含约前台线程系统状态变量信息。如果不是所有线程都由性能架构进行检测，则该表将丢失一些行。在这种情况下，Performance_schema_thread_instances_lost状态变量将大于零。performance_schema_session_connect_attrs_size属性 值 命令行格式 --performance-schema-session-connect-attrs-size=# 系统变量 performance_schema_session_connect_attrs_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动调整大小；不分配此文字值）最低值 -1 最大值 1048576 每个线程为保留连接属性键值对保留的预分配内存量。如果客户端发送的连接属性数据的总大小大于此数量，则性能架构将截断该属性数据，递增
Performance_schema_session_connect_attrs_lost状态变量，然后将一条消息写入错误日志，以指示如果log_error_verbosity系统变量大于1. A_truncated如果属性缓冲区有足够的空间，则还会向该会话属性添加属性，该属性的值指示丢失了多少字节。这使性能架构可以在连接属性表中公开每个连接的截断信息。无需检查错误日志即可检查此信息。默认值
performance_schema_session_connect_attrs_size是在服务器启动时自动调整大小。该值可能很小，因此如果发生截断（Performance_schema_session_connect_attrs_lost变为非零），则可能希望将其performance_schema_session_connect_attrs_size显式设置为更大的值。尽管最大允许
performance_schema_session_connect_attrs_size值为1MB，但有效最大值为64KB，因为服务器对它将接受的连接属性数据的总大小施加了64KB的限制。如果客户端尝试发送超过64KB的属性数据，则服务器将拒绝连接。有关更多信息，请参见“性能架构连接属性表”。performance_schema_setup_actors_size属性 值 命令行格式 --performance-schema-setup-actors-size=# 系统变量 performance_schema_setup_actors_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）setup_actors表中的行数。performance_schema_setup_objects_size属性 值 命令行格式 --performance-schema-setup-objects-size=# 系统变量 performance_schema_setup_objects_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）setup_objects表中的行数。performance_schema_users_size属性 值 命令行格式 --performance-schema-users-size=# 系统变量 performance_schema_users_size 范围 Global 动态 没有 SET_VAR提示适用没有 类型 整数 默认值 -1（表示自动缩放；请勿分配此文字值）最低值 -1（表示自动缩放；请勿分配此文字值）最大值 1048576 users表中的行数。如果此变量为0，则性能架构将不维护users表中的连接统计信息或表中的状态变量信息status_by_user。