文档主页
MySQL 8.4 参考手册
相关文档 下载本手册
PDF (US Ltr) - 39.9Mb
PDF (A4) - 40.0Mb
手册页 (TGZ) - 258.5Kb
手册页 (Zip) - 365.5Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


29.12.22.8 threads 表

threads 表包含服务器中每个线程对应的一行。每行包含有关线程的信息,并指示是否为其启用了监控和历史事件日志记录

mysql> SELECT * FROM performance_schema.threads\G
*************************** 1. row ***************************
            THREAD_ID: 1
                 NAME: thread/sql/main
                 TYPE: BACKGROUND
       PROCESSLIST_ID: NULL
     PROCESSLIST_USER: NULL
     PROCESSLIST_HOST: NULL
       PROCESSLIST_DB: mysql
  PROCESSLIST_COMMAND: NULL
     PROCESSLIST_TIME: 418094
    PROCESSLIST_STATE: NULL
     PROCESSLIST_INFO: NULL
     PARENT_THREAD_ID: NULL
                 ROLE: NULL
         INSTRUMENTED: YES
              HISTORY: YES
      CONNECTION_TYPE: NULL
         THREAD_OS_ID: 5856
       RESOURCE_GROUP: SYS_default
     EXECUTION_ENGINE: PRIMARY
    CONTROLLED_MEMORY: 1456
MAX_CONTROLLED_MEMORY: 67480
         TOTAL_MEMORY: 1270430
     MAX_TOTAL_MEMORY: 1307317
     TELEMETRY_ACTIVE: NO
...

当性能模式初始化时,它会根据当时存在的线程填充 threads 表。此后,每当服务器创建线程时,就会添加新行。

新线程的 INSTRUMENTEDHISTORY 列值由 setup_actors 表的内容决定。有关如何使用 setup_actors 表控制这些列的信息,请参见 第 29.4.6 节,“按线程预过滤”

threads 表中删除行发生在线程结束时。对于与客户端会话关联的线程,删除发生在会话结束时。如果客户端启用了自动重新连接,并且会话在断开连接后重新连接,则会话将与 threads 表中具有不同 PROCESSLIST_ID 值的新行关联。新线程的初始 INSTRUMENTEDHISTORY 值可能与原始线程的不同:setup_actors 表可能在此期间发生改变,并且如果原始线程的 INSTRUMENTEDHISTORY 值在行初始化后发生改变,则更改不会延续到新线程。

您可以启用或禁用线程监控(即,线程执行的事件是否被仪器化)和历史事件日志记录。要控制新前台线程的初始 INSTRUMENTEDHISTORY 值,请使用 setup_actors 表。要控制现有线程的这些方面,请设置 threads 表行的 INSTRUMENTEDHISTORY 列。(有关线程监控和历史事件日志记录发生的条件的更多信息,请参见 INSTRUMENTEDHISTORY 列的描述。)

要比较 threads 表中名称以 PROCESSLIST_ 为前缀的列与其他进程信息源,请参见 进程信息来源

重要

对于 threads 表之外的线程信息源,只有在当前用户具有 PROCESS 权限时,才会显示其他用户的线程信息。这与 threads 表不同;所有行都会显示给具有该表 SELECT 权限的任何用户。不应该通过访问 threads 表查看其他用户的线程的用户,不应获得该表的 SELECT 权限。

threads 表包含以下列

  • THREAD_ID

    一个唯一的线程标识符。

  • 名称

    与服务器中线程检测代码关联的名称。例如,thread/sql/one_connection对应于代码中负责处理用户连接的线程函数,而thread/sql/main代表服务器的main()函数。

  • 类型

    线程类型,可以是FOREGROUNDBACKGROUND。用户连接线程是前台线程。与内部服务器活动相关的线程是后台线程。例如,内部InnoDB线程、binlog dump线程将信息发送到副本以及复制 I/O 和 SQL 线程。

  • PROCESSLIST_ID

    对于前台线程(与用户连接相关),这是连接标识符。这与INFORMATION_SCHEMA PROCESSLIST 表的ID列中显示的值相同,显示在SHOW PROCESSLIST 输出的Id列中,并由线程内的CONNECTION_ID() 函数返回。

    对于后台线程(与用户连接无关),PROCESSLIST_IDNULL,因此这些值不唯一。

  • PROCESSLIST_USER

    与前台线程关联的用户,后台线程为NULL

  • PROCESSLIST_HOST

    与前台线程关联的客户端主机名,后台线程为NULL

    INFORMATION_SCHEMA PROCESSLIST 表的HOST列或SHOW PROCESSLIST 输出的Host列不同,PROCESSLIST_HOST列不包含 TCP/IP 连接的端口号。要从性能模式中获取此信息,请启用套接字检测(默认情况下未启用)并检查socket_instances 表。

    mysql> SELECT NAME, ENABLED, TIMED
           FROM performance_schema.setup_instruments
           WHERE NAME LIKE 'wait/io/socket%';
    +----------------------------------------+---------+-------+
    | NAME                                   | ENABLED | TIMED |
    +----------------------------------------+---------+-------+
    | wait/io/socket/sql/server_tcpip_socket | NO      | NO    |
    | wait/io/socket/sql/server_unix_socket  | NO      | NO    |
    | wait/io/socket/sql/client_connection   | NO      | NO    |
    +----------------------------------------+---------+-------+
    3 rows in set (0.01 sec)
    
    mysql> UPDATE performance_schema.setup_instruments
           SET ENABLED='YES'
           WHERE NAME LIKE 'wait/io/socket%';
    Query OK, 3 rows affected (0.00 sec)
    Rows matched: 3  Changed: 3  Warnings: 0
    
    mysql> SELECT * FROM performance_schema.socket_instances\G
    *************************** 1. row ***************************
               EVENT_NAME: wait/io/socket/sql/client_connection
    OBJECT_INSTANCE_BEGIN: 140612577298432
                THREAD_ID: 31
                SOCKET_ID: 53
                       IP: ::ffff:127.0.0.1
                     PORT: 55642
                    STATE: ACTIVE
    ...
  • PROCESSLIST_DB

    线程的默认数据库,如果没有选择数据库则为NULL

  • PROCESSLIST_COMMAND

    对于前台线程,线程代表客户端执行的命令类型,如果会话处于空闲状态,则为Sleep。有关线程命令的描述,请参见第 10.14 节,“检查服务器线程(进程)信息”。此列的值对应于客户端/服务器协议的COM_xxx命令和Com_xxx状态变量。请参见第 7.1.10 节,“服务器状态变量”

    后台线程不会代表客户端执行命令,因此此列可能为NULL

  • PROCESSLIST_TIME

    线程处于当前状态的时间(以秒为单位)。对于副本 SQL 线程,该值是上次复制事件的时间戳与副本主机实际时间之间的时间间隔。请参见第 19.2.3 节,“复制线程”

  • PROCESSLIST_STATE

    指示线程正在执行的操作、事件或状态。有关PROCESSLIST_STATE值的描述,请参见第 10.14 节,“检查服务器线程(进程)信息”。如果值为NULL,则该线程可能对应于空闲客户端会话,或者它正在执行的工作没有使用阶段进行检测。

    大多数状态对应于非常快的操作。如果线程在给定状态下保持很多秒,则可能存在需要调查的问题。

  • PROCESSLIST_INFO

    线程正在执行的语句,如果它没有执行语句,则为NULL。该语句可能是发送到服务器的语句,或者如果该语句执行其他语句,则为最内层的语句。例如,如果CALL语句执行执行SELECT语句的存储过程,则PROCESSLIST_INFO值将显示SELECT语句。

  • PARENT_THREAD_ID

    如果此线程是子线程(由另一个线程生成),则这是生成线程的THREAD_ID值。

  • 角色

    未使用。

  • 检测

    线程执行的事件是否已检测。该值为YESNO

    • 对于前台线程,初始INSTRUMENTED值取决于与线程关联的用户帐户是否与setup_actors 表中的任何行匹配。匹配基于PROCESSLIST_USERPROCESSLIST_HOST列的值。

      如果线程生成子线程,则会再次针对为子线程创建的threads 表行进行匹配。

    • 对于后台线程,INSTRUMENTED默认值为YES。不会查询setup_actors,因为后台线程没有关联的用户。

    • 对于任何线程,其INSTRUMENTED值都可以在线程的整个生命周期内更改。

    为了监视线程执行的事件,以下条件必须成立

    • setup_consumers 表中的thread_instrumentation使用者必须为YES

    • threads.INSTRUMENTED列必须为YES

    • 仅监视从检测器生成的那些线程事件,这些检测器在setup_instruments 表中具有ENABLED列设置为YES

  • 历史记录

    是否为线程记录历史事件。该值为YESNO

    • 对于前台线程,初始HISTORY值取决于与线程关联的用户帐户是否与setup_actors 表中的任何行匹配。匹配基于PROCESSLIST_USERPROCESSLIST_HOST列的值。

      如果线程生成子线程,则会再次针对为子线程创建的threads 表行进行匹配。

    • 对于后台线程,HISTORY默认值为YES。不会查询setup_actors,因为后台线程没有关联的用户。

    • 对于任何线程,其HISTORY值都可以在线程的整个生命周期内更改。

    为了记录线程的历史事件,以下条件必须成立

    • setup_consumers 表中相应的历史相关使用者必须启用。例如,在events_waits_historyevents_waits_history_long 表中记录等待事件需要相应的events_waits_historyevents_waits_history_long使用者为YES

    • threads.HISTORY列必须为YES

    • 仅记录从检测器生成的那些线程事件,这些检测器在setup_instruments 表中具有ENABLED列设置为YES

  • CONNECTION_TYPE

    用于建立连接的协议,对于后台线程为NULL。允许的值为TCP/IP(在没有加密的情况下建立的 TCP/IP 连接)、SSL/TLS(在加密情况下建立的 TCP/IP 连接)、Socket(Unix 套接字文件连接)、Named Pipe(Windows 命名管道连接)和Shared Memory(Windows 共享内存连接)。

  • THREAD_OS_ID

    底层操作系统定义的线程或任务标识符(如果有)。

    • 当 MySQL 线程在其整个生命周期内与同一个操作系统线程相关联时,THREAD_OS_ID包含操作系统线程 ID。

    • 当 MySQL 线程在其整个生命周期内没有与同一个操作系统线程相关联时,THREAD_OS_ID包含NULL。这在使用线程池插件时对于用户会话来说很常见(请参见第 7.6.3 节,“MySQL 企业版线程池”)。

    对于 Windows,THREAD_OS_ID对应于在 Process Explorer 中可见的线程 ID (https://technet.microsoft.com/en-us/sysinternals/bb896653.aspx).

    对于 Linux,THREAD_OS_ID对应于gettid()函数的值。例如,可以使用perfps -L命令或在proc文件系统 (/proc/[pid]/task/[tid]) 中公开此值。有关更多信息,请参见perf-stat(1)ps(1)proc(5)手册页。

  • RESOURCE_GROUP

    资源组标签。如果当前平台或服务器配置不支持资源组,则此值为NULL(请参见资源组限制)。

  • EXECUTION_ENGINE

    查询执行引擎。该值可以是PRIMARYSECONDARY。用于 HeatWave 服务和 HeatWave,其中PRIMARY引擎为InnoDBSECONDARY引擎为 HeatWave (RAPID)。对于 MySQL 社区版服务器、MySQL 企业版服务器(本地)以及没有 HeatWave 的 HeatWave 服务,该值始终为PRIMARY

  • CONTROLLED_MEMORY

    线程使用的受控内存量。

  • MAX_CONTROLLED_MEMORY

    线程执行期间看到的CONTROLLED_MEMORY的最大值。

  • TOTAL_MEMORY

    线程当前使用的内存量,无论是否受控。

  • MAX_TOTAL_MEMORY

    线程执行期间看到的TOTAL_MEMORY的最大值。

  • TELEMETRY_ACTIVE

    线程是否有活动的遥测会话附加。该值为YESNO

threads 表具有以下索引

  • 主键在 (THREAD_ID) 上

  • 索引在 (NAME) 上

  • 索引在 (PROCESSLIST_ID) 上

  • 索引在 (PROCESSLIST_USER, PROCESSLIST_HOST) 上

  • 索引在 (PROCESSLIST_HOST) 上

  • 索引在 (THREAD_OS_ID) 上

  • 索引在 (RESOURCE_GROUP) 上

不允许对threads 表使用TRUNCATE TABLE