MySQL数据库开发规范.docx
《MySQL数据库开发规范.docx》由会员分享，可在线阅读，更多相关《MySQL数据库开发规范.docx（9页珍藏版）》请在冰点文库上搜索。
MySQL数据库开发规范
平安金融科技数据库（MySQL）开发规范
作者:
简朝阳
LastUpdated:
25/02/1419:
30:
18
历史修订记录：
版本
修订人
修订时间
修订内容
李海军
2013-03-11
增加部分说明及修改
李海军
2013-07-29
增加连接池使用说明和memory引擎的控制
李海军
2014-02-25
增加了char类型，修改了timestamp的使用场合。
说明
本规范包含平安金融科技使用MySQL数据库时所需要遵循的所有对象设计（数据库，表，字段），所需要遵循的命名，对象设计，SQL编写等的规范约定。
所有内容都为必须严格执行的项目，执行过程中有任何疑问，请联系DBATeam取得帮助。
概述
禁止明文传播数据库帐号和密码。
禁止开发工程师通过应用帐号登录生产数据库。
禁止应用在服务器安装MySQL客户端（可以安装开发包）。
禁止开发人员在SQL中添加Hint，Hint只能由DBA审核后添加。
禁止使用悲观锁定，即读锁select…forupdate。
禁止在开发代码中使用DDL语句，比如truncate，altertable…等。
禁止DML语句的where条件中包含恒真条件（如：
1=1）。
1.命名规范
总则
数据库对象名仅可包含小写英文字母、数字、下划线（_）三类字符，并以英文字母开头。
数据库对象命名禁止使用MySQL保留字。
多个单词之间用下划线（_）分隔。
对象名称长度若超过限制，则使用简写/缩写命名。
.数据库命名
数据库以"db_"前缀+"站点名_"前缀及其所服务的应用名称命名。
.表命名
所属同一模块的表必须以模块名作为前缀命名。
历史数据表在原表基础上增加"_his"后缀命名。
.字段命名
布尔意义的字段以"_flag"作为后缀，前接动词。
如：
表示逻辑删除意义的字段可命名为delete_flag。
各表间相同意义的字段（如：
作为连接关系的引用字段）使用相同的字段名。
.索引命名
唯一索引以uk_tablename_columnnames方式命名
普通索引以idx_tablename_columnnames方式命名
组合索引以idx_tablename_column1_column2...方式命名
示例
站点名：
maymay
模块名：
order；
数据表：
item；
字段组成：
order_item_id,add_time,raw_update_time,c1,c2,c3,c4,c5
标准数据库名：
db_maymay_order；
标准数据表名：
order_item；
历史数据表名：
order_item_his；
索引需求：
c1唯一，c2和c3组合索引：
uk_order_item_c1,idx_order_item_c2_c3
字段实际意义：
是否已删除；
标准字段名：
delete_flag；
字段被order_item引用；
order_item表中与之对应的字段命名必须为：
order_id
2.对象设计规范
总则
所有表、字段必须添加能够清楚表示其含义的注释。
状态类字段的注释中必须明确列出各状态值的说明。
MySQL数据库中仅可以使用下文提及的数据类型。
.数据类型
数值类型
DECIMAL（M,D）
当表示定点小数的情况下使用该类型，禁止使用浮点类型，会带来不精确。
定点数在MySQL内部以字符串形式存储，比浮点数更精确，适合用来表示货币等精度高的数据。
INT系列
所有整数类型字段使用INT（TINYINT、SMALLINT、MEDIUMINT、INT、BIGINT）,根据所存放的数据大小选择合适的子类型，且所有INT类型都不使用长度限制。
字符串类型
VARCHAR
所有可变长度的字段均使用VARCHAR类型，对于有限类别的字段（如性别、状态等），均建议使用VARCHAR类型存储能明显表现其意义的字符串。
TEXT系列
仅当需存储的字节数可能超过20000时，使用TEXT系列类型（TEXT、MEDIUMTEXT、LONGTEXT）。
并和原表进行分拆，与原表主键组成新表存储，且每个表只允许有一个TEXT系列类型字段。
CHAR
仅当字段确定为定长，且将来不会修改长度时，使用CHAR类型。
上线以后不允许修改字段类型。
谨慎使用
时间类型
DATE
只需要精确到天的字段使用DATE类型。
精确到"天"的取当前时期的操作使用CURDATE（）函数实现。
-DATETIME
需要精确到时间（时、分、秒）的字段使用DATETIME类型。
精确到"秒"的取当前时间的操作使用NOW（）函数实现。
取值范围：
'1000-01-01'到'9999-12-31'
TIMESTAMP
该类型仅允许raw_update_time字段使用，其它字段不允许使用该类型。
取值范围：
'1970-01-0100:
00:
00'到'2037-01-0100:
00:
00'
.表设计
必含字段
idINT：
主键使用MySQL的自增类型
raw_add_timeDATETIME：
创建日期（大字段拆分表除外），必须使用数据库时间（用now（）生成）
raw_update_timeTIMESTAMP：
修改日期（大字段拆分表除外,但内容变化必须修改主表的update_time字段），由数据库自动变更，应用不操作此字段
以上3个字段都必须是没有任何商业意义的与业务无关的字段，不允许赋予任何商业意义
作为表间连接关系的字段，数据类型必须保持严格一致，避免索引无法正常使用。
附属表拆分后，附属表关联字段使用主表主键字段，且附属表须有独立主键（大字段拆分的表不需要单独的主键）
存在过期概念的表，在其设计之初就必须有过期机制，且有明确的过期时间。
过期数据必须迁移至历史表中。
不再使用的表，必须通知DBA予以更名归档。
线上表中若有不再使用的字段，为保证数据完整，禁止删除，而是进行更名归档，名称统一增加"droped_"前缀
.约束使用
主键
主键不能包含业务含义。
主键在任何情况下不允许被更新。
唯一约束
除主键外，需存在唯一性约束的，可通过创建以"uk_"为前缀的唯一索引实现。
外键
任何情况不在数据库创建外键约束，外键规则由应用控制。
非空列
所有非空列须在建表之初明确标识"NOTNULL",上线之后，不允许再变更。
存储过程、触发器、视图、计划任务
禁止任何业务逻辑通过封装在数据库中的procedure/function/trigger实现。
禁止应用程序使用view。
禁止业务逻辑使用数据库的计划任务。
3.SQL编写规范
.绑定变量与替代变量
原则
所有Query的Where条件中的变量，都需要使用绑定变量来实现，此要求并不完全是基于性能的考虑，更多是基于安全方面的考虑。
.数据类型转换
原则
避免因数据类型转换导致执行计划有误。
说明
where条件中的过滤字段如需转换类型，只可转换过滤值，不可转换被过滤字段。
表连接操作中，作为连接条件的字段的数据类型严格一致。
如果表连接字段数据类型不一致，在SQL中用显示用类型转换，具体情况咨询DBA。
示例
正确用法1：
selectcol1,col2fromtbl1,tbl2
where=;
其中""与""数据类型严格一致。
正确用法2：
selectcol1，col2fromtbl
wheregmt_create=str_to_date（'00:
00:
00','%Y%m%d%H:
%i:
%s'）;
"count（…）"使用
除非是明确目的是统计某个字段上值不为空的记录的数目，否者只允许之用count（*）,而不允许使用count（column_name）或者count
（1）。
."select*from…"使用
原则
为避免查询中无用字段参与排序操作而导致的性能降低及潜在的安全隐患。
禁止使用"select*from…"。
说明
任何情况都要明确列出查询需要返回的字段，禁止使用select*返回所有字段。
."insertintotablenamevalues（）"使用
原则
为避免增加或删除字段带来的SQL报错。
禁止使用省略字段名的insertinto语句。
说明
任何情况都要明确列出需要写入的字段名称。
.表连接
原则
规范连接语法以方便SQL脚本的阅读及提升连接操作性能。
说明
非外连接查询中，连接表在"from"子句中列出，并以逗号分隔；连接条件在"where"子句中列出，而不允许使用join…on方式实现join。
外连接查询中，可使用"leftjoin…on"语法；外连接一律使用"leftjoin"表示。
可以改写为连接的子查询禁止使用子查询方式，而应改写为连接方式。
示例
规范
selectcol1,col2fromtbl1,tbl2where=;
selectcol1,col2fromtbl1leftouterjointbl2on=;
selectcol1,col2fromtbl1leftouterjointbl2on=;
selectcol1fromtbl1,tbl2where=;
selectcol1fromtbl1leftjointbl2on=whereisnull;
非规范：
selectcol1,col2fromtbl1jointbl2on=;
selectcol1fromtbl1wherecol2in（selectcol3fromtbl2）;
selectcol1fromtbl1wherecol2notin（selectcol3fromtbl2）;
.分页查询
说明
分页查询必须带有唯一的排序条件，除非业务逻辑明确要求随机展现数据。
对于多表连接的分页语句，如果过滤条件在单个表上，则先分页，后连接。
见示例
通过limit进行分页操作的时候，limit参数为start（起始记录数），page_offset（每页记录数）。
示例
规范化用法：
select,，,
from（select,
fromtbl1twhere=exp
orderbylimitstart,page_offerset）a,tbl2b
where=;?
4.数据库级别规范
连接池的使用
应用程序连接数据库必须使用连接池。
存储引擎的选择
尽量不要使用memory引擎的表，除非能把握好对内存表的控制。
升级会员 