---
description: 记录知识库提取任务的执行日志和统计信息。
navTitle: KB_EXTRACT_LOGS
---
# **KB\_EXTRACT\_LOGS 知识库提取日志表**

记录知识库提取任务的起止时间、执行状态、日志内容、目标和统计数量。

## 使用说明{#usage}

一条记录对应一次知识库提取过程，用于查看提取开始和结束时间、执行人、执行结果以及处理数量。管理员排查知识库同步慢、部分来源失败或任务被取消时，可以结合 `STATE`、`LOGS` 和各统计字段定位问题。

`EXTRACT_MODE` 用于区分全量提取、增量提取等不同执行方式，`EXTRACT_TARGET` 记录本次提取面向的目标范围。`TOTAL_COUNT`、`SUCCESS_COUNT`、`ERROR_COUNT`、`CANCEL_COUNT`、`SKIP_COUNT` 共同描述本次提取的处理结果。

全量提取时，`SKIP_COUNT` 记录已经提取且内容没有变化的文档数量；指定文件或指定来源提取时，`EXTRACT_TARGET` 记录目标文档ID或来源ID。`LOGS` 可保存提取过程中的进度日志和异常详情，便于多节点环境下查看提取进度。

`USER_ID` 记录触发提取的用户；如果由系统调度触发，通常记录为 `system`。`STATE` 的约定值为：`0` 运行中、`1` 成功、`2` 失败、`3` 取消。`EXTRACT_MODE` 的约定值为：`1` 全量提取、`2` 增量提取、`3` 指定文件、`4` 指定来源。

## 位置{#position}

模型路径：`/sysdata/data/tables/dw/KB_EXTRACT_LOGS.tbl`

物理表名：`SZSYS_5_KB_EXTRACT_LOGS`

## 表结构{#structure}

| 字段名 | 字段类型 | 字段描述 |
| :----  | :---- | :------ |
| KB\_ID | VARCHAR(64) | 知识库ID |
| LOG\_ID | VARCHAR(64) | 日志ID，主键 |
| START\_TIME | TIMESTAMP | 开始时间 |
| END\_TIME | TIMESTAMP | 结束时间 |
| USER\_ID | VARCHAR(64) | 用户ID |
| STATE | NUMBER(1) | 执行状态 |
| LOGS | CLOB | 执行日志内容 |
| EXTRACT\_MODE | NUMBER(1) | 提取模式 |
| EXTRACT\_TARGET | VARCHAR(128) | 提取目标 |
| ELAPSED\_MS | NUMBER(20) | 执行耗时，单位毫秒 |
| TOTAL\_COUNT | NUMBER(10) | 总数量 |
| SUCCESS\_COUNT | NUMBER(10) | 成功数量 |
| ERROR\_COUNT | NUMBER(10) | 失败数量 |
| CANCEL\_COUNT | NUMBER(10) | 取消数量 |
| SKIP\_COUNT | NUMBER(10) | 跳过数量，通常表示内容没有变化而未重新解析的文档数 |

## 表索引{#indexes}

| 类型 | 名称 | 字段列表 | 是否唯一 | 说明 |
| :---- | :---- | :---- | :------ | :------ |
| 主键 | PRIMARY | LOG\_ID | 是 | 唯一标识一条记录 |
| 索引 | - | - | - | 该表未定义其他索引 |