MySQL 设计与开发规范

电玩女神 2023-10-06 20:03 67阅读 0赞

#### 阅读目录 ####

*  规范背景与目的
 *  设计规范
 *   *  数据库设计
     *  库名
     *  表结构
     *  列数据类型优化
     *  索引设计
     *  分库分表、分区表
     *  字符集
     *  一个规范的建表语句示例
 *  SQL 编写
 *   *  DML 语句
     *  多表连接
     *  事务
     *  排序和分组
     *  线上禁止使用的 SQL 语句

## 规范背景与目的 ##

本规范旨在帮助或指导 `RD、QA、OP` 等技术人员做出适合线上业务的数据库设计。在数据库变更和处理流程、数据库表设计、SQL编写等方面予以规范，从而为公司业务系统稳定、健康地运行提供保障。

## 设计规范 ##

### 数据库设计 ###

以下所有规范会按照`【高危】、【强制】、【建议】`三个级别进行标注，遵守优先级从高到低。

### 库名 ###

【强制】库的名称必须控制在32个字符以内，相关模块的表名与表名之间尽量体现`join`的关系，如`user`表和`user_login`表。

【强制】库的名称格式：业务系统名称\_子系统名，同一模块使用的库名尽量使用统一前缀。

【强制】一般分库名称命名格式是库通配名\_编号，编号从0开始递增，比如`wenda_001`以时间进行分库的名称格式是“库通配名\_时间”。

【强制】创建数据库时必须显式指定字符集，并且字符集只能是utf8或者utf8mb4。创建数据库SQL举例：`create database db1 default character set utf8;`

### 表结构 ###

【强制】表必须有主键，且设置`id`为自增主键

--------------------

【强制】表禁止使用外键，如果要保证完整下，应由程序端实现，外键使表之间相互耦合，影响 \`update、delete\` 等性能，有可能造成死锁，高并发环境下容易导致数据库性能瓶颈。

--------------------

【强制】表和列的名称必须控制在32个字符以内，表名只能使用字母、数字和下划线，一律小写。如表名过长可以采用缩写等方式

--------------------

【强制】创建表时必须显式指定字符集为 \`utf8\` 或 \`utf8mb4\`

--------------------

【强制】创建表时必须显式指定表存储引擎类型，如无特殊需求，一律为 \`InnoDB\`。当需要使用除 \`InnoDB/MyISAM/Memory\`以外的存储引擎时，必须通过DBA审核才能在生产环境中使用。 因为\`Innodb\`表支持事务、行锁、宕机恢复、MVCC等关系型数据库重要特性，为业界使用最多的MySQL存储引擎。而这是其他大多数存储引擎不具备的，因此首推\`InnoDB\`

--------------------

【强制】建表必须有\`comment\`，表级别和字段级别都要有\`comment\`

--------------------

【建议】建表时关于主键： (1)强制要求主键为 \`id\`，类型为 \`int\` 或 \`bigint\`（为了以后延展性，这里要求新建表统一为 \`bigint\`），且为 \`auto\_increment\` (2)标识表里每一行主体的字段不要设为主键，建议设为其他字段如 \`user\_id，order\_id\` 等，并建立\`unique key\`索引。因为如果设为主键且主键值为随机插入，则会导致\`innodb\`内部\`page\`分裂和大量随机I/O，性能下降

--------------------

【建议】核心表（如用户表，金钱相关的表）必须有行数据的创建时间字段 \`create\_time\` 和最后更新时间字段 \`update\_time\`，便于查问题

--------------------

【建议】表中所有字段必须都是 \`NOT NULL default \`默认值 属性，业务可以根据需要定义\`DEFAULT\`值。因为使用 \`NULL\` 值会存在每一行都会占用额外存储空间、数据迁移容易出错、聚合函数计算结果偏差以及索引失效等问题

--------------------

【建议】建议对表里的 \`blob、text\` 等大字段，垂直拆分到其他表里，仅在需要读这些对象的时候才去\`select\`

--------------------

【建议】反范式设计：把经常需要 \`join\` 查询的字段，在其他表里冗余一份。如\`user\_name\`属性在\`user\_account，user\_login\_log\`等表里冗余一份，减少\`join\`查询

--------------------

【强制】中间表用于保留中间结果集，名称必须以 \`tmp\_\`开头。备份表用于备份或抓取源表快照，名称必须以 \`bak\_\` 开头。中间表和备份表定期清理

--------------------

【强制】对于线上执行DDL变更，必须经过DBA审核，并由DBA在业务低峰期执行

--------------------

### 列数据类型优化 ###

【建议】表中的自增列（auto\_increment属性），推荐使用bigint类型。因为无符号int存储范围为-2147483648~2147483647（大约21亿左右），溢出后会导致报错

--------------------

【建议】业务中选择性很少的状态status、类型type等字段推荐使用tinytint或者smallint类型节省存储空

--------------------

【建议】业务中IP地址字段推荐使用int类型，不推荐用char(15)。因为int只占4字节，可以用如下函数相互转换，而char(15)占用至少15字节。一旦表数据行数到了1亿，那么要多用1.1G存储空间。

SQL：  
select inet\_aton(‘192.168.2.12’);  
select inet\_ntoa(3232236044);  
PHP:  
ip2long(‘192.168.2.12’);  
long2ip(3530427185);

--------------------

【建议】不推荐使用enum，set。 因为它们浪费空间，且枚举值写死了，变更不方便。推荐使用tinyint或smallint

--------------------

【建议】不推荐使用blob，text等类型。它们都比较浪费硬盘和内存空间。在加载表数据时，会读取大字段到内存里从而浪费内存空间，影响系统性能。建议和PM、RD沟通，是否真的需要这么大字段

--------------------

**【建议】存储金钱的字段，建议用int，程序端乘以100和除以100进行存取。或者用decimal类型，而不要用double**

--------------------

【建议】文本数据尽量用varchar存储。因为varchar是变长存储，比char更省空间。MySQL server层规定一行所有文本最多存65535字节

--------------------

【建议】时间类型尽量选取datetime。而timestamp虽然占用空间少，但是有时间范围为1970-01-01 00:00:01到2038-01-01 00:00:00的问题（一般采用int类型存储）

--------------------

### 索引设计 ###

【强制】InnoDB表必须主键为 `id int/bigint auto_increment,`且主键值禁止被更新

【建议】唯一键以`“uk_”或“uq_”`开头，普通索引以`“idx_”`开头，一律使用小写格式，以字段的名称或缩写作为后缀

【强制】InnoDB和MyISAM存储引擎表，索引类型必须为BTREE；MEMORY表可以根据需要选择HASH或者BTREE类型索引

【强制】单个索引中每个索引记录的长度不能超过64KB

【建议】单个表上的索引个数不能超过5个

【建议】在建立索引时，多考虑建立联合索引，并把区分度最高的字段放在最前面。如列`userid`的区分度可由`select count(distinct userid)`计算出来

【建议】在多表`join`的SQL里，保证被驱动表的连接列上有索引，这样`join`执行效率最高

【建议】建表或加索引时，保证表里互相不存在冗余索引。对于MySQL来说，如果表里已经存在`key(a,b)，则key(a)`为冗余索引，需要删除

### 分库分表、分区表 ###

【强制】分区表的分区字段（partition-key）必须有索引，或者是组合索引的首列

【强制】单个分区表中的分区（包括子分区）个数不能超过1024

【强制】上线前RD或者DBA必须指定分区表的创建、清理策略

【强制】访问分区表的SQL必须包含分区键

【建议】单个分区文件不超过2G，总大小不超过50G。建议总分区数不超过20个

【强制】对于分区表执行alter table操作，必须在业务低峰期执行

【强制】采用分库策略的，库的数量不能超过1024

【强制】采用分表策略的，表的数量不能超过4096

【建议】单个分表建议不超过500W行，这样才能保证数据查询性能更佳

【建议】水平分表尽量用取模方式，并预留出足够的buffer，以免日后需要重新拆分和迁移，日志、报表类数据建议采用日期进行分表

### 字符集 ###

【强制】数据库本身库、表、列所有字符集必须保持一致，为utf8或utf8mb4

【强制】前端程序字符集或者环境变量中的字符集，与数据库、表的字符集必须一致，统一为utf8

### 一个规范的建表语句示例 ###

CREATE TABLE user (
      `id` int(20) unsigned NOT NULL AUTO_INCREMENT,
      `user_id` int(20) unsigned NOT NULL default ‘0’ COMMENT ‘用户id’,
      `username` varchar(45) NOT NULL default ‘’ COMMENT '真实姓名',
      `email` varchar(30) NOT NULL default ‘’COMMENT ‘用户邮箱’,
      `nickname` varchar(45) NOT NULL default ‘’ COMMENT '昵称',
      `avatar` int(11) NOT NULL default ‘0’ COMMENT '头像',
      `birthday` date NOT NULL default ‘0000-00-00’ COMMENT '生日',
      `sex` tinyint(4) not null DEFAULT '0' COMMENT '性别',
      `short_introduce` varchar(150) not null DEFAULT ‘’COMMENT '一句话介绍自己，最多50个汉字',
      `user_resume` varchar(200) NOT NULL default ‘’COMMENT '用户提交的简历存放地址',
      `user_register_ip` int NOT NULL COMMENT ‘用户注册时的源ip’,
      `created_at` datetime NOT NULL default current_timestamp COMMENT ‘用户记录创建的时间’,
      `updated_at` datetime default current_timestamp on update current_timestamp NOT NULL COMMENT ‘用户资料修改的时间’,
      `user_review_status` tinyint NOT NULL default ‘1’ COMMENT ‘用户资料审核状态，1为通过，2为审核中，3为未通过，4为还未提交审核’,
      PRIMARY KEY (`id`),
      UNIQUE KEY `uq_user_id` (`user_id`),
      KEY `idx_username`(`username`),
      KEY `idx_create_time`(`create_time`,`user_review_status`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='网站用户基本信息';

## SQL 编写 ##

### DML 语句 ###

【强制】SELECT语句必须指定具体字段名称，禁止写成\*。因为select \*会将不该读的数据也从MySQL里读出来，造成网卡压力。且表字段一旦更新，但程序端没有来得及更新的话，系统会报错

--------------------

【强制】insert语句指定具体字段名称，不要写成insert into t1 values(…)，道理同上

--------------------

【建议】insert into…values(XX),(XX),(XX)…。这里XX的值不要超过500个。值过多虽然上线很很快，但会引起主从同步延迟

--------------------

【建议】SELECT语句不要使用UNION，推荐使用UNION ALL，并且UNION子句个数限制在3个以内。因为union all不需要去重，节省数据库资源，提高性能

--------------------

【建议】in值列表限制在500以内。例如select… where userid in(….500个以内…)，这么做是为了减少底层扫描，减轻数据库压力从而加速查询

--------------------

【建议】事务里批量更新数据需要控制数量，进行必要的sleep，做到少量多次

--------------------

【强制】事务涉及的表必须全部是innodb表。否则一旦失败不会全部回滚，且易造成主从库同步中断

--------------------

【强制】写入和事务发往主库，只读SQL发往从库，即程序端实现读写分离

--------------------

【强制】DML语句必须有where条件，且使用索引查找

--------------------

【强制】生产环境禁止使用hint，如sql\_no\_cache，force index，ignore key，straight join等。因为hint是用来强制SQL按照某个执行计划来执行，但随着数据量变化我们无法保证自己当初的预判是正确的，我们要尽量让MySQL优化器自己选择执行计划

--------------------

【强制】where条件里等号左右字段类型必须一致，否则无法利用索引

--------------------

【建议】SELECT|UPDATE|DELETE|REPLACE要有WHERE子句，且WHERE子句的条件必需使用索引查找

--------------------

【强制】生产数据库中强烈不推荐大表上发生全表扫描，但对于100行以下的静态表可以全表扫描。查询数据量不要超过表行数的25%，否则不会利用索引

--------------------

【强制】WHERE 子句中禁止只使用全模糊的LIKE条件进行查找，如果要使用like，请使用like ‘xxxx%’的方式，必须有其他等值或范围查询条件，否则无法利用索引

--------------------

【建议】索引列不要使用函数或表达式，否则无法利用索引。如where length(name)='Admin'或where user\_id+2=10023

--------------------

【建议】减少使用or语句，可将or语句优化为union，然后在各个where条件上建立索引。如where a=1 or b=2优化为where a=1… union …where b=2, key(a),key(b)

--------------------

【建议】分页查询，当limit起点较高时，可先用过滤条件进行过滤。如select a,b,c from t1 limit 10000,20;优化为: select a,b,c from t1 where id>10000 limit 20;

--------------------

### 多表连接 ###

【强制】禁止跨db的join语句。因为这样可以减少模块间耦合，为数据库拆分奠定坚实基础

【强制】禁止在业务的更新类SQL语句中使用join，比如update t1 join t2…

【建议】不建议使用子查询，建议将子查询SQL拆开结合程序多次查询，或使用join来代替子查询

【建议】线上环境，多表join不要超过3个表

【建议】多表连接查询推荐使用别名，且SELECT列表中要用别名引用字段，数据库.表格式，如select a from db1.table1 alias1 where …

【建议】在多表join中，尽量选取结果集较小的表作为驱动表，来join其他表

### 事务 ###

【建议】事务中`INSERT|UPDATE|DELETE|REPLACE`语句操作的行数控制在1000以内，以及`WHERE子句中IN`列表的传参个数控制在500以内

【建议】批量操作数据时，需要控制事务处理间隔时间，进行必要的sleep，一般建议值1-2秒

【建议】对于有auto\_increment属性字段的表的插入操作，并发需要控制在200以内

【强制】程序设计必须考虑“数据库事务隔离级别”带来的影响，包括脏读、不可重复读和幻读。线上建议事务隔离级别为repeatable-read

【建议】事务里包含SQL不超过5个（支付业务除外）。因为过长的事务会导致锁数据较久，MySQL内部缓存、连接消耗过多等雪崩问题

【建议】事务里更新语句尽量基于主键或unique key，如update … where id=XX; 否则会产生间隙锁，内部扩大锁定范围，导致系统性能下降，产生死锁

【建议】尽量把一些典型外部调用移出事务，如调用webservice，访问文件存储等，从而避免事务过长

【建议】对于MySQL主从延迟严格敏感的select语句，请开启事务强制访问主库

### 排序和分组 ###

【建议】减少使用order by，和业务沟通能不排序就不排序，或将排序放到程序端去做。order by、group by、distinct这些语句较为耗费CPU，数据库的CPU资源是极其宝贵的

【建议】order by、group by、distinct这些SQL尽量利用索引直接检索出排序好的数据。如where a=1 order by可以利用key(a,b)

【建议】包含了order by、group by、distinct这些查询的语句，where条件过滤出来的结果集请保持在1000行以内，否则SQL会很慢

### 线上禁止使用的 SQL 语句 ###

【高危】禁用 `update|delete t1 … where a=XX limit XX;`这种带`limit`的更新语句。如果是非row格式的binlog格式，会导致主从不一致，导致数据错乱。建议加上order by PK

【高危】禁止使用关联子查询，如`update t1 set … where name in(select name from user where…);`效率极其低下

【强制】禁用`procedure、function、trigger、views、event、`外键约束。因为他们消耗数据库资源，降低数据库实例可扩展性。推荐都在程序端实现

【建议】禁用`insert into …on duplicate key update…、replace into`等语句，在高并发环境下，极容易导致死锁

【强制】禁止联表更新语句，如`update t1,t2 where t1.id=t2.id…`

MySQL 设计与开发规范

发表评论取消回复

还没有评论，来说两句吧...

相关阅读

相关 MYSQL数据库设计规范与原则

相关 MySQL 设计与开发规范

相关 MySQL规范，设计规范，索引规范，开发规范，操作规范

相关 MySQL 开发规范

相关【MySQL】Mysql设计与开发规范-修订版

相关汇总篇 | MySQL数据库设计开发规范

相关 Mysql 开发规范

相关 Mysql开发规范

相关 MySQL数据库设计与开发规范

相关 MySQL设计规范与原则