---
description: 记录元数据文件及其引用物理表之间的引用关系，用于资源血缘和影响分析。
navTitle: META_LINKS
---
# **META\_LINKS 文件引用关系表**

记录了元数据文件之间的以及元数据引用物理表之间的引用关系。引用关系主要包括：

1. 数据加工中数据输入或输出对象引用的物理表或元数据数据表。
2. 数据加工中手写的SQL中from/insert/update等后面引用的物理表。
3. 数据表模型属性中用户设置的依赖表。
4. 页面对象（包括报表、仪表板、spg、表单等）引用的数据模型、主题、图片等等。
5. 门户引用的资源。

## 位置{#position}

模型路径：`/sysdata/data/tables/meta/META_LINKS.tbl`

物理表名：`SZSYS_5_META_LINKS`

## 表结构{#structure}

| 字段名 | 主键 | 字段类型 | 字段描述 | 说明 |
| --- | :----: | :---- | :------ | :----- |
| SRC\_FILE\_ID | 是 | VARCHAR(32) | 发起引用源文件ID | 发起引用的文件的标示，可与[META\_FILES-文件表](./META_FILES.md)表中的`ID`字段关联。
| SRC\_PATH | | VARCHAR(512) | 发起引用的源路径 | 发起引用的元数据文件路径，通常是以`/`开头、包含项目名的完整路径
| SRC\_COMPONENT | | VARCHAR(64) | 源组件 | 发起引用的组件的ID，可能空
| SRC\_PROPERTY | | VARCHAR(64) | 源属性 | 发起引用的属性名，可能空
| TARGET\_PATH | 是 | VARCHAR(512) | 目标路径 | 被引用资源的路径，可能有多种形式，具体见下文《关于TARGET\_TYPE和TARGET\_PATH》。
| TARGET\_FILE\_ID | | VARCHAR(32) | 目标文件ID | 纪录被引用的元数据文件的id，如果不存在或不是元数据文件，那么为空
| TARGET\_FILE\_TYPE | | VARCHAR(64) | 目标文件类型 | 当目标是元数据文件时记录文件类型，如tbl、dash等 |
| TARGET\_TYPE | | VARCHAR(16) | 目标类型 | 见下文《关于TARGET\_TYPE和TARGET\_PATH》
| REF\_RW | | VARCHAR(2) | 读写模式 | r表示只读，w表示写，rw表示读写
| REF\_TYPE | 是 | VARCHAR(32) | 引用类型 | 用于区分普通引用、写影响、手动维护等不同来源或用途的引用关系 |
| REF\_VALID | | NUMBER(1) | 是否有效 | 1有效，0无效
| REFRESH\_TIME | | TIMESTAMP | 刷新时间 | 引用关系数据刷新的时间，用于帮助判断这条数据是否是新的。

**关于TARGET\_TYPE和TARGET\_PATH：**

目标资源可能有多种，如元数据文件、主题、图片、url、数据库表等，`TARGET_TYPE`用于标识具体的资源类型，主要有下面几种：

| TARGET\_TYPE | 说明 | TARGET\_PATH示例
| --- | :----- | :-----
| METAFILE | 引用元数据文件，包括模型表、报表、spg等元数据。 | `/DEMO/ana/xxxx/yyy.spg`
| URL | 引用一个外部的url。如钻取到互联网上的某个地址。 | `https://succsoft.com`
| SERVICE | 系统服务，比如gis、email、等外部服务 | `$SERVICE:/xxx`
| EXTPOINT | 扩展点贡献项 | `$EXTPOINT:/component/ComponentXxx`
| EXTFILE | 扩展贡献项内部文件 | `$EXTFILE:/images/succ-images-red/icon_bg10_1.png`
| DATEROLE | 日期角色 | `$DATEROLE:/month/c/yyyy-mm`
| GEOROLE | 地理角色 | `$GEOROLE:/china`
| SYSDATEROLE | 系统日期角色资源ID代号，已废弃 | `$SYSDATEROLE:/DEMO/month/yyyy-mm/C`
| SYSTBL | 系统表，如用户表、部门表等。 | `$SYSTBL:/xxxx`
| INNERIMG | 对象内私有图片，已废弃，使用INNER | `$INNERIMG:/xxxx`
| INNER | 页面内私有资源 | `$INNER:/xxxx`
| PROJECTIMG | 图片库中的图片，已废弃，使用PROJECT | `$PROJECTIMG:/xxxx`
| PROJECT | 项目资源库 | `$PROJECT:/images/xxx.png`
| APP | 应用资源库 | `$TAPP:/assets/images/xxx.png`
| THEMEIMG | 主题图片，已废弃，使用THEME | `$THEMEIMG:/xxxx`
| THEME | 主题资源 | `$THEME:/xxxx`
| DB | 引用数据库表，主要是物理表、视图、存储过程等对象。 | `$DB:/xxxx`
| DATACONNECTOR | 第三方数据连接或其中的表 | `$DATACONNECTOR:/connectorName/schemaName/ObjectName`
| DATAFILE | 引用数据文件。如数据加工中引用的用户上传的文件。 | `$DATAFILE:/xxxx`

## 表索引{#indexes}

| 类型 | 名称 | 字段列表 | 是否唯一 | 说明 |
| :---- | :---- | :---- | :------ | :------ |
| 主键 | PRIMARY | SRC\_FILE\_ID, TARGET\_PATH, REF\_TYPE | 是 | 唯一标识一条记录 |
| 索引 | IDX4\_META\_LINKS\_SRC\_PATH | SRC\_PATH | 否 | 用于按 SRC\_PATH 查询记录 |
| 索引 | IDX4\_META\_LINKS\_TARGET\_PATH | TARGET\_PATH | 否 | 用于按 TARGET\_PATH 查询记录 |
| 索引 | IDX4\_META\_LINKS\_REF | REF\_TYPE | 否 | 用于按 REF\_TYPE 查询记录 |

## 说明{#explan}

1. 本表用于资源血缘分析和影响分析：从源资源可以查它依赖了哪些目标资源，从目标资源也可以反查哪些资源会受它影响。
2. `TARGET_FILE_ID`只在目标能够对应到元数据文件时有值；引用外部 URL、数据库对象或其他非文件资源时通常为空。
3. 资源移动或重命名后，`SRC_PATH`和`TARGET_PATH`会用于继续保持引用关系可追踪。
