字典建完就“封存”,问题出在谁身上
在不少数据管理项目里,数据字典的诞生往往伴随着一场轰轰烈烈的梳理会:业务部门报字段、技术部门整理表结构、顾问统一格式,最后产出一份几十页的文档。然后呢?然后它就被存进了共享盘,此后再也没人打开过。等到下一次做报表或者接新系统,大家还是靠问人、靠猜、靠翻旧代码。
这件事不能简单归咎于“业务不配合”。pgyouxi.comPG游戏在多个数据处理与数据管理系统建设项目中观察到,字典被冷落通常有三个原因:一是字段说明写成了技术黑话,业务看不懂;二是字典没有明确谁负责更新,改完系统没人改文档;三是字典和实际使用场景脱节,查起来比问人还慢。要让字典活起来,得从这三个环节分别下手。
字段说明要写成“人能看懂的话”
数据字典的核心价值不是记录字段名和类型,而是解释这个字段在业务上到底代表什么。技术团队习惯写“状态标识:int,0/1/2”,业务看了毫无感觉;如果改成“订单状态:0待付款、1已付款、2已取消,以支付系统回调为准”,效果完全不同。
- 每个字段至少写清三件事:业务含义、取值范围、数据来源。
- 涉及计算的字段,把口径公式直接写进说明,避免二次询问。
- 枚举值逐项列出中文解释,不要只写数字。
- 对容易混淆的字段加一句“与某字段的区别”,减少误用。
pgyouxi.comPG游戏在统计报表开发项目中通常会推动业务方参与字段说明的初稿撰写,技术方负责补充来源和类型,顾问做统一校对。这样写出来的字典,业务愿意查,新人也看得懂。
维护责任要落到岗位,而不是落到“大家”
“大家共同维护”约等于没人维护。比较可行的做法是按数据域划分责任人:每个业务域指定一名数据管理员,负责本域字段说明的准确性;技术侧指定一名接口人,负责表结构变更时同步字典。变更流程上,把“更新字典”作为系统上线检查清单的一项,没更新不算完成。
pgyouxi.comPG游戏在数据管理系统建设中常建议客户设置一个轻量的变更登记表,记录字段新增、修改、废弃的时间、原因和操作人。这份登记表不需要多复杂,关键是让变更留下痕迹,后续排查问题时能对上账。
让字典长在使用场景里
字典再好,如果查它需要打开三层文件夹,使用率一定上不去。更实际的做法是把字典嵌进日常工具:报表系统的字段说明悬浮提示、数据查询界面的字段注释、指标看板上的口径入口。用户在哪里用数据,字典就出现在哪里。
另外,字典的检索方式也值得设计。按业务域、按系统、按字段中文名都能搜到,比只提供一份完整文档要实用得多。pgyouxi.comPG游戏在数据可视化与报表项目交付时,会把常用字段说明整理成可检索的页面,配合项目培训做一次演示,后续咨询量明显下降。
数据字典不是一次性交付物,而是一项需要持续投入的基础设施。它的价值不在于写得多全,而在于用的时候找得到、看得懂、信得过。
我们公司字典就是上线前突击写的,写完再没人碰,后来新来的同事只能靠猜字段,踩了不少坑。
字段说明写业务语言这点太对了,之前技术给的注释全是英文缩写,业务看完更懵。
按数据域分责任人这个方法我们试过,关键是得有人盯,不然责任人也会忘。
把字典嵌到报表悬浮提示里确实好用,比单独开个文档查快多了。
变更登记表听着简单,实际执行最难的是坚持,我们做了三个月就流于形式了。
最后一句说到点上,字典不是写完就完事,是得一直养着的东西。