DESC JOB
DESC JOB
查看指定作业的详细信息,包括作业配置、运行状态、执行耗时、输入输出统计等。
语法
DESC JOB 'job_id';
参数说明
| 参数 | 必填 | 说明 |
|---|
job_id
job_id | 是 | 作业唯一标识符,字符串格式。可从 SHOW JOBS
SHOW JOBS 的输出或作业执行日志中获取 |
返回列说明
DESC JOB
DESC JOB
返回一个
info_name
info_name
/
info_value
info_value
键值对列表,包含以下字段:
| info_name | 说明 |
|---|
name
name | 作业 ID(与 job_id
job_id 相同) |
creator
creator | 提交作业的用户名 |
created_time
created_time | 作业创建时间 |
last_modified_time
last_modified_time | 作业最后更新时间 |
comment
comment | 作业备注 |
workspace
workspace | 所属工作空间 |
job_id
job_id | 作业唯一标识符 |
status
status | 作业状态:RUNNING
RUNNING 、SUCCEED
SUCCEED 、FAILED
FAILED 、SETUP
SETUP 、QUEUED
QUEUED 、CANCELLED
CANCELLED |
start_time
start_time | 作业开始执行时间 |
end_time
end_time | 作业结束时间,未完成时为空 |
execution_time
execution_time | 执行耗时(毫秒) |
priority
priority | 作业优先级 |
vcluster_name
vcluster_name | 执行作业的计算资源名称 |
vcluster_type
vcluster_type | 计算资源类型(如 GENERAL
GENERAL 、ANALYTICS
ANALYTICS ) |
job_text
job_text | 作业的 SQL 文本 |
query_tag
query_tag | 关联的查询标签 |
hint
hint | 作业执行时使用的 hint 参数 |
input_tables
input_tables | 输入表及其读取的行数和字节数 |
output_tables
output_tables | 输出结果的行数和字节数 |
使用示例
- 查看指定作业的详细信息:
DESC JOB '2026051922541032000079660';
+--------------------+------------------------------------------+
| info_name | info_value |
+--------------------+------------------------------------------+
| name | 2026051922541032000079660 |
| creator | qiliang |
| created_time | 2026-05-19 22:54:11.031 |
| last_modified_time | 2026-05-19 22:54:11.101 |
| comment | |
| workspace | quick_start |
| job_id | 2026051922541032000079660 |
| status | SUCCEED |
| start_time | 2026-05-19 22:54:11.029 |
| end_time | 2026-05-19 22:54:11.046 |
| execution_time | 17 |
| priority | 0 |
| vcluster_name | DEFAULT |
| vcluster_type | GENERAL |
| job_text | SHOW TABLES WHERE is_dynamic=true LIMIT 5|
| query_tag | 00-a7a0f9af48f34b57d00b0b0331e2fd8e-... |
| hint | ((...)) |
| input_tables | quick_start.__dql__.show_tables_impl ... |
| output_tables | 0 rows , 0 bytes |
+--------------------+------------------------------------------+
- 先通过
SHOW JOBS
SHOW JOBS
找到目标作业,再查看其详情:
-- 第一步:找到最近执行失败的作业
SHOW JOBS WHERE status='FAILED' LIMIT 5;
-- 第二步:查看该作业的详细信息
DESC JOB '<从上一步获取的 job_id>';
注意事项
job_id
job_id
必须用单引号括起来,格式为字符串。
- 作业 ID 可从以下途径获取:
SHOW JOBS
SHOW JOBS
命令的输出、SQL 执行后的返回信息、Lakehouse Studio 的作业历史页面。
execution_time
execution_time
单位为毫秒。
input_tables
input_tables
和 output_tables
output_tables
字段记录了作业的数据读写量,可用于评估作业的资源消耗。