Skip to main content

Module diff

Module diff 

Source
Expand description

结构差异计算:比较「期望结构」与「实际结构」,产生 SchemaDiff。

差异计算是纯函数,不依赖数据库连接,因此可以针对每一种差异编写单元测试。 规则要点:

  • 重命名(表/字段)必须通过 rename_from 显式声明,绝不按名称相似度猜测。
  • 类型/可空性/默认值的变化会单独归类,供后续阶段进行危险等级判断。

Structs§

CommentChange
注释变化。desired = None 表示删除现有注释。
PrimaryKeyDiff
主键差异。
SchemaDiff
顶层差异:需要新建的 schema + 各表差异。

Enums§

ColumnDiff
字段级差异类型。
ConstraintDiff
唯一约束差异。
ForeignKeyDiff
外键差异。
FunctionDiff
数据库函数差异。
IndexDiff
普通索引差异。
TableDiff
单张表的差异类型。

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 类型写法,使期望结构与实际结构可比较。