MySQL数据库开发规范1.3

平安金融科技数据库（MySQL）开发规范

作者: 简朝阳

Last Updated: 25/02/14 19:30:18

历史修订记录：

版本修订人修订时间修订内容

1.0

1.1 李海军2013-03-11 增加部分说明及修改

1.2 李海军2013-07-29 增加连接池使用说明和memory引擎的控制

1.3 李海军2014-02-25 增加了char类型，修改了timestamp的使用场合。

说明

⇧本规范包含平安金融科技使用MySQL 数据库时所需要遵循的所有对象设计（数据库，表，字段），所需要遵循的命名，对象设计，SQL 编写等的规范约定。

⇧所有内容都为必须严格执行的项目，执行过程中有任何疑问，请联系DBA Team 取得帮助。

概述

⇧禁止明文传播数据库帐号和密码。

⇧禁止开发工程师通过应用帐号登录生产数据库。

⇧禁止应用在服务器安装MySQL客户端（可以安装开发包）。

⇧禁止开发人员在SQL中添加Hint，Hint只能由DBA审核后添加。

⇧禁止使用悲观锁定，即读锁select … for update。

⇧禁止在开发代码中使用DDL语句，比如truncate，alter table … 等。

⇧禁止DML语句的where条件中包含恒真条件（如：1=1）。

1. 命名规范

总则

⇧数据库对象名仅可包含小写英文字母、数字、下划线（_）三类字符，并以英文字母开头。

⇧数据库对象命名禁止使用MySQL保留字。

⇧多个单词之间用下划线（_）分隔。

⇧对象名称长度若超过限制，则使用简写/缩写命名。

1.1. 数据库命名

⇧数据库以"db_"前缀+ "站点名_"前缀及其所服务的应用名称命名。

1.2. 表命名

⇧所属同一模块的表必须以模块名作为前缀命名。

⇧历史数据表在原表基础上增加"_his"后缀命名。

1.3. 字段命名

⇧布尔意义的字段以"_flag"作为后缀，前接动词。如：表示逻辑删除意义的字段可命名为delete_flag。

⇧各表间相同意义的字段（如：作为连接关系的引用字段）使用相同的字段名。

1.4. 索引命名

⇧唯一索引以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.order_id被order_item引用；

⇧order_item 表中与之对应的字段命名必须为：order_id

2. 对象设计规范

总则

⇧所有表、字段必须添加能够清楚表示其含义的注释。状态类字段的注释中必须明确列出各状态值的说明。

⇧MySQL数据库中仅可以使用下文提及的数据类型。

2.1. 数据类型

2.1.1. 数值类型

⇧DECIMAL(M,D)

当表示定点小数的情况下使用该类型，禁止使用浮点类型，会带来不精确。定点数在MySQL内部以字符串形式存储，比浮点数更精确，适合用来表示货币等精度高的数据。

⇧INT系列

所有整数类型字段使用INT（TINYINT、SMALLINT、MEDIUMINT、INT、BIGINT）,根据所存放的数据大小选择合适的子类型，且所有INT类型都不使用长度限制。

2.1.2. 字符串类型

⇧VARCHAR

所有可变长度的字段均使用VARCHAR类型，对于有限类别的字段（如性别、状态等），均建议使用

VARCHAR类型存储能明显表现其意义的字符串。

⇧TEXT系列

仅当需存储的字节数可能超过20000时，使用TEXT系列类型（TEXT、MEDIUMTEXT、

LONGTEXT）。并和原表进行分拆，与原表主键组成新表存储，且每个表只允许有一个TEXT系列类型字段。

⇧CHAR

仅当字段确定为定长，且将来不会修改长度时，使用CHAR类型。上线以后不允许修改字段类型。谨慎使用

2.1.

3. 时间类型

⇧DATE

只需要精确到天的字段使用DATE类型。精确到"天"的取当前时期的操作使用CURDATE()函数实现。-DATETIME

需要精确到时间（时、分、秒）的字段使用DATETIME类型。精确到"秒"的取当前时间的操作使用

NOW()函数实现。取值范围：'1000-01-01'到'9999-12-31'

TIMESTAMP

该类型仅允许raw_update_time字段使用，其它字段不允许使用该类型。取值范围：'1970-01-01

00:00:00'到'2037-01-01 00:00:00'

2.2. 表设计

⇧必含字段

id INT：主键使用MySQL的自增类型

raw_add_time DATETIME：创建日期（大字段拆分表除外），必须使用数据库时间（用now()生成）

raw_update_time TIMESTAMP：修改日期（大字段拆分表除外, 但内容变化必须修改主表的

update_time字段），由数据库自动变更，应用不操作此字段

以上3个字段都必须是没有任何商业意义的与业务无关的字段，不允许赋予任何商业意义

⇧作为表间连接关系的字段，数据类型必须保持严格一致，避免索引无法正常使用。

⇧附属表拆分后，附属表关联字段使用主表主键字段，且附属表须有独立主键（大字段拆分的表不需要单独的主键）

⇧存在过期概念的表，在其设计之初就必须有过期机制，且有明确的过期时间。过期数据必须迁移至历史表中。

⇧不再使用的表，必须通知DBA予以更名归档。

⇧线上表中若有不再使用的字段，为保证数据完整，禁止删除，而是进行更名归档，名称统一增加

"droped_"前缀