基础规范

  • 表存储引擎必须使用InnoDB
  • 表字符集默认使用utf8，必要时候使用utf8mb4
    通用，无乱码风险，汉字3字节，英文1字节
    utf8mb4是utf8的超集，有存储4字节例如表情符号时，使用它
  • 禁止使用存储过程，视图，触发器，Event
    对数据库性能影响较大，互联网业务，能让站点层和服务层干的事情，不要交到数据库层
    调试，排错，迁移都比较困难，扩展性较差
  • 禁止在数据库中存储大文件，例如照片，可以将大文件存储在对象存储系统，数据库中存储路径
  • 禁止在线上环境做数据库压力测试
  • 测试，开发，线上数据库环境必须隔离

命名规范

  • 库名，表名，列名必须用小写，采用下划线分隔；库名，表名，列名必须见名知义,
    abc，Abc，ABC 都是给自己埋坑

  • 库名使用服务名命名，如： pai_shceduler、pai_platform

  • 多租户库名格式: 服务名租户唯一编码，如: `paiorder_t001`

  • 表名格式：

    1. 服务级表规范：服务简码表名，表名最多4段，总共不超过5段。如OSS服务的attachment表：`ossattachment`
    2. 模块级表规范：服务简码模块简码表名，模块简码2-4位，表名最多4段，总共不超过6段。如平台服务基础模块的user表：auth_sys_user

  • 库备份必须以bak为前缀，以日期为后缀

  • 从库必须以_s为后缀

  • 备库必须以_ss为后缀

表设计规范

  • 单实例表个数必须控制在2000个以内

  • 单表分表个数必须控制在1024个以内

  • 表必须有主键，推荐使用UNSIGNED整数为主键
    潜在坑：删除无主键的表，如果是row模式的主从架构，从库会挂住

  • 禁止使用外键，如果要保证完整性，应由应用程式实现
    外键使得表之间相互耦合，影响update/delete等SQL性能，有可能造成死锁，高并发情况下容易成为数据库瓶颈

  • 建议将大字段，访问频度低的字段拆分到单独的表中存储，分离冷热数据

  • 表名长度不要超过26个字符，否则Oracle建相关对象可能会报错

列设计规范

  • 根据业务区分使用tinyint/int/bigint，分别会占用1/4/8字节

  • 根据业务区分使用char/varchar
    字段长度固定，或者长度近似的业务场景，适合使用char，能够减少碎片，查询性能高
    字段长度相差较大，或者更新较少的业务场景，适合使用varchar，能够减少空间

  • 存储年使用year，存储日期使用date，存储时间使用datetime
    datetime使用DEFAULT CURRENT_TIMESTAMP 和 ON UPDATE CURRENT_TIMESTAMP定义默认值和默认更新

  • 必须把字段定义为NOT NULL并设默认值
    NULL的列使用索引，索引统计，值都更加复杂，MySQL更难优化
    NULL需要更多的存储空间
    NULL只能采用IS NULL或者IS NOT NULL，而在=/!=/in/not in时有大坑

  • 使用INT UNSIGNED存储IPv4，不要用char(15)

  • 使用varchar(20)存储手机号，不要使用整数
    牵扯到国家代号，可能出现+/-/()等字符，例如+86
    手机号不会用来做数学运算
    varchar可以模糊查询，例如like ‘138%’

  • 使用TINYINT来代替ENUM
    ENUM增加新值要进行DDL操作

  • 列名称长度不允许超过30个字符，否则Oracle建相关对象可能会报错

索引规范

  • 唯一索引以uk_或uq_开头，普通索引以idx_开头，以字段名称或缩写作为后缀。

  • 单张表索引数量建议控制在5个以内
    互联网高并发业务，太多索引会影响写性能
    生成执行计划时，如果索引太多，会降低性能，并可能导致MySQL选择不到最优索引
    异常复杂的查询需求，可以选择ES等更为适合的方式存储

  • 组合索引字段数不建议超过5个
    如果5个字段还不能极大缩小row范围，八成是设计有问题

  • 不建议在频繁更新的字段上建立索引

  • 非必要不要进行JOIN查询，如果要进行JOIN查询，被JOIN的字段必须类型相同，并建立索引
    踩过因为JOIN字段类型不一致，而导致全表扫描的坑么？

  • 理解组合索引最左前缀原则，避免重复建设索引，如果建立了(a,b,c)，相当于建立了(a), (a,b), (a,b,c)

表设计自检

  • 表中tenant_id有没有，有的话需必输，为0代表是全局；没有的话是否合理
  • 唯一性索引是否有，是否合理
  • 字段是否可以为空，为空的理由是什么
  • 后缀为num表示为编码规则生成的代码编号；code为代码
  • 用Tinyint类型时，一般要默认必输，默认值1=启用，比如enabled_flag；性别gender，1男、0女
  • 顺序号统一字段名为order_seq

SQL规范

  • 禁止使用select *，只获取必要字段
    select *会增加cpu/io/内存/带宽的消耗
    指定字段能有效利用索引覆盖
    指定字段查询，在表结构变更时，能保证对应用程序无影响

  • insert必须指定字段，禁止使用insert into T values()。指定字段插入，在表结构变更时，能保证对应用程序无影响

  • 手写update语句，禁止使用别名（update T t SET t.xx = 1），以免出现数据库不兼容问题

  • 手写update语句更新时间，使用CURRENT_TIMESTAMP，不要使用特定数据库方言函数

  • 隐式类型转换会使索引失效，导致全表扫描

  • 禁止在where条件列使用函数或者表达式， 导致不能命中索引，全表扫描

  • 禁止负向查询以及%开头的模糊查询，会导致不能命中索引，全表扫描

  • 禁止大表JOIN和子查询

  • 同一个字段上的OR必须改写成IN，IN的值必须少于50个

  • 应用程序必须捕获SQL异常，方便定位线上问题

其他规范

  • 主键使用雪花算法生成
  • varchar 最长2000，超过请使用text类型
  • 时间使用datetime类型
  • 默认有create_by,create_time,update_by,update_time字段；create_by、update_by存使用者主键

Hutool 雪花算法ID工具

Snowflake snowflake = IdUtil.createSnowflake(1, 1); 
snowflake.nextId();
workerId与datacenterId还需确定怎么取值，暂时(1, 1)。同应用不同服务应区隔开来
文档更新时间: 2024-03-25 11:24   作者：姚连洲