# PG_THREAD_WAIT_STATUS
通过PG_THREAD_WAIT_STATUS视图可以检测当前实例中工作线程（backend thread）以及辅助线程（auxiliary thread）的阻塞等待情况。
表1PG_THREAD_WAIT_STATUS字段 
| 名称          | 类型      | 描述                                                                                            |
|:---|:---|:---|
| node_name   | text    | 当前节点的名称。                                                                                      |
| db_name     | text    | 数据库名称。                                                                                        |
| thread_name | text    | 线程名称。                                                                                         |
| query_id    | bigint  | 查询ID，对应debug_query_id。                                                                        |
| tid         | bigint  | 当前线程的线程号。                                                                                     |
| lwtid       | integer | 当前线程的轻量级线程号。                                                                                  |
| ptid        | integer | streaming线程的父线程。                                                                              |
| tlevel      | integer | streaming线程的层级。                                                                               |
| smpid       | integer | 并行线程的ID。                                                                                      |
| wait_status | text    | 当前线程的等待状态。等待状态的详细信息请参见[表2]。 |
| wait_event                      | text                         | 如果wait_status是acquire lock、acquire lwlock、wait io三种类型，此列描述具体的锁、轻量级锁、IO的信息。否则为空。                                   |
   
wait_status列的等待状态有以下状态。
 表2等待状态列表 
| wait_status值                                        | 含义                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|
| none                                                | 未等任意事件。                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| acquire lock                                        | 等待加锁，要么加锁成功，要么加锁等待超时。                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| acquire lwlock                                                           | 等待获取轻量级锁。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| wait io                                                                 | 等待IO完成。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| wait cmd                                            | 等待完成读取网络通信包。                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| wait pooler get conn                                | 等待pooler完成获取连接。                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| wait pooler abort conn                              | 等待pooler完成终止连接。                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| wait pooler clean conn                              | 等待pooler完成清理连接。                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| pooler create conn: \[nodename\], total N                                | 等待pooler建立连接，当前正在与nodename指定节点建立连接，且仍有N个连接等待建立。                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| get conn                                            | 获取到其他节点的连接。                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| set cmd: \[nodename\]                               | 在连接上执行SET/RESET/TRANSACTION BLOCK LEVEL PARA SET/SESSION LEVEL PARA SET，当前正在nodename指定节点上执行。                                                                                                                                                                                                                                                                                                                                                                                         |
| cancel query                                        | 取消某连接上正在执行的SQL语句。                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| stop query                                          | 停止某连接上正在执行的查询。                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| wait node: \[nodename\](plevel), total N, \[phase\] | 等待接收与某节点的连接上的数据，当前正在等待nodename节点plevel线程的数据，且仍有N个连接的数据待返回。如果状态包含phase信息，则可能的阶段状态有： - begin：表示处于事务开始阶段。  - commit：表示处于事务提交阶段。  - rollback：表示处于事务回滚阶段。   |
| wait transaction sync: xid                          | 等待xid指定事务同步。                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| wait wal sync                                       | 等待特定LSN的wal log完成到备机的同步。                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| wait data sync                                      | 等待完成数据页到备机的同步。                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| wait data sync queue                                | 等待把行存的数据页或列存的CU放入同步队列。                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| flush data: \[nodename\](plevel), \[phase\]         | 等待向网络中nodename指定节点的plevel对应线程发送数据。如果状态包含phase信息，则可能的阶段状态为wait quota，即当前通信流正在等待quota值。                                                                                                                                                                                                                                                                                                                                                                                                |
| stream get conn: \[nodename\], total N              | 初始化stream flow时，等待与nodename节点的consumer对象建立连接，且当前有N个待建连对象。                                                                                                                                                                                                                                                                                                                                                                                                                            |
| wait producer ready: \[nodename\](plevel), total N  | 初始化stream flow时，等待每个producer都准备好，当前正在等待nodename节点plevel对应线程的producer对象准备好，且仍有N个producer对象处于等待状态。                                                                                                                                                                                                                                                                                                                                                                                     |
| synchronize quit                                    | stream plan结束时，等待stream线程组内的线程统一退出。                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| nodegroup destroy                                   | stream plan结束时，等待销毁stream node group。                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| wait active statement                                                   | 等待作业执行，正在资源负载管控中。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| wait global queue                                                     | 等待作业执行，正在全局队列排队。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| wait respool queue                                                    | 等待作业执行，正在资源池上排队。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| wait ccn queue                                                          | 等待作业执行，正在中心协调节点(CCN)中排队。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| gtm connect                                                           | 等待与GTM建连。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| gtm get gxid                                                            | 等待从GTM获取事务xid。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| gtm get snapshot                                                       | 等待从GTM获取事务快照snapshot。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| gtm begin trans                                                       | 等待GTM开始事务。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| gtm commit trans                                                       | 等待GTM提交事务。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| gtm rollback trans                                                       | 等待GTM执行事务回滚。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| gtm create sequence                                                   | 等待GTM创建sequence。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| gtm alter sequence                                                     | 等待GTM修改sequence。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| gtm get sequence val                                                   | 等待从GTM获取sequence的下一个值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| gtm set sequence val                                                   | 等待GTM设置sequence的值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| gtm drop sequence                                                        | 等待GTM删除sequence。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| gtm rename sequence                                                     | 等待GTM重命名sequence。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| analyze: \[relname\], \[phase\]                                        | 当前正在对表relname执行analyze。如果状态包含phase信息，则为autovacuum，表示是数据库自动开启AutoVacuum线程执行的analyze分析操作。                                                                                                                                                                                                                                                                                                                                                                                                                 |
| vacuum: \[relname\], \[phase\]                                          | 当前正在对表relname执行vacuum。如果状态包含phase信息，则为autovacuum，表示是数据库自动开启AutoVacuum线程执行的vacuum清理操作。                                                                                                                                                                                                                                                                                                                                                                                                                  |
| vacuum full: \[relname\]                                              | 当前正在对表relname执行vacuum full清理。                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| create index                                                         | 当前正在创建索引。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| HashJoin - \[ build hash \| write file \]                             | 当前是HashJoin算子，主要关注耗时的执行阶段。 - build hash：表示当前HashJoin算子正在建立哈希表。  - write file：表示当前HashJoin算子正在将数据写入磁盘。                                                                                                                                                  |
| HashAgg - \[ build hash \| write file \]                               | 当前是HashAgg算子，主要关注耗时的执行阶段。 - build hash：表示当前HashAgg算子正在建立哈希表。  - write file：表示当前HashAgg算子正在将数据写入磁盘。                                                                                                                                                            |
| HashSetop - \[build hash \| write file \]                              | 当前是HashSetop算子，主要关注耗时的执行阶段。 - build hash：表示当前HashSetop算子正在建立哈希表。  - write file：表示当前HashSetop算子正在将数据写入磁盘。                                                                                                                                                 |
| Sort \| Sort - write file                                                | 当前是Sort算子做排序，write file表示Sort算子正在将数据写入磁盘。                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Material \| Material - write file                                      | 当前是Material算子，write file表示Material算子正在将数据写入磁盘。                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| wait sync consumer next step                                             | Consumer接收端同步等待下一轮迭代。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| wait sync producer next step                                         | Producer发送端同步等待下一轮迭代。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| wait agent release                                                      | 正在释放当前agent(8.1.2及以上版本支持)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| wait stream task                                                      | stream线程等待被复用(8.1.2及以上版本支持)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   
当wait_status为acquire lwlock、acquire lock或者wait io时，表示有等待事件。正在等待获取wait_event列对应类型的轻量级锁、事务锁，或者正在进行IO。
其中，wait_status值为acquire lwlock（轻量级锁）时对应的wait_event等待事件类型与描述信息如下。（wait_event为extension时，表示此时的轻量级锁是动态分配的锁，未被监控。）
表3轻量级锁等待事件列表 
| wait_event类型                          | 类型描述                                        |
|:---|:---|
| ShmemIndexLock                    | 用于保护共享内存中的主索引哈希表。                           |
| OidGenLock                        | 用于避免不同线程产生相同的OID。                           |
| XidGenLock                         | 用于避免两个事务获得相同的xid。                         |
| ProcArrayLock                        | 用于避免并发访问或修改ProcArray共享数组。                  |
| SInvalReadLock                      | 用于避免与清理失效消息并发执行。                            |
| SInvalWriteLock                      | 用于避免与其它写失效消息、清理失效消息并发执行。                    |
| WALInsertLock                      | 用于避免与其它WAL插入操作并发执行。                           |
| WALWriteLock                      | 用于避免并发WAL写盘。                               |
| ControlFileLock                      | 用于避免pg_control文件的读写并发、写写并发。                 |
| CheckpointLock                        | 用于避免多个checkpoint并发执行。                        |
| CLogControlLock                      | 用于避免并发访问或者修改Clog控制数据结构。                    |
| MultiXactGenLock                    | 用于串行分配唯一MultiXact id。                         |
| MultiXactOffsetControlLock           | 用于避免对pg_multixact/offset的写写并发和读写并发。           |
| MultiXactMemberControlLock         | 用于避免对pg_multixact/members的写写并发和读写并发。        |
| RelCacheInitLock                     | 用于失效消息场景对init文件进行操作时加锁。                     |
| CheckpointerCommLock               | 用于向checkpointer发起文件刷盘请求场景，需要串行的向请求队列插入请求结构。 |
| TwoPhaseStateLock                    | 用于避免并发访问或者修改两阶段信息共享数组。                      |
| TablespaceCreateLock                 | 用于确定tablespace是否已经存在。                       |
| BtreeVacuumLock                      | 用于防止vacuum清理B-tree中还在使用的页面。                 |
| AutovacuumLock                      | 用于串行化访问autovacuum worker数组。                  |
| AutovacuumScheduleLock              | 用于串行化分配需要vacuum的table。                      |
| SyncScanLock                         | 用于确定heap扫描时某个relfilenode的起始位置。             |
| NodeTableLock                       | 用于保护存放CN和DN节点信息的共享结构。                       |
| PoolerLock                         | 用于保证两个线程不会同时从连接池里取到相同的连接。                  |
| RelationMappingLock                | 用于等待更新系统表到存储位置之间映射的文件。                     |
| AsyncCtlLock                       | 用于避免并发访问或者修改共享通知状态。                          |
| AsyncQueueLock                       | 用于避免并发访问或者修改共享通知信息队列。                       |
| SerializableXactHashLock             | 用于避免对于可串行事务共享结构的写写并发和读写并发。                    |
| SerializableFinishedListLock        | 用于避免对于已完成可串行事务共享链表的写写并发和读写并发。              |
| SerializablePredicateLockListLock | 用于保护对于可串行事务持有的锁链表。                          |
| OldSerXidLock                       | 用于保护记录冲突可串行事务的结构。                          |
| FileStatLock                       | 用于保护存储统计文件信息的数据结构。                          |
| SyncRepLock                         | 用于在主备复制时保护xlog同步信息。                         |
| DataSyncRepLock                     | 用于在主备复制时保护数据页同步信息。                          |
| CStoreColspaceCacheLock            | 用于保护列存表的CU空间分配。                              |
| CStoreCUCacheSweepLock             | 用于列存CU Cache循环淘汰。                         |
| MetaCacheSweepLock                   | 用于元数据循环淘汰。                                  |
| DfsConnectorCacheLock               | 用于保护缓存HDFS连接的句柄的全局哈希表。                     |
| dummyServerInfoCacheLock              | 用于保护缓存加速集群连接信息的全局哈希表。                       |
| ExtensionConnectorLibLock           | 用于初始化ODBC连接场景，在加载与卸载特定动态库时进行加锁。            |
| SearchServerLibLock                 | 用于GPU加速场景初始化加载特定动态库时，对读文件操作进行加锁。            |
| DfsUserLoginLock                    | 用于保护HDFS用户信息的全局链表。                         |
| DfsSpaceCacheLock                   | 用于控制HDFS表导入时文件ID单调递增。                       |
| LsnXlogChkFileLock                  | 用于串行更新特定结构中记录的主备机的xlog flush位置点。           |
| GTMHostInfoLock                     | 用于避免并发访问或者修改GTM主机信息。                        |
| ReplicationSlotAllocationLock       | 用于主备复制时保护主机端的流复制槽的分配。                        |
| ReplicationSlotControlLock         | 用于主备复制时避免并发更新流复制槽状态。                         |
| ResourcePoolHashLock                | 用于避免并发访问或者修改资源池哈希表。                          |
| WorkloadStatHashLock               | 用于避免并发访问或者修改包含CN侧的SQL请求构成的哈希表。             |
| WorkloadIoStatHashLock               | 用于避免并发访问或者修改用于统计当前DN的IO信息的哈希表。               |
| WorkloadCGroupHashLock             | 用于避免并发访问或者修改Cgroup信息构成的哈希表。                  |
| OBSGetPathLock                      | 用于避免对obs路径的写写并发和读写并发。                      |
| WorkloadUserInfoLock                | 用于避免并发访问或修改负载管理的用户信息哈希表。                    |
| WorkloadRecordLock                   | 用于避免并发访问或修改在内存自适应管理时对CN收到请求构成的哈希表。          |
| WorkloadIOUtilLock                 | 用于保护记录iostat，CPU等负载信息的结构。                     |
| WorkloadNodeGroupLock               | 用于避免并发访问或者修改内存中的nodegroup信息构成的哈希表。          |
| JobShmemLock                       | 用于MPP兼容ORACLE定时任务功能中保护定时读取的全局变量。              |
| OBSRuntimeLock                     | 用于获取环境变量，如GAUSSHOME。                          |
| LLVMDumpIRLock                     | 用于导出动态生成函数所对应的汇编语言。                          |
| LLVMParseIRLock                     | 用于在查询开始处从IR文件中编译并解析已写好的IR函数。                |
| RPNumberLock                       | 用于加速集群的DN对正在执行计划的任务线程的计数。                  |
| ClusterRPLock                      | 用于加速集群的CCN中维护的集群负载数据的并发存取控制。                |
| CriticalCacheBuildLock               | 用于从共享或者本地缓存初始化文件中加载cache的场景。               |
| WaitCountHashLock                   | 用于保护用户语句计数功能场景中的共享结构。                       |
| BufMappingLock                      | 用于保护对共享缓冲映射表的操作。                            |
| LockMgrLock                         | 用于保护常规锁结构信息。                               |
| PredicateLockMgrLock                 | 用于保护可串行事务锁结构信息。                           |
| OperatorRealTLock                    | 用于避免并发访问或者修改记录算子级实时数据的全局结构。                   |
| OperatorHistLock                     | 用于避免并发访问或者修改记录算子级历史数据的全局结构。                   |
| SessionRealTLock                      | 用于避免并发访问或者修改记录query级实时数据的全局结构。              |
| SessionHistLock                       | 用于避免并发访问或者修改记录query级历史数据的全局结构。               |
| CacheSlotMappingLock               | 用于保护CU Cache全局信息。                           |
| BarrierLock                           | 用于保证当前只有一个线程在创建Barrier。                       |
   
当wait_status值为wait io时对应的wait_event等待事件类型与描述信息如下。
表4IO等待事件列表 
| wait_event类型                | 类型描述                                                                   |
|:---|:---|
| BufFileRead                  | 从临时文件中读取数据到指定buffer。                                                     |
| BufFileWrite                 | 向临时文件中写入指定buffer中的内容。                                                   |
| ControlFileRead             | 读取pg_control文件。主要在数据库启动、执行checkpoint和主备校验过程中发生。                          |
| ControlFileSync            | 将pg_control文件持久化到磁盘。数据库初始化时发生。                                            |
| ControlFileSyncUpdate       | 将pg_control文件持久化到磁盘。主要在数据库启动、执行checkpoint和主备校验过程中发生。                     |
| ControlFileWrite           | 写入pg_control文件。数据库初始化时发生。                                                 |
| ControlFileWriteUpdate     | 更新pg_control文件。主要在数据库启动、执行checkpoint和主备校验过程中发生。                          |
| CopyFileRead                | copy文件时读取文件内容。                                                           |
| CopyFileWrite               | copy文件时写入文件内容。                                                          |
| DataFileExtend               | 扩展文件时向文件写入内容。                                                              |
| DataFileFlush                | 将表数据文件持久化到磁盘。                                                             |
| DataFileImmediateSync        | 将表数据文件立即持久化到磁盘。                                                        |
| DataFilePrefetch            | 异步读取表数据文件。                                                               |
| DataFileRead                  | 同步读取表数据文件。                                                                 |
| DataFileSync                | 将表数据文件的修改持久化到磁盘。                                                         |
| DataFileTruncate             | 表数据文件truncate。                                                           |
| DataFileWrite               | 向表数据文件写入内容。                                                              |
| LockFileAddToDataDirRead  | 读取"postmaster.pid"文件。                                                  |
| LockFileAddToDataDirSync   | 将"postmaster.pid"内容持久化到磁盘。                                               |
| LockFileAddToDataDirWrite    | 将pid信息写到"postmaster.pid"文件。                                              |
| LockFileCreateRead         | 读取LockFile文件"%s.lock"。                                                  |
| LockFileCreateSync        | 将LockFile文件"%s.lock"内容持久化到磁盘。                                           |
| LockFileCreateWRITE        | 将pid信息写到LockFile文件"%s.lock"。                                            |
| RelationMapRead              | 读取系统表到存储位置之间的映射文件。                                                      |
| RelationMapSync          | 将系统表到存储位置之间的映射文件持久化到磁盘。                                                  |
| RelationMapWrite          | 写入系统表到存储位置之间的映射文件。                                                     |
| ReplicationSlotRead         | 读取流复制槽文件。重新启动时发生。                                                      |
| ReplicationSlotRestoreSync | 将流复制槽文件持久化到磁盘。重新启动时发生。                                                  |
| ReplicationSlotSync       | checkpoint时将流复制槽临时文件持久化到磁盘。                                               |
| ReplicationSlotWrite       | checkpoint时写流复制槽临时文件。                                                     |
| SLRUFlushSync              | 将pg_clog、pg_subtrans和pg_multixact文件持久化到磁盘。主要在执行checkpoint和数据库停机时发生。     |
| SLRURead                    | 读取pg_clog、pg_subtrans和pg_multixact文件。                                   |
| SLRUSync                   | 将脏页写入文件pg_clog、pg_subtrans和pg_multixact并持久化到磁盘。主要在执行checkpoint和数据库停机时发生。 |
| SLRUWrite                 | 写入pg_clog、pg_subtrans和pg_multixact文件。                                    |
| TimelineHistoryRead      | 读取timeline history文件。在数据库启动时发生。                                         |
| TimelineHistorySync        | 将timeline history文件持久化到磁盘。在数据库启动时发生。                                   |
| TimelineHistoryWrite       | 写入timeline history文件。在数据库启动时发生。                                          |
| TwophaseFileRead           | 读取pg_twophase文件。在两阶段事务提交、两阶段事务恢复时发生。                                  |
| TwophaseFileSync          | 将pg_twophase文件持久化到磁盘。在两阶段事务提交、两阶段事务恢复时发生。                                 |
| TwophaseFileWrite          | 写入pg_twophase文件。在两阶段事务提交、两阶段事务恢复时发生。                                  |
| WALBootstrapSync           | 将初始化的WAL文件持久化到磁盘。在数据库初始化发生。                                            |
| WALBootstrapWrite           | 写入初始化的WAL文件。在数据库初始化发生。                                                   |
| WALCopyRead                | 读取已存在的WAL文件并进行复制时产生的读操作。在执行归档恢复完后发生。                                   |
| WALCopySync                | 将复制的WAL文件持久化到磁盘。在执行归档恢复完后发生。                                             |
| WALCopyWrite             | 读取已存在WAL文件并进行复制时产生的写操作。在执行归档恢复完后发生。                                    |
| WALInitSync               | 将新初始化的WAL文件持久化磁盘。在日志回收或写日志时发生。                                         |
| WALInitWrite                | 将新创建的WAL文件初始化为0。在日志回收或写日志时发生。                                          |
| WALRead                     | 从xlog日志读取数据。两阶段文件redo相关的操作产生。                                          |
| WALSyncMethodAssign        | 将当前打开的所有WAL文件持久化到磁盘。                                                   |
| WALWrite                   | 写入WAL文件。                                                               |
| AuditWrite                 | 审计日志线程写文件。                                                             |
| LogRead                     | 日志线程读文件。                                                                |
| LogWrite                    | 日志线程写文件。                                                                 |
   
当wait_status值为acquire lock（事务锁）时对应的wait_event等待事件类型与描述信息如下。
表5事务锁等待事件列表 
| wait_event类型     | 类型描述          |
|:---|:---|
| relation         | 对表加锁。          |
| extend           | 对表扩展空间时加锁。     |
| partition        | 对分区表加锁。        |
| partition_seq   | 对分区表的分区加锁。      |
| page              | 对表页面加锁。        |
| tuple             | 对页面上的tuple加锁。 |
| transactionid    | 对事务ID加锁。     |
| virtualxid        | 对虚拟事务ID加锁。      |
| object            | 加对象锁。           |
| cstore_freespace | 对列存空闲空间加锁。    |
| userlock       | 加用户锁。          |
| advisory         | 加advisory锁。     |
   
