---
description: 存放元数据目录结构和文件基本信息，是元数据资源管理的核心表。
navTitle: META_FILES
---
# **META\_FILES 文件表**

存放元数据目录结构和文件基本信息，是元数据资源管理的核心表。报表、仪表板、数据模型、主题、图片、目录等资源都会在这里登记，用于资源树展示、路径定位、版本判断、权限和引用分析等场景。

## 位置{#position}

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

物理表名：`SZSYS_5_META_FILES`

## 表结构{#structure}

| 字段名  | 字段类型 | 字段描述 |
| :----  | :---- | :------ |
| ID | VARCHAR(32) | 文件的唯一标识，主键 |
| PROJECT\_NAME | VARCHAR(16) | 项目名称，文件所在的项目，不能为空 |
| PARENT\_DIR | VARCHAR(620) | 父路径，文件所在的路径，不能为空，`/`开头，不以/结尾，如`/ana`，在项目根上用`/`表示 |
| NAME | VARCHAR(128) | 文件名称，不能为空，如`WTYB.tbl` |
| TYPE | VARCHAR(16) | 文件类型，即文件后缀名，不含点号，如tbl、dash等 |
| DESC | VARCHAR(512) | 文件描述，文件的简短业务描述 |
| REVISION | NUMBER(16) | 版本号，不能为空，当文件内容有变化时会自动增加版本号 |
| IS\_FOLDER | NUMBER(1) | 是否为文件夹，1代表文件夹，0代表文件 |
| IS\_HIDDEN | NUMBER(1) | 是否隐藏，1代表隐藏，0代表不隐藏 |
| LABELS | VARCHAR(2084) | 标签，用`\n`分割记录文件的标签 |
| COMMENT | VARCHAR(1024) | 修改记录，修改文件时写的提交说明 |
| ICON | VARCHAR(64) | 文件图标 |
| CREATE\_TIME | TIMESTAMP | 创建时间 |
| MODIFY\_TIME | TIMESTAMP | 修改时间 |
| CREATOR | VARCHAR(64) | 创建者 |
| MODIFIER | VARCHAR(64) | 修改者 |
| SUB\_FILE\_TYPE | VARCHAR(16) | 文件子类型 |
| STATE | NUMBER(2) | 文件状态 |
| HASH | VARCHAR(64) | 文件内容摘要，用于判断内容是否变化 |
| IS\_GZ | NUMBER(1) | 内容是否压缩存储，1代表是，0代表否 |
| OPTION | VARCHAR(1024) | 系统扩展属性，产品内部使用，如dwtable和theme记录额外信息 |
| CUSTOM\_OPTION | VARCHAR(1024) | 用户扩展属性，自定义属性，产品内部并未使用，给自定义开发者用 |
| ORDER | NUMBER(8) | 排序，排序字段 |
| SIZE | NUMBER(16) | 文件内容大小 |
| CONTENT | BLOB | 文件内容，GZIP压缩的文件内容 |

## 表索引{#indexes}

| 类型 | 名称 | 字段列表 | 是否唯一 | 说明 |
| :---- | :---- | :---- | :------ | :------ |
| 主键 | PRIMARY | ID | 是 | 唯一标识一条记录 |
| 索引 | IDX4\_META\_FILES\_PROJECT\_NAME | PROJECT\_NAME | 否 | 用于按 PROJECT\_NAME 查询记录 |
| 索引 | IDX4\_META\_FILES\_PATH | PARENT\_DIR, NAME | 是 | 用于按 PARENT\_DIR, NAME 查询记录 |
| 索引 | IDX4\_META\_FILES\_NAME | NAME | 否 | 用于按 NAME 查询记录 |
| 索引 | IDX4\_META\_FILES\_TYPE | TYPE | 否 | 用于按 TYPE 查询记录 |

## 说明{#explan}

1. 资源路径由`PROJECT_NAME`、`PARENT_DIR`和`NAME`共同表达；`PARENT_DIR`表示所在目录，`NAME`表示文件或目录名。
2. `ID`是资源稳定标识，资源改名或移动时通常仍用于关联其他系统表。
3. `MODIFY_TIME`可用于判断资源或目录树是否发生变化；目录的修改时间也可能随下级资源变化而更新。
4. `CONTENT`保存资源正文，查询资源列表时通常不需要读取该字段。