跳到主要内容

文件命名规则

规则

所有的文件命名规则都应该按照以下规则进行命名

提示

group-[datasource]-[order]-[other]

分组-[校验和执行节点]-[顺序]-[其他信息]

解释

  • group: 文件分组,ezasse会按照分组进行执行,当存在多个分组时,应该设置配置项groupOrder,指定按分组执行的顺序,一般分组指定为版本号,例如: v1.0.1
  • datasource: 数据源节点,如果文件名称上指定了数据节点,并且校验行上没有指定数据节点,那么所有的校验行与执行内容都会在文件数据源上执行
  • order: 顺序值,组成为三位数字,可以控制文件的执行顺序 例如: 001, 002, 003
  • other: 没有实际意义,可以随意填写,用于对文件进行标识
提示

文件上指定的数据节点的优先级小于校验行上的数据节点

示例

文件名分组数据源排序备注
v1.0.1.sqlv1.0.1文件中的内容将在默认的数据节点进行校验和执行
v1.0.1-master.sqlv1.0.1master文件中的内容将在master数据节点进行校验和执行
v1.0.1-001.sqlv1.0.1001文件内容在默认数据节点执行,执行顺序为001
v1.0.1-master-001.sqlv1.0.1master001文件内容在master执行,执行顺序为001

最佳实践

提示

建议使用下面的文件命名方式管理

resource
|-sqls
|-V1-100-table.sql # 维护所有的表创建脚本
|-V1-200-change.sql # 维护所有针对表的更新脚本
|-V1-300-data.sql # 维护所有数据
|-V1.1-100-table.sql # 维护1.1版本的所有的表创建脚本
|-V1.1-200-change.sql # 维护1.1版本的所有针对表的更新脚本
|-V1.1-300-data.sql # 维护1.1版本的所有数据