---
description: 记录任务在一次计划运行中的执行情况和结果。
navTitle: TASK_RUNS
---
# **TASK\_RUNS 任务运行记录**

此表记录任务在一次计划运行中的执行情况。计划启动后，会为本次涉及的任务生成运行记录，用于展示任务级状态、执行顺序、起止时间、执行节点、错误信息、重试次数和影响行数。

`TASK_ID` 关联 `TASKS`，`SCHEDULE_RUN_ID` 关联本次计划运行记录 `SCHEDULE_RUNS`。同一个任务多次运行会产生多条历史记录；如果任务在一次运行中发生重试，通常仍记录在同一条任务运行记录中，并通过错误次数和起止时间反映过程变化。

## 位置{#position}

模型路径：`/sysdata/data/tables/sys/TASK_RUNS.tbl`

物理表名：`SZSYS_5_TASK_RUNS`

## 表结构{#structure}

| 字段名 | 字段类型 | 字段描述 |
| :----  | :---- | :------ |
| TASK\_RUN\_ID | VARCHAR(32) | 任务运行ID，主键 |
| TASK\_ID | VARCHAR(64) | 任务ID |
| SCHEDULE\_ID | VARCHAR(64) | 计划ID |
| SCHEDULE\_RUN\_ID | VARCHAR(32) | 计划运行ID |
| TASK\_RUN\_ORDER | NUMBER(8) | 本次计划运行中的任务执行顺序，便于按编排顺序展示 |
| RESID | VARCHAR(64) | 资源ID |
| RUN\_USERID | VARCHAR(32) | 执行用户，如果是自动的，那么为系统用户system |
| RUN\_NODE | VARCHAR(64) | 执行节点 |
| RUN\_STATE | VARCHAR(16) | 运行状态，UNKNOWN：未知，SKIP：跳过，BLOCK：阻塞，WAITING：等待，RUNNING：运行中，SUCCESS：成功，ERROR：失败，TIMEOUT：超时，CANCEL：取消 |
| FIRST\_START\_TIME | TIMESTAMP | 首次开始时间，任务重试时保持不变 |
| START\_TIME | TIMESTAMP | 本次尝试的开始时间，任务重试时会更新 |
| END\_TIME | TIMESTAMP | 本次尝试的结束时间 |
| LAST\_UPDATE\_TIME | TIMESTAMP | 更新时间 |
| ERROR\_CODE | VARCHAR(128) | 错误编码，用于统计和定位失败类型 |
| ERROR\_MESSAGE | VARCHAR(8192) | 错误信息 |
| PRIORITY | NUMBER(4) | 本次运行使用的任务优先级 |
| TASK\_CATEGORY | VARCHAR(32) | 本次运行使用的任务分类 |
| ERROR\_TIMES | NUMBER(12) | 重试次数，有重试就加1 |
| AFFECTED\_ROWCOUNT | NUMBER(18) | 更新数据行数 |

## 表索引{#indexes}

| 类型 | 名称 | 字段列表 | 是否唯一 | 说明 |
| :---- | :---- | :---- | :------ | :------ |
| 主键 | PRIMARY | TASK\_RUN\_ID | 是 | 唯一标识一条记录 |
| 索引 | - | TASK\_ID, SCHEDULE\_RUN\_ID | 是 | 用于按 TASK\_ID, SCHEDULE\_RUN\_ID 查询记录 |