SHOW JOBS

展示当前用户所拥有的作业信息，包括已完成和正在运行的作业。默认显示最近 7 天内提交的记录，最多返回 10000 条。

语法

SHOW JOBS [IN VCLUSTER vc_name] [LIKE 'pattern'] [WHERE <expr>] [LIMIT num];

参数说明

参数	必填	说明
`IN VCLUSTER vc_name` IN VCLUSTER vc_name	否	筛选指定计算资源下的作业，不指定则返回所有计算资源的作业
`LIKE 'pattern'` LIKE 'pattern'	否	按 `job_id` job_id 进行模式匹配，支持 `%` % （任意字符）和 `_` _ （单个字符）通配符
`WHERE <expr>` WHERE <expr>	否	按返回列进行条件过滤，支持的过滤字段见下方返回列说明
`LIMIT num` LIMIT num	否	限制返回记录数，范围 1–10000，默认不限制（受 7 天和 10000 条上限约束）

返回列说明

列名	类型	说明
`job_id` job_id	STRING	作业唯一标识符
`status` status	STRING	作业状态： `RUNNING` RUNNING 、 `SUCCEED` SUCCEED 、 `FAILED` FAILED 、 `SETUP` SETUP 、 `QUEUED` QUEUED 、 `CANCELLED` CANCELLED
`creator` creator	STRING	提交作业的用户名
`priority` priority	STRING	作业优先级
`start_time` start_time	TIMESTAMP	作业开始时间（UTC）
`end_time` end_time	TIMESTAMP	作业结束时间（UTC），运行中的作业为 NULL
`execution_time` execution_time	INTERVAL	作业执行耗时
`vcluster_name` vcluster_name	STRING	执行作业的计算资源名称
`job_text` job_text	STRING	作业的 SQL 文本
`query_tag` query_tag	STRING	作业关联的查询标签

WHERE

WHERE

子句可对上述任意列进行过滤，例如

WHERE status='SUCCEED'

WHERE status='SUCCEED'

、

WHERE vcluster_name='DEFAULT'

WHERE vcluster_name='DEFAULT'

、

WHERE execution_time > INTERVAL 2 MINUTE

WHERE execution_time > INTERVAL 2 MINUTE

。

使用示例

查看最近 3 条作业记录：

SHOW JOBS LIMIT 3;

+---------------------------+---------+---------+----------+-------------------------+-------------------------+----------------+--------------+--------------------+-----------+ | job_id | status | creator | priority | start_time | end_time | execution_time | vcluster_name | job_text | query_tag | +---------------------------+---------+---------+----------+-------------------------+-------------------------+----------------+--------------+--------------------+-----------+ | 2026051922541032000079660 | SUCCEED | qiliang | 0 | 2026-05-19 22:54:11.029 | 2026-05-19 22:54:11.046 | 17 | DEFAULT | SHOW TABLES ... | ... | | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | +---------------------------+---------+---------+----------+-------------------------+-------------------------+----------------+--------------+--------------------+-----------+

查看
```
DEFAULT
```
DEFAULT
计算资源下执行时间超过 2 分钟的作业：

SHOW JOBS IN VCLUSTER DEFAULT WHERE execution_time > INTERVAL 2 MINUTE;

筛选状态为
```
SUCCEED
```
SUCCEED
的作业，最多返回 10 条：

SHOW JOBS WHERE status='SUCCEED' LIMIT 10;

按
```
job_id
```
job_id
前缀模糊匹配：

SHOW JOBS LIKE '20260519%';

查看指定计算资源下最近 50 条作业：

SHOW JOBS IN VCLUSTER DEFAULT LIMIT 50;

注意事项

默认只返回最近 7 天内的作业，超出时间范围的历史作业不会显示。
单次查询最多返回 10000 条记录，超出部分会被截断。
```
execution_time
```
execution_time
字段单位为毫秒，在
```
WHERE
```
WHERE
子句中使用时需用
```
INTERVAL
```
INTERVAL
表达式，例如
```
WHERE execution_time > INTERVAL 2 MINUTE
```
WHERE execution_time > INTERVAL 2 MINUTE
。
若未指定
```
IN VCLUSTER
```
IN VCLUSTER
，将返回当前用户在所有计算资源下的作业。

联系我们