数据字典包括哪些内容:两类版本区分
数据字典包括哪些内容,分为数据库物理数据字典和软件工程需求分析逻辑数据字典两套体系,数据库版侧重表、字段、约束、索引、存储参数,可直接用于建表、接口开发与数据校验;软件工程版覆盖数据项、数据结构、数据流、数据存储、处理过程,多用于需求梳理与数据流图配套文档,GB/T39449-2020公共信用信息数据字典维护与管理规定,共享类业务系统的数据字典必须补充值域说明、来源、更新周期、责任人,仅简单记录字段名的文档不满足跨部门数据交换要求,这套文档不适合纯离线静态报表项目,这类场景只需要字段、类型、注释、取值范围的精简版本。
数据字典:数据库版本内容
数据项是最小描述单元,对应数据表内单个字段,记录字段中文名、英文编码、数据类型、长度、精度、是否允许空值、默认值、取值值域、校验规则,比如手机号字段标注字符串类型,长度11,正则校验规则,值域仅允许数字。数据结构对应数据表或者视图,写明表英文名称、中文业务名称、业务含义、主键、外键关联表、分区策略、存储引擎,区分基础主表、关联中间表、历史归档表。
约束与索引信息用来保障数据完整性,包含主键约束、唯一约束、非空约束、外键约束,以及索引名称、索引字段、索引类型,区分普通索引、联合索引、唯一索引,记录索引建立目的,方便后期SQL性能排查。
元管理信息用来支撑运维和数据治理,包含数据来源、更新频率、数据责任人、业务归属系统、数据安全分级、变更记录,每次字段修改、值域调整都要留存版本,避免新旧接口出现定义冲突。
数据字典:软件工程逻辑版本内容
数据流描述数据在业务系统中的传输路径,填写数据流编号、名称、业务说明、来源处理节点、去向处理节点、组成的数据结构,记录日常流量与峰值流量,用来评估接口并发承载压力。
数据存储描述系统内保存数据的载体,不是数据库表,而是业务层面存储单元,记录存储名称、内部包含的数据结构、读写操作、存储容量预估,用来评估业务需要存储的数据体量。
处理过程描述业务逻辑单元,包含过程编号、名称、输入数据流、输出数据流、业务逻辑简述,不写代码实现,只定义业务规则,方便产品、开发、测试对齐业务理解。
外部实体描述系统外交互对象,比如用户、第三方平台,记录实体名称、输入输出数据流,明确系统边界,防止需求范围持续扩大。
精简版够用。
| 类型 | 适用场景 | 核心内容 | 维护成本 |
|---|---|---|---|
| 数据库物理数据字典 | 数据库设计、接口开发、数据仓库 | 表、字段、索引、约束、存储参数 | 中等,表结构变更同步更新 |
| 软件工程逻辑数据字典 | 需求分析、数据流建模、业务梳理 | 数据项、数据流、处理过程、外部实体 | 偏高,业务改动需要整体修订 |
| 极简数据字典 | 离线报表、简单Excel导出 | 字段名称、类型、注释、取值范围 | 低,一次性编写即可 |
同一字段在多业务系统中定义不一致,是跨系统对接最常见问题,你编写数据字典时,要统一编码与值域,不要直接复制单个系统内的字段注释作为标准定义。
