Expand description
结构差异计算:比较「期望结构」与「实际结构」,产生 SchemaDiff。
差异计算是纯函数,不依赖数据库连接,因此可以针对每一种差异编写单元测试。 规则要点:
- 重命名(表/字段)必须通过
rename_from显式声明,绝不按名称相似度猜测。 - 类型/可空性/默认值的变化会单独归类,供后续阶段进行危险等级判断。
Structs§
- Comment
Change - 注释变化。
desired = None表示删除现有注释。 - Primary
KeyDiff - 主键差异。
- Schema
Diff - 顶层差异:需要新建的 schema + 各表差异。
Enums§
- Column
Diff - 字段级差异类型。
- Constraint
Diff - 唯一约束差异。
- Foreign
KeyDiff - 外键差异。
- Function
Diff - 数据库函数差异。
- Index
Diff - 普通索引差异。
- Table
Diff - 单张表的差异类型。
Functions§
- compute_
diff - 计算期望结构与实际结构之间的全部差异。
- normalize_
default - 归一化默认值表达式:
- normalize_
function_ definition - 保留函数体内部语义,只统一换行和定义末尾的分号/空白。
- normalize_
predicate - 归一化部分索引谓词:
WHERE deleted_at IS NOT NULL、(deleted_at IS NOT NULL)统一为deleted_at is not null。 - normalize_
type - 归一化 PostgreSQL 类型写法,使期望结构与实际结构可比较。