TapCub 正式上线:统计、分析、客服一个平台免费用
术语表

什么是数据字典?定义、模板和示例

数据字典说明数据集里的每个字段:名称、含义、类型、允许的取值和负责人。该包含哪些内容、一个统计事件的示例,以及它和数据目录的区别。

陈屿 审核人 林舟 又称 元数据表 最后更新 2026 年 11 月 4 日 术语表

一句话回答

数据字典是一份参考文档或表格,列出数据集或系统里的每个字段,并记录每个字段的名称、通俗含义、数据类型、允许取值、来源和负责人。

什么是数据字典?

数据字典是一份参考资料,列出数据集里的每个字段并加以说明:叫什么、是什么意思、存什么类型的值、允许哪些值、从哪里来、归谁负责。它把一个叫 plan_t 的列,变成「事件发生时账户所在的订阅套餐:free、pro 或 business」。

每个条目该包含什么

列例子
名称plan
说明事件发生时账户的订阅套餐
类型字符串(枚举)
允许取值 / 格式free、pro、business
是否必填是,在 subscription_started 上
来源结账时从服务端发送
负责人计费团队
敏感级别非个人信息
示例值pro

一份统计事件的示例字典

事件属性类型允许取值必填说明
signupmethodstringemail、google、github是账户是怎么创建的
signupreferrer_codestring8 个字符否邀请码(如有)
purchaserevenuenumber≥ 0,项目币种是折后订单金额
purchaseorder_idstring计费系统 ID是同时用作去重键
report_viewedreportstringoverview、pages、sources是打开的是哪份报表

(演示条目。)

数据字典和相关文档

文档描述什么通常谁负责
数据字典数据集内部字段的含义、类型、规则数据负责人或分析师
表结构(Schema)数据库强制执行的技术结构研发
数据目录很多数据集的清单,带搜索和血缘数据平台团队
埋点方案计划采集的事件、属性和状态产品分析
业务术语表「活跃客户」这类业务名词业务和数据团队一起

在产品分析里,埋点方案和数据字典有重叠:方案说明应该发什么,字典描述实际存了什么。

怎么保持更新

  • 没有条目就不加字段。 把字典复查和代码评审放在同一张检查清单里。
  • 能自动生成的就自动生成。 类型和最近的取值可以自动扫描;含义和归属不行。
  • 下线不再使用的字段。 收不到数据的字段标成已废弃,而不是直接删掉条目。
  • 标出个人信息。 字典是标记「哪些字段能识别到人」的地方,这也是数据治理的基础。

TapCub 里的属性字典

TapCub 的属性字典(全端分析 › 数据管理 › 属性字典)会扫描用户档案、近 7 天的事件属性和账户属性,推断每个字段的类型,并分成直接标识、间接标识和非个人三类;直接标识默认在列表和导出中脱敏。你改过类型或分级并保存后,之后的自动扫描不再覆盖。事件定义(含说明和必填属性)在事件收件箱的「事件定义」页签。另见事件属性。

相关阅读

这个解释清楚吗?

我们会根据反馈修改和补充这篇内容。

陈屿

技术工程师

专注统计代码、SDK 与接口集成文档,从接入验证到问题排查,帮助开发者更顺畅地完成实施。

常见问题

常见追问

大家看完定义后最常问的几个问题。

还有其他问题?

直接和 TapCub 团队聊聊——工作日通常几小时内回复。

数据字典应该包括什么?

至少包括:字段名、说明、数据类型、允许的取值或格式、是否必填、来源和负责人。涉及个人信息的,还要标出敏感级别。

数据字典和数据目录有什么区别?

数据字典描述一个数据集内部的字段;数据目录是整个组织里很多数据集的清单,通常带搜索、血缘和负责人。

数据字典就是表结构吗?

不是。表结构是数据库强制执行的技术结构(名字和类型);数据字典在此之上用通俗语言补充含义、规则和归属。

数据字典怎么保持更新?

把它纳入变更流程:没有字典条目的新事件、新字段不上线,并定期复查已经收不到数据的字段。

在你自己的网站上看这个数字

加一行脚本就能开始,网站和 App 都能接,几分钟内就能看到第一批报表。

看清数据,找到增长。

每一次点击,都有数据依据。装好一行代码,1 分钟看到第一批数据。

无需信用卡 · 统计与客服都有免费版 · 统计无 Cookie