---
description: 存储计划中的任务定义和最近运行状态。
navTitle: TASKS
---
# **TASKS 任务表**

任务表存储计划中的任务定义和最近运行状态。一个计划可以包含多个任务，任务可以指向报表、数据提取、订阅、备份或其他资源，也可以通过分类、标签、优先级、执行条件等配置组织执行顺序。

任务记录由计划配置产生，用户修改任务时更新定义字段；任务被执行时更新最近运行 ID、运行状态、执行节点、心跳时间和最近运行时长。每次实际执行会在 `TASK_RUNS` 中产生一条运行记录，过程日志写入 `TASK_RUNLOGS`。

## 位置{#position}

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

物理表名：`SZSYS_5_TASKS`

## 表结构{#structure}

| 字段名 | 字段类型 | 字段描述 |
| :----  | :---- | :------ |
| TASK\_ID | VARCHAR(64) | 任务ID，主键 |
| SCHEDULE\_ID | VARCHAR(64) | 计划ID |
| CREATOR | VARCHAR(64) | 创建者，系统默认计划的创建者是admin |
| CREATE\_TIME | TIMESTAMP | 创建时间 |
| MODIFIER | VARCHAR(64) | 修改者，如果刚创建，那么这个字段就是等于创建者，系统默认计划的创建者是admin |
| MODIFIED\_TIME | TIMESTAMP | 修改时间，如果刚创建，那么这个字段就是等于创建时间 |
| RESID | VARCHAR(64) | 资源ID，此任务对应的资源id，可能为空（如当自动备份时） |
| RESID\_UKEY | VARCHAR(64) | 资源唯一性辅助键，用于区分同一资源下不同参数或不同订阅对象的任务 |
| SUB\_SUBJECT | VARCHAR(1024) | 订阅邮件标题 |
| SUB\_TO | VARCHAR(1024) | 订阅者，可以是用户id、用户组id、邮箱地址。如果这里面有用户自己的id，那么表示订阅给自己 |
| TASK\_TYPE | VARCHAR(20) | 任务类型，常见值有：sub订阅，etl数据提取，afl：AFL任务，kdb：知识库任务，script：脚本任务，sysBackup：系统备份，sysClean：系统清理，sysLogCollect：日志采集，workflow：流程任务，urge：催办，expire：过期处理，check：检查，schedule：计划任务 |
| TASK\_CATEGORY | VARCHAR(32) | 任务分类，关联 TASK\_CATEGORIES |
| INHERITE\_CATEGORY | VARCHAR(32) | 任务继承配置的分类ID，用于确定任务默认配置来源 |
| TASK\_LABELS | VARCHAR(1024) | 任务标签，多个标签以逗号分隔 |
| PRIORITY | NUMBER(3) | 优先级 |
| ENABLED | NUMBER(1) | 是否启用，0：禁用；1：启用 |
| RUN\_AFTER\_TIME | VARCHAR(12) | 任务允许开始执行的时间点，适用于需要等到特定时刻后再运行的任务 |
| RUN\_ON\_DATETIME | VARCHAR(128) | 任务允许执行的日期或时间规则，不匹配时本次任务会被跳过 |
| LAST\_UPDATE\_TIME | TIMESTAMP | 更新时间 |
| LAST\_TASK\_RUN\_ID | VARCHAR(32) | 任务最近运行ID |
| LAST\_SCHEDULE\_RUN\_ID | VARCHAR(32) | 计划最近运行ID |
| RUNNING\_STATE | NUMBER(1) | 运行状态 |
| RUNNING\_CLUSTER\_NODE | VARCHAR(32) | 当前执行器节点 |
| RUNNING\_HEARTBEAT\_TIME | TIMESTAMP | 执行器心跳时间 |
| OPTIONS | VARCHAR(5120) | 扩展属性，保存依赖任务、重试、通知、参数、超时和执行条件等任务级配置 |
| TASK\_EXT\_OPTION1 | VARCHAR(1024) | 扩展选项1，供业务扩展保存任务级附加信息 |
| TASK\_EXT\_OPTION2 | VARCHAR(1024) | 扩展选项2，供业务扩展保存任务级附加信息 |
| LAST\_DURATION | NUMBER(16) | 最近运行时长 |

## 表索引{#indexes}

| 类型 | 名称 | 字段列表 | 是否唯一 | 说明 |
| :---- | :---- | :---- | :------ | :------ |
| 主键 | PRIMARY | TASK\_ID | 是 | 唯一标识一条记录 |
| 索引 | IDX\_KEYS | SCHEDULE\_ID, RESID, RESID\_UKEY | 是 | 用于按 SCHEDULE\_ID, RESID, RESID\_UKEY 查询记录 |
| 索引 | IDX\_LAST\_TASK\_RUN\_ID | LAST\_TASK\_RUN\_ID | 否 | 用于按 LAST\_TASK\_RUN\_ID 查询记录 |
| 索引 | IDX\_LAST\_SCHEDULE\_RUN\_ID | LAST\_SCHEDULE\_RUN\_ID | 否 | 用于按 LAST\_SCHEDULE\_RUN\_ID 查询记录 |
| 索引 | IDX\_RESID | RESID | 否 | 用于按 RESID 查询记录 |
| 索引 | IDX\_TASK\_TYPE | TASK\_TYPE | 否 | 用于按 TASK\_TYPE 查询记录 |