MySQL 开发规范

disgare

已于 2024-07-04 18:15:35 修改

阅读量414

点赞数 1

分类专栏：数据库文章标签： mysql 数据库

于 2022-08-22 16:05:59 首次发布

本文链接：https://blog.csdn.net/sekever/article/details/126467458

版权

数据库专栏收录该内容

15 篇文章 1 订阅

订阅专栏

MySQL 开发规范

基础模板
命名规范
设计规范
字段设计
SQL 规范
数据库字段类型和Java的对应关系

基于阿里编程规范，遵从开发规范可以避免错误

基础模板

CREATE TABLE user
(
    id          bigint(20) UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '自增主键id',
    user_id     bigint(20)          NOT NULL COMMENT '用户id',
    user_name   varchar(128)        NOT NULL DEFAULT '' COMMENT '用户名',
    del_status  tinyint(4)          NOT NULL DEFAULT 0 COMMENT '0-存在 1-删除',
    create_time bigint(20) UNSIGNED NOT NULL COMMENT '创建日期',
    update_time bigint(20) UNSIGNED NOT NULL ON UPDATE UNIX_TIMESTAMP(NOW()) COMMENT '更新日期',
    PRIMARY KEY (id)
) ENGINE = InnoDB
  AUTO_INCREMENT = 1
  DEFAULT CHARSET = utf8mb4
  COLLATE = utf8mb4_unicode_ci COMMENT = '用户表';

alter table user
    add unique index uniq_user_id (user_id),
    add index idx_user_name (user_name);

命名规范

库名、表名、字段名必须使用小写字母,并采用下划线分割
库名、表名、字段名禁止使用MySQL保留字
临时库、表名必须以tmp为前缀,并以日期为后缀。例如 tmp_test01_20130704
备份库、表必须以bak为前缀,并以日期为后缀。例如 bak_test01_20130704
非唯一索引按照“idx_字段名称_字段名称”进用行命名。例如 idx_age_name，一般命名为表名加列名加 uindex，比如 user_user_id_uindex
唯一索引按照“uniq_字段名称_字段名称”进用行命名。例如 uniq_age_name，一般命名为表名加列名，比如 user_user_name
主键索引一般为自动生成，使用 primary key 即可生成类似 user_id_pkey 的索引

设计规范

表必须显示定义使用 innodb 存储引擎、utf8mb4 字符集，并且添加注释
表必须有主键，推荐使用 unsigned 自增列的 int 类型非业务数据作为主键（其他类型不能设置为自增）
除主键外的其他字段都需要增加注释
所有字段均定义为 NOT NULL
使用 datetime，禁止使用 timestamp
禁止在数据库中存储图片、文件等大数据
与其他表联查的字段必须加索引
表必须要有修改时间与创建时间
text 可以使用 varchar(10240) 代替。原因：varchar 类型也更容易进行数据验证和清理，因为它有一个明确的最大长度；text 类型无法使用索引、需要额外的处理和存储空间

字段设计

所有 int 类型在 java 中用 integer 表示，这样不会出现 null 与0混淆的情况
使用 tinyint 来代替 enum 类型以及 boolean 类型
尽可能不使用 TEXT、BLOB 类型
用 DECIMAL 代替 FLOAT 和 DOUBLE 存储浮点数。例如与货币、金融相关的数据
id 类型 serial （主键）最多自增到21亿，且不可回退，如果 insert 数据量较大推荐使用 bigserial（long）
update_time、create_time 等时间字段推荐使用 bigint 类型存放，因为查询速度最快，同时使用 now 函数做查询时是可以用索引的（但是直接使用字符串不行），如果不使用 bigint 推荐使用 timestamptz default now() not null（带时区默认为 now 并且不为空）。同时，因为使用 now 函数很可能并发的使用其他函数，比如如下代码块，导致很有可能命中不了索引，因此我们建议在 java 中获取当前时间戳然后传入 mysql

#当前时间戳（秒级）：2020-08-08 12:09:42
select current_timestamp();

#当前时间戳（毫秒级）：2020-08-08 12:09:42.192
select current_timestamp(3);

# 秒级时间戳：1606371113 （自19700101 00:00:00以来按秒算）
UNIX_TIMESTAMP(NOW())

# 毫秒级时间戳：1606371209.293
select unix_timestamp(current_timestamp(3))

# 毫秒级时间戳：1606371209293
REPLACE(unix_timestamp(current_timestamp(3)),'.','')

SQL 规范

尽量使用覆盖索引以避免回表操作
避免使用*
联合索引遵从最左前缀原则
使用 or、null、不等于、字符串不加单引号都会使索引失效，因此，使用 in 来代替or，禁止使用负向查询
like 以通配符开头无法使用索引
索引列上有计算或者在 where 上使用函数会无法命中索引
禁止使用存储过程、触发器、视图、自定义函数等
limit 语句注意配合 where 优化
避免在字段上使用函数，会使索引失效
避免内查询

数据库字段类型和Java的对应关系

左边是数据库的类型，右边是java中的类型

普通字符串
CHAR、VARCHAR 、LONGVARCHAR —> String
整数
SMALLINT —> Short
INTEGER —> Int
不要用 DOUBLE 和 FLOAT 存放小数
DECIMAL 、 NUMERIC —> BigDecimal
java中日期类别用Date了
DATE —> LocalDate
TIME（存放时分秒） —> LocalTime
TIMESTAMP、DATETIME —> LocalDateTime
枚举类
TINYINT —> 自己定义的枚举类