魔域数据库命名规范旨在通过统一的命名规则提升数据管理效率,降低团队协作成本。本规范从命名原则、结构拆分、常见错误三个维度建立标准,覆盖名称生成、版本控制、权限管理全流程,特别强调可读性、一致性、可追溯性三大核心要素。
一、基础命名原则
命名主体标识
所有数据库表名需以"域"开头,如"域_角色信息表"。域后缀采用"_"分隔符连接功能模块,如"域_战斗日志表"。
数据类型约束
数值类字段命名需包含后缀"num",如"角色生命值num"。文本类字段使用"txt"标识,如"角色描述txt"。日期字段统一为"date"后缀。
版本控制机制
正式环境表名需包含日期标识,如"域_战斗日志_20231001"。测试环境采用"test_"前缀,如"test_域_战斗日志"。
二、结构化命名体系
四层嵌套结构
完整命名链包含:域层(Domain)→业务层(Business)→功能层(Function)→实体层(Entity)
示例:Domain_战斗域_BattleFunction_伤害计算Entity
命名长度控制
基础表名不超过50字符,复合名称总长度不超过80字符。特殊符号仅限下划线和英文数字。
权限隔离规则
管理员表名添加"admin_"前缀,如"admin_域_权限表"。公开表名使用"public_"标识,如"public_日志表"。
三、常见错误规避

避免拼音缩写
禁用"ryxx"(角色信息)等无意义缩写,优先使用完整业务术语。
防止命名歧义
"战斗记录"与"战斗日志"存在功能重叠风险,需通过后缀区分:"战斗记录log"和"战斗日志txt"。
时间格式规范
日期字段统一采用"YYYYMMDD"格式,避免"2023.10.01"等不标准写法。
四、工具与流程
命名生成器
推荐使用"DBNameGen"工具,支持自动生成符合规范的名称,设置参数包括:
业务模块(战斗/经济/社交)
数据类型(表/视图/存储过程)
环境标识(prod/test/staging)
审查机制
建立双人复核制度,命名申请需同时提交:
命名申请单(含功能说明)
命名合规性报告
环境部署说明
版本追溯
所有命名变更需记录在"DBChangeLog"中,包含:
修改日期
原名称
新名称
修改原因
魔域数据库命名规范通过结构化命名体系实现三大目标:首先建立统一的命名基础,确保跨模块协作效率;其次通过版本控制与权限隔离保障数据安全;最后借助工具化流程降低人为错误率。该规范特别强调命名可读性优先,要求开发者将80%的命名资源用于业务描述而非技术符号。
相关问答:
Q1:如何处理跨模块共享表命名冲突?
A:采用"域_业务_功能_共享表"结构,共享属性通过字段前缀标识,如"战斗域_通用_战斗伤害系数"。
Q2:测试环境表名是否需要保留生产环境格式?
A:测试表名需添加"test_"前缀,同时保留完整业务标识,如"test_域_战斗日志表"。
Q3:命名长度超过限制如何处理?
A:优先精简业务描述,必要时拆分表结构,如将"域_复杂战斗记录"改为"域_战斗_记录表"。
Q4:如何管理历史遗留命名?
A:建立"旧名对照表",记录每个旧名称对应的新规范名称及迁移时间节点。
Q5:命名变更是否需要代码级审查?
A:强制要求开发者提交命名变更PR,并触发自动化合规检测,未通过者禁止合并。