Source: https://dev-docs.yueshu.com.cn/v5.3.2/database-gql-reference/data-admin/show/show-jobs/
Documentation version: v5.3.2

# SHOW JOB / JOBS

`SHOW JOBS`命令返回当前服务组中所有未过期的作业的信息。

系统定期清理已完成或失败的作业，默认清理间隔为 7 天。未过期的作业是指未被系统清理的作业。

下表展示了`SHOW JOBS`命令返回的信息：

 | 列 | 描述
 | `job_id` | 作业的 ID。
 | `type` | 作业的类型。取值包括：
`COMPACT`：压缩数据。
`STATS`：生成统计信息。
`FLUSH`：将数据写入磁盘。
`REPAIR_INDEX`：在创建索引时自动生成的内部后台索引构建作业。
 | `state` | 作业的状态。取值包括：
 `SUBMITTED`：作业正在排队等待执行。
 `RUNNING`：作业正在进行中。
 `SUCCEEDED`：作业成功完成。
 `FAILED`：作业失败。
 `STOPPED`：作业已停止。
 | `submit_time` | 作业达到状态`SUBMITTED`的时间。
 | `start_time` | 作业达到状态`RUNNING`的时间。
 | `end_time` | 作业达到状态`SUCCEEDED`、`FAILED`或`STOPPED`的时间。

若要查看特定作业的详细信息，可使用`SHOW JOB <job_id>`命令。`job_id`可以来自手动提交的作业，也可以来自您在`SHOW JOBS`中看到的后台作业。

下表展示了`SHOW JOB`命令返回的信息：

 | 列 | 描述
 | `task_id` | 构成作业的任务的 ID。
 | `state` | 任务的状态。取值包括：
`TASK_DISPATCH`：任务已分发。
`TASK_RUNNING`：任务正在运行。
`TASK_FAIL`：任务失败。
`TASK_CANCEL`：任务被取消。
`TASK_SUCCEEDED`：任务已完成。
`TASK_RETRY`：任务已重新执行。
 | `service_id` | 执行任务的服务的 ID。
 | `dispatch_time` | 任务达到状态`TASK_DISPATCH`的时间。
 | `end_time` | 作业达到状态`SUCCEEDED`、`FAILED`或`STOPPED`的时间。

## 语法

语法图源码

 show_jobs_command show_job_command  

````
show_jobs_command ::=
    'SHOW' 'JOBS'
show_job_command ::=
    'SHOW' 'JOB' job_id

````

## 参数

### `job_id`

特定作业的 ID。

## 示例

### 显示所有作业

````
SHOW JOBS

````

返回：

````
+--------+--------------+-----------+-----------------------------+-----------------------------+-----------------------------+
| job_id | type         | state     | submit_time                 | start_time                  | end_time                    |
+--------+--------------+-----------+-----------------------------+-----------------------------+-----------------------------+
| 4      | REPAIR_INDEX | SUCCEEDED | 2025-03-18T10:25:22.296000Z | 2025-03-18T10:25:22.300000Z | 2025-03-18T10:25:22.371000Z |
| 3      | STATS        | SUCCEEDED | 2025-03-18T10:19:42.339000Z | 2025-03-18T10:19:42.340000Z | 2025-03-18T10:19:42.351000Z |
| 2      | COMPACT      | SUCCEEDED | 2025-03-18T10:19:29.554000Z | 2025-03-18T10:19:29.556000Z | 2025-03-18T10:19:29.654000Z |
| 1      | FLUSH        | SUCCEEDED | 2025-03-18T10:19:24.308000Z | 2025-03-18T10:19:24.312000Z | 2025-03-18T10:19:24.430000Z |
+--------+--------------+-----------+-----------------------------+-----------------------------+-----------------------------+

````

### 显示特定作业

````
SHOW JOB 1

````

返回：

````
+---------+----------------+------------+-----------------------------+-----------------------------+
| task_id | state          | service_id | dispatch_time               | end_time                    |
+---------+----------------+------------+-----------------------------+-----------------------------+
| 1       | TASK_SUCCEEDED | 2          | 2025-03-18T07:35:44.211000Z | 2025-03-18T07:35:44.247000Z |
+---------+----------------+------------+-----------------------------+-----------------------------+

````