建表规约
1. 【强制】表达是与否概念的字段,必须使用 is_xxx 的方式命名,
数据类型是 unsignedtinyint( 1 表示是,0 表示否),此规则同样
适用于 odps 建表。
说明:任何字段如果为非负数,必须是 unsigned。
2. 【强制】表名、字段名必须使用小写字母或数字;禁止出现数字开
头,禁止两个下划线中间只出现数字。数据库字段名的修改代价很
大,因为无法进行预发布,所以字段名称需要慎重考虑。
正例:getter_admin,task_config,level3_name
反例:GetterAdmin,taskConfig,level_3_name
3. 【强制】表名不使用复数名词。
说明:表名应该仅仅表示表里面的实体内容,不应该表示实体数量,对
应于 DO 类名也是单数形式,符合表达习惯。
4. 【强制】禁用保留字,如 desc、range、match、delayed 等,请参
考 MySQL 官方保留字。
5. 【强制】唯一索引名为 uk_字段名;普通索引名则为 idx_字段名。
说明:uk_ 即 unique key;idx_ 即 index 的简称。
6. 【强制】小数类型为 decimal,禁止使用 float 和 double。
说明:float 和 double 在存储的时候,存在精度损失的问题,很可能在
值的比较时,得到不正确的结果。如果存储的数据范围超过 decimal 的
范围,建议将数据拆成整数和小数分开存储。
7. 【强制】如果存储的字符串长度几乎相等,使用 char 定长字符串
类型。
8. 【强制】varchar 是可变长字符串,不预先分配存储空间,长度不
要超过 5000,如果存储长度大于此值,定义字段类型为 text,独
立出来一张表,用主键来对应,避免影响其它字段索引效率。
9. 【强制】表必备三字段:id, gmt_create, gmt_modified。
说明:其中 id 必为主键,类型为 unsigned bigint、单表时自增、步
长为 1。gmt_create,gmt_modified 的类型均为 date_time 类型。
正例:
使用 mysql 数据库的自动添加新增和自动更新时间是比较好的做法
ALTER TABLE `table_name` ADD COLUMN `gmt_create` datetime NULL
DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间' ;
ALTER TABLE `table_name` ADD COLUMN ` gmt_modified ` timestamp
NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
COMMENT '更新时间' ;
10. 【推荐】表的命名最好是加上“大类_业务名称_表的作用”。