---
description: 记录知识库来源资源的刷新、更新和解析状态。
navTitle: KB_SOURCE_STATUS
---
# **KB\_SOURCE\_STATUS 知识库来源状态表**

记录知识库来源资源的名称、描述、更新时间、刷新时间和解析状态。

## 使用说明{#usage}

一条记录对应一个知识库中的一个来源资源，用于判断该来源是否已经完成解析、是否需要重新刷新，以及最近一次刷新对应的来源信息。知识库中接入多个文档、目录或外部资源时，可以通过 `KB_ID` 和 `SOURCE_ID` 定位到具体来源。

`SOURCE_ID` 是来源的唯一标识，通常是 UUID。`SOURCE_TYPE` 表示来源类型，如附件、文本、VFS 文件、元数据文件、URL、指标等，取值按 `KbDocSourceType` 约定。`SOURCE_NAME` 用于列表展示，`SOURCE_DESC` 用于描述来源内容和用途。

`SOURCE_REFRESH_TIME` 表示用户手工刷新此来源的时间，`PARSE_STATUS` 表示当前解析状态。排查知识库内容未更新、来源失效或解析异常时，可以优先查看这两个字段。

用户手工刷新某个来源时会更新 `SOURCE_REFRESH_TIME`。之后系统会遍历来源数据并与知识库文档状态表对比，早于该刷新时间的文档会重新进入同步判断；如果文档已经同步且内容没有变化，可以跳过重复解析。

全量刷新可能耗时较长，过程中服务可能重启，因此系统会边同步边更新 `KB_DOC_STATUS` 的同步时间。重新执行时会继续检查已同步记录，避免无变化文档重复解析。

## 位置{#position}

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

物理表名：`SZSYS_5_KB_SOURCE_STATUS`

## 表结构{#structure}

| 字段名 | 字段类型 | 字段描述 |
| :----  | :---- | :------ |
| KB\_ID | VARCHAR(64) | 知识库ID，主键 |
| SOURCE\_ID | VARCHAR(64) | 来源ID，主键 |
| SOURCE\_TYPE | VARCHAR(32) | 来源类型 |
| SOURCE\_NAME | VARCHAR(128) | 来源名称 |
| SOURCE\_DESC | VARCHAR(1024) | 来源描述 |
| SOURCE\_CREATED\_TIME | TIME | 来源创建时间 |
| SOURCE\_UPDATED\_TIME | TIME | 来源更新时间 |
| SOURCE\_REFRESH\_TIME | TIME | 来源刷新时间，用于触发或判断来源级全量刷新 |
| PARSE\_STATUS | VARCHAR(32) | 解析状态 |

## 表索引{#indexes}

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