缩写字典:统一 AMT/QTY/CNT/RATE
字段缩写集中维护成字典:AMT 金额、QTY 数量、CNT 计数、RATE 比率、DT 分区日期、SK 代理键。新增缩写要先登记再使用,不允许个人随手缩写。字典是命名评审的输入物:评审时先查字典,再判断字段名是否可读,避免同一个缩写在不同的表里指向不同的含义。
基本信息
| 维护方式 | 集中字典(文档或元数据表) |
|---|---|
| 常用缩写 | AMT、QTY、CNT、RATE、DT、SK |
| 新增流程 | 先登记后使用 |
| 使用场景 | 建表评审与字段检索 |
| 禁止 | 个人自创缩写 |
典型使用场景
- 新建表:命名前先查字典,没有对应缩写就先提交登记
- 评审:把字典作为必备输入,逐字段核对缩写含义
- 新人交付:字典降低理解成本,不必逐个追问原作者
- 存量治理:扫出字典外的缩写并逐步收敛,减少同义异名
- 元数据化:把字典落成表,评审与自动化检查都能直接查询
字典落地
字典落地
-- 把字典落成可查的表,评审与自动检查都能用
CREATE TABLE meta_abbr_dict (
abbr STRING COMMENT '缩写',
full_word STRING COMMENT '全称',
note STRING COMMENT '说明与示例'
) COMMENT '字段缩写字典';
INSERT INTO meta_abbr_dict VALUES
('AMT', 'amount', '金额,如 pay_amt'),
('QTY', 'quantity', '数量,如 item_qty'),
('CNT', 'count', '计数,如 order_cnt'),
('RATE', 'rate', '比率,如 refund_rate');缩写字典示例
| 缩写 | 含义 | 示例字段 |
|---|---|---|
| AMT | 金额 | pay_amt |
| QTY | 数量 | item_qty |
| CNT | 计数 | order_cnt |
| RATE | 比率 | refund_rate |
| SK | 代理键 | customer_sk |
缩写字典是评审的输入物:新字段命名先查字典再建表,成本远低于事后统一改造存量表和下游脚本。
同一个缩写在不同的表里含义不同(例如 AMT 既指金额又指笔数),下游按字段名推断含义时会直接取错列,且不会有任何报错。
缩写只压缩「重复出现的通用词」:金额、数量、比率这类高频词用缩写收益最大;业务实体名(退款、履约)不要缩写,它们本来就需要被读出来,缩了反而更难理解。
评审时逐个字段问一句「这个名字半年后还能看懂吗」,比只看是否符合格式规范更能筛出问题命名;格式检查可以自动化,可读性判断仍然要人来做。