SHOW LOCKS

引入或更新: v1.2.262

提供当前持有表锁的活动事务列表，可以是当前用户在所有会话中的锁，也可以是Databend系统中所有用户的锁。锁是一种同步机制，用于限制对共享资源（如表）的访问，确保Databend系统中的进程或线程之间的有序和受控交互，以维护数据一致性并防止冲突。

诸如UPDATE、DELETE、OPTIMIZE TABLE、RECLUSTER TABLE和ALTER TABLE COLUMN等操作可能会导致系统中的表锁。表锁功能默认启用。在资源冲突的情况下，您可以使用该命令检查具体细节。要禁用此功能，请执行set enable_table_lock=0;。

语法

SHOW LOCKS [IN ACCOUNT] [WHERE <expr>]

参数	描述
IN ACCOUNT	显示Databend系统中所有用户的锁信息。如果省略，该命令将返回当前用户在所有会话中的锁。
WHERE	根据状态过滤锁；有效值包括HOLDING和WAITING。

输出

该命令返回包含以下列的锁信息表：

列名	描述
table_id	与锁关联的表的内部ID。
revision	指示发起锁的事务版本的修订号。从0开始，该数字随着每个后续事务递增，建立了所有事务的完整顺序。
type	锁的类型，如TABLE。
status	锁的状态，如HOLDING或WAITING。
user	与锁关联的用户。
node	持有锁的查询节点标识符。
query_id	与锁相关的查询会话ID。在死锁或锁持有时间过长的情况下，使用它来KILL查询。
created_on	发起锁的事务创建的时间戳。
acquired_on	锁被获取的时间戳。
extra_info	与锁相关的额外信息（如果有）。

示例

SHOW LOCKS IN ACCOUNT;
+----------+----------+-------+---------+------+------------------------+--------------------------------------+----------------------------+----------------------------+------------+
| table_id | revision | type  | status  | user | node                   | query_id                             | created_on                 | acquired_on                | extra_info |
+----------+----------+-------+---------+------+------------------------+--------------------------------------+----------------------------+----------------------------+------------+
|       57 |     4517 | TABLE | HOLDING | root | xzi6pRbLUYasuA9QFB36m6 | d7989971-d5ec-4764-8e37-afe38ebc13e2 | 2023-12-13 09:56:47.295684 | 2023-12-13 09:56:47.310805 |            |
+----------+----------+-------+---------+------+------------------------+--------------------------------------+----------------------------+----------------------------+------------+

SHOW LOCKS;
+----------+----------+-------+---------+------+------------------------+--------------------------------------+----------------------------+----------------------------+------------+
| table_id | revision | type  | status  | user | node                   | query_id                             | created_on                 | acquired_on                | extra_info |
+----------+----------+-------+---------+------+------------------------+--------------------------------------+----------------------------+----------------------------+------------+
|       57 |     4517 | TABLE | HOLDING | root | xzi6pRbLUYasuA9QFB36m6 | d7989971-d5ec-4764-8e37-afe38ebc13e2 | 2023-12-13 09:56:47.295684 | 2023-12-13 09:56:47.310805 |            |
|       57 |     4521 | TABLE | WAITING | zzq  | xzi6pRbLUYasuA9QFB36m6 | 4bc78044-d4fc-4fe1-a5c5-ff6ab1e3e372 | 2023-12-13 09:56:48.419774 | NULL                       |            |
+----------+----------+-------+---------+------+------------------------+--------------------------------------+----------------------------+----------------------------+------------+

SHOW LOCKS WHERE STATUS = 'HOLDING';
+----------+----------+-------+---------+------+------------------------+--------------------------------------+----------------------------+----------------------------+------------+
| table_id | revision | type  | status  | user | node                   | query_id                             | created_on                 | acquired_on                | extra_info |
+----------+----------+-------+---------+------+------------------------+--------------------------------------+----------------------------+----------------------------+------------+
|       57 |     4517 | TABLE | HOLDING | root | xzi6pRbLUYasuA9QFB36m6 | d7989971-d5ec-4764-8e37-afe38ebc13e2 | 2023-12-13 09:56:47.295684 | 2023-12-13 09:56:47.310805 |            |
+----------+----------+-------+---------+------+------------------------+--------------------------------------+----------------------------+----------------------------+------------+