Mysql开发规范

关注

原创最新推荐文章于 2026-05-13 09:33:36 发布 855 阅读 AI 写同款· GEO 优化 ›

MYSQL 数据库开发规范 如果数据库系统设计不合理，不仅会增加客户端和服务器端程序的编程和维护的难度，而且还会影响系统实际运行的性能。中，存在过期概念的表，在其设计之初就必须有过期机制，且有明确的过期时间。表中除主键以外还存在唯一约束的，必须在数据库中创建唯一约束，一般通过创建唯一索引实现。中，仅可以使用下文提及的数据类型，所有表、字段必须添加能够清楚表示其含义的。依据业务逻辑的需要，在表结构设计之初建立唯一索引，避免后期的重复数据清除。严格要求使用正确类型的变量，确定表中每个字段的数据类型，杜绝隐式类型转换。阅读详情

开发规范

对象命名

命名规范的对象，是指数据库SCHEMA、表TABLE、字段COLUMN、索引INDEX、约束CONSTRAINTS等

【强制】凡是需要命名的对象，其标识符不能超过30个字符
【强制】名称必须以英文字母开头，不得以 _(下划线) 作为起始和终止字母
【强制】所有名称的字符范围为：a-z, 0-9 和_(下划线)，禁用大写、特殊符号、保留字、汉字和空格
【强制】所有名称统一使用小写，并采用下划线 _ 分割
【强制】名称应该清晰明了，能够准确表达事物的含义，最好可读，遵循“见名知意”的原则
【建议】数据库账户，一定要做到权限划分明确，读写帐号分离，并且有辨识度，能区分具体业务

dba内部账户以dba_开头；
应用账户以user_开头：如user_upc、user_upc_r 分别代表读写、只读账号；
读写分离不提供额外账户，统一使用应用账户；
所有账户必须都在主库创建，只读查询只能从非候选上操作；

【建议】若按日期时间分表，必须符合 _YYYY[MM][DD] 格式
【建议】若按HASH进行分表，库表名后缀使用十进制数，下标从0开始、下划线分隔、需要补0、每个库的表名相同，比如：

db_00{table_00 - table_31}
db_01{table_00 - table_31}
db_02{table_00 - table_31}
db_03{table_00 - table_31}

【建议】备份用的库、表名须以bak为前缀，以日期yyyymmdd为后缀，比如 bak_order_20160425，便于查找和知道有效期
【建议】临时用的库、表名须以tmp为前缀，以日期yyyymmdd为后缀，比如 tmp_order_20160425，正常业务用到的临时表、中间表，前后缀尽量不要包含 tmp 以免造成歧义

库表设计

【强制】生产/UAT环境建库建表，请参考《mysql建库建表规范》
【强制】单实例的库数量不得超过20个，再多考虑拆分实例
【强制】单库的表数量不得超过100个，再多考虑拆分库
【强制】单表的字段数量不得超过30个，再多考虑垂直分表
【强制】单表的数据量控制在2000万或数据容量超过10G以内，否则考虑归档或分库分表
【强制】单表的分表数量不得超过256个
【建议】如无特殊需求，必须使用Innodb存储引擎

支持事务、行级锁、并发性能更好、CPU及内存缓存页优化使得资源利用率更高

【建议】如无特殊需求，必须使用utf8mb4字符集，排序规则使用utf8mb4_unicode_ci

万国码，无需转码，无乱码风险，节省空间，utf8mb4更可保存emoj表情(utf8不行)

【强制】新建的库表必须添加注释

N年后鬼知道这个r1,r2,r3字段是干嘛的

【建议】表都必须要显式指定主键，推荐自增id主键

1. 主键递增，数据行写入可以提高插入性能，可避免page分裂，减少表碎片提升空间和内存的使用
2. 主键要选择较短的数据类型，Innodb引擎普通索引都会保存主键的值，较短的数据类型可以有效的减少索引的磁盘空间，提高索引的缓存效率
3. 无主键的表删除，在row模式的主从架构，会导致备库夯住

【强制】禁止使用外键，外键功能请在应用层实现

外键使得表之间相互耦合，影响update/delete等SQL性能，有可能造成死锁，高并发情况下容易成为数据库瓶颈

【建议】日志类型的表必须提前规划轮转机制或者选择定期清理/归档或者选择合适的db，比如hbase/mongodb
【建议】建议将大字段，访问频度低的字段拆分到单独的表中存储，分离冷热数据
【强制】数据库中不允许存储明文密码
【建议】如果对时间精度有要求，建表的时候请注意一下时间精度，比如 timestamp 与 timestamp(3)；
【强制】无特殊需求，严禁使用分区表

字段设计

【强制】各表之间相同意义的字段必须同名
【建议】字段类型在满足需求条件下越小越好，使用unsigned存储非负整数，实际使用时候存储负数场景不多
【建议】数值类型优于字符类型，所以能使用数值类型的尽量不要使用字符类型
【强制】小数类型应选择精确度高的decimal等类型，禁止使用float和double

浮点数（float和double）在存储的时候，超过指定精度后会四舍五入，这是浮点数特有的问题。因此在精度要求比较高的应用中（比如货币）要使用定点数（decimal）而不是浮点数（float和double）来保存数据。

【建议】合理选择char、varchar、text等字符串类型

1.  对于长度基本固定的小字符类型，如果该列恰好更新又特别频繁，适合char
2. 不固定长度的大字符类型，应选择varchar类型，varchar（N），N代表的是字符数，N尽可能的小
3. varchar虽然存储变长字符串，UTF8最多能存21844个汉字，或65532个英文

【强制】禁止使用BLOB和TEXT字段。如要使用，尽可能把text/blob拆到独立的表中，用PK与主表关联；
【强制】禁止在数据库中存储大文件，例如图片、文件等；
【建议】合理选择bit、int、tinyint、decimal等数字类型

使用tinyint来代替enum和boolean
使用Decimal代替float/double存储精确浮点数
建议使用 UNSIGNED 存储非负数值
int使用固定4个字节存储，int(11)与int(4)只是显示宽度的区别
列禁止使用bit类型，请用tinyint类型替代。bit类型加了索引可能会导致sql结果不准。

【建议】合理选择timestamp与datetime等时间类型

timestamp可以在insert/update行时，自动更新时间字段；
列为timestamp类型，必须指定默认值，要么current_timestamp，要么'1970-01-02 01:01:01'，不要设置为''或0；
DATETIME和TIMESTAMP都可用来表示YYYY-MM-DD HH:MM:SS类型的日期。两种都保存日期和时间信息，毫秒部分最高精确度都是6位数。建议使用TIMESTAMP(3)。
A. TIMESTAMP占用4字节，DATETIME占用8字节，当保存毫秒部分时两者都使用额外的空间 （1-3 字节）。
B. TIMESTAMP的取值范围比DATETIME小得多，不适合存放比较久远的日期。TIMESTAMP只能存储从 '1970-01-01 00:00:01.000000' 到 '2038-01-19 03:14:07.999999' 之间的时间。而DATETIME允许存储从 '1000-01-01 00:00:00.000000' 到 '9999-12-31 23:59:59.999999' 之间的时间。
C. TIMESTAMP的插入和查询受时区的影响。如果记录的日期需要让不同时区的人使用，最好使用 TIMESTAMP。

【建议】如无特殊需要，字段建议使用NOT NULL属性，可用默认值代替NULL。如果是索引字段，一定要定义为not null。因为null值会影响cordinate统计和优化器对索引的选择
【强制】禁止在列上配置字符集
【建议】使用unsigned int存储IPv4，不要使用char(15)

ip转int使用 INET_ATON 函数，int转ip使用 INET_NTOA 函数，比如：select inet_aton('192.168.1.1'),inet_ntoa(3232235777);

【建议】使用varchar(20)存储手机号，不要使用整数

1. 涉及到国家代号，可能出现+/-/()等字符，例如+86
2. 手机号不会用来做数学运算
3. varchar可以模糊查询，例如 like '138%'

索引设计

【强制】单表索引的数量不得超过5个，否则增加维护负担、降低写入性能、占用更多空间
【建议】建立的索引能覆盖80%主要的查询，不求全，解决问题的主要矛盾
【建议】主键应选择不重复、长度小的列，没有特殊要求，使用自增id作为主键
【建议】自增列的名字固定为id，指定unsigned，类型2选1（int/bigint），自增列的值必须从1开始
【建议】主键禁止使用字符类型，禁止使用联合主键，推荐使用唯一索引来替代
【建议】业务上具有唯一特性的字段，必须创建唯一索引
【建议】不建议在频繁更新的字段上建立索引
【建议】索引尽量建在选择性高的列上，不在低基数列上建立索引，例如性别、类型

选择性的计算方式为: select count(distinct(col_name)) / count(*) from tb_name
如果结果小于0.2，则不建议在此列上创建索引，否则大概率会拖慢SQL执行

【建议】合理利用覆盖索引，联合索引，避免过多的单列索引，合理使用索引来避免排序和临时表的使用
【建议】对超过30个字符长度的列创建索引时，考虑使用前缀索引，比如 idx_cs_guid2 (f_cs_guid(26)) 表示截取前26个字符做索引，既可以提高查找效率，也可以节省空间

前缀索引的缺点是，如果在该列上 ORDER BY 或 GROUP BY 时无法使用索引，也不能把它们用作覆盖索引

【建议】blob列不能作为key
【建议】bit类型字段禁止单独加索引，或者做联合索引的第一列
【建议】尽量使用Btree索引，不要使用其它类型索引
【建议】DML和order by和group by字段要建立合适的索引

关于组合索引的几点建议

【强制】组合索引的字段数量不得超过5个

如果5个字段还不能极大缩小row范围，八成是设计有问题

【建议】组合索引 - 选择性高的永远在左边
【建议】组合索引 - 避免冗余索引，比如：(a,b,c)、(a,b)、(a)，后二者为冗余索引
【建议】组合索引的最左匹配原则：数据库引擎使用组合索引时，从左向右(并非where条件顺序)匹配，遇到范围查询(>、<、between、like)则会停止索引匹配，无法用到后续的索引列。where条件里面字段的顺序与索引顺序无关，优化器会自动调整顺序。

比如索引idx_a_b_c(a,b,c)，相当于创建了(a)、(a,b)、(a,b,c)三个索引，后二者为冗余索引：
where a=?                  用到(a)        ⑦where c=?           用不到
where b=? and a=?          用到(a,b)      ⑧where b=? and c=?   用不到
where a=? and c=?          用到(a)
where a>? and b=?          用到(a)
where a=? and b=? and c>?  用到(a,b,c)
where a=? and b>? and c=?  用到(a,b)

SQL设计

【强制】禁止使用游标、存储过程、视图、触发器、自定义函数、event

高并发大数据的互联网业务，架构设计思路是“解放数据库CPU，将计算转移到服务层”，并发量大的情况下，这些功能很可能将数据库拖死，业务逻辑放到服务层具备更好的扩展性，能够轻易实现“增机器就加性能”。数据库擅长存储与索引，涉及CPU计算的还是放到应用服务器上吧

【建议】建议将复杂的计算和逻辑操作放到程序端处理，而不是使用SQL语句处理，因为程序端方便扩容，数据库端扩容能力有限
【建议】数据结构设计时，可以适当设计冗余字段，减少查询的复杂度，提高查询的性能
【强制】禁止在数据库中存储大文件，例如图片、文件等，可以将大文件存储在对象存储系统，数据库中存储路径
【强制】禁止使用全文检索（Full Text Search），后续有这种需求使用搜索引擎处理
【强制】禁止在没有匹配索引的表上进行for update这类的操作，会锁定整个表
【强制】未经过DBA同意，禁止在程序端大批量更新或者删除数据，因为这样操作很可能造成复制的大量阻塞和延时，批量归档/删除，可以向dba发邮件提需求，由dba来处理
【强制】禁止在生产/线上环境进行代码逻辑或SQL语句性能的测试，这类操作应在开发或者测试环境进行
【建议】减少锁等待和竞争，避免大事务，使用短小事务
【建议】尽量避免使用子查询，使用join来代替
【强制】禁止使用order by rand()
【建议】多行数据需要做处理时，建议批量处理，而不是一条条来处理
【强制】单表的数据量控制在2000万或数据容量超过10G以内，否则考虑归档或分库分表
【强制】避免大表join，禁止3个大表的join，join字段类型需保持绝对一致，关联字段必须有索引
【建议】线上业务修改或删除数据，务必根据主键来实现
【建议】禁止使用 SELECT * ，必须明确指定列
【建议】insert必须指定字段，禁止使用 insert into xxx values()

指定字段插入，在表结构变更时，能保证对应用程序无影响

【建议】能确定返回结果只有一条时，使用 limit 1
【建议】避免隐式类型转换
【建议】禁止在where条件列上使用函数
【建议】限制使用like模糊匹配，禁止使用左模糊或者全模糊，%不要放首位
【建议】涉及到复杂sql时，务必先参考已有索引设计，先explain
【建议】考虑使用union all，少使用union，注意考虑去重
【建议】IN的内容尽量不超过200个
【建议】建议在每条查询语句后面加上Limit关键字，控制返回的数据量，防止不可控的返回大量的数据
【建议】禁止大批量的查询数据结果，如果需要返回大量数据，请使用分页的方式处理，遇到分页有大的offset查询，可以使用延迟关联来解决
【建议】分页优化

SELECT * FROM tel_record t1 INNER JOIN (SELECT id FROM tel_record WHERE qiye_id = xxx ORDER BY id DESC LIMIT 999900,100) t2 ON t1.f_id = t2.f_id;
程序端保留当前页的最小id、最大id（id是主键），降序情况下，每次提取下一页的数据时，id < min_id order by id desc limit 100; 上一页 id > max_id order by id desc limit 100

【建议】大表count是消耗资源的操作，甚至会拖慢整个库，查询性能问题无法解决的，应从产品设计上进行重构。例如当频繁需要count的查询，考虑使用汇总表；
【建议】数据库的隔离级别默认为READ-COMMITTED，如不能满足业务需求，可在session层面做相应调整（必须清楚相应的隔离级别带来的锁影响）
【建议】数据库默认的sql_mode为严格模式（STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION），在此模式下任何不支持的语法或者数据校验不合格的，都将直接返回错误
【建议】日志类数据不建议存储在MySQL上，优先考虑mongodb，如需要存储请找DBA评估使用压缩表存储
【建议】禁止使用ENUM，可使用TINYINT代替

增加新的ENUM值要做DDL操作；ENUM的内部实际存储就是整数而非字符串；

【建议】禁止使用OR条件，必须改为IN查询，并注意in的个数小于200

旧版本mysql的OR查询是不能命中索引的，即使能命中索引，为何要让数据库耗费更多的CPU帮助实施查询优化呢？ 补充：通常情况下，如果条件中有or，即使其中有条件带索引也不会使用，所以除非每个列都建立了索引，否则不建议使用OR。在多列OR中，建议用UNION ALL替换。

【建议】所有连接的SQL必须使用 join … on … 方式进行连接，而不允许直接通过普通的where条件关联方式。外连接的SQL语句,可以使用left join on的join方式，且所有外连接一律写成left join，而不要使用right join
【建议】避免使用否定条件。

例如，where 条件里面有<>、not in 、not exists的时候，即便是在这些判断字段上加有索引，也不会起作用。

【建议】有NULL值的字段查询

1. 不要使用count(列名)或者count(常量)来替代 count(*)，count(*)是SQL92定义的标准统计行数的语法，跟数据库无关，跟null和非null无关。count(*)会统计值为null的行，而count(列名)不会统计此列为null的行。
2. count(distinct col)计算该列除null之外不重复的行数。count(distinct col1, col2)，如果其中一列全为null，那么即使另一列有不同的值，也返回0
3. 当某一列的值全为null，count(col)的返回结果为0，但sum(col)的返回结果为null，因此使用sum()时需要注意空指针异常的问题。可以使用ISNULL()来判断是否为NULL值： SELECT IF(ISNULL(SUM(g)), 0, SUM(g)) FROM table;

【建议】SQL合并，主要是指的DML时候多个value合并，减少和数据库交互

开发行为规范

【强制】推广活动或上线新功能必须提前通知DBA进行流量评估
【强制】禁止在线上环境申请个人账号，只能申请业务使用的账号
【强制】超过10w条的大批量更新，如修复数据、导入导出，避开高峰期，并通知DBA。可直接执行的sql由DBA操作
【建议】及时处理已下线业务的SQL
【建议】复杂sql要主动上报DBA评估，比如多表join/count/group by等
【建议】重要项目的数据库方案选型和设计必须提前通知DBA参与
【建议】对单表的多次alter操作必须合并为一次操作
【强制】分库分表情况下，确保所有库表字段顺序一致
【强制】所有数据库账号必须在主库创建
【强制】禁止在数据库中存放业务逻辑SQL
【建议】对特别重要的库表，提前与DBA沟通确定维护和备份优先级
【建议】维护脚本须部署在关联实例机器上，切勿乱放，比如归档，拉数据等
【建议】线上大批量delete和update，为了降低锁影响和减少从库延迟，必须批量执行，思路参考pt-archiver
【强制】线上业务不允许申请truncate、drop权限，如果需要删除表，请提交工单并由dba操作
【建议】线上不允许建立业务相关数据库JOB，业务逻辑在代码层实现
【建议】线上不允许使用长事务，慎用set autocommit=0或者begin，推荐使用set autocommit=1，超时5秒的事务，DBA JOB会自动kill