工具 API

compare_database_schema

用于比较两个分支之间数据库模式的工具。输出是一个包含 diff 字段的 JSON 对象。该字段包含统一差异（git 风格补丁）字符串。您必须能够从差异生成零停机迁移并将其应用到父分支。要生成模式差异，您必须指定 database_名称。如果未指定 database_名称，必须回退到默认数据库名称 neondb。您必须考虑 PostgreSQL 版本。两个分支的 PostgreSQL 版本相同。在运行每个生成的 SQL 查询之前，您必须征得用户同意。您应该使用 run_sql 工具运行每个生成的 SQL 查询。建议在运行迁移之前创建备份或时间点恢复。生成的查询会更改父分支的模式，执行时可能有危险。生成的 SQL 迁移在可能的情况下应该是幂等的（即安全地多次运行），并在适用的情况下包含 IF NOT EXISTS / IF EXISTS。建议在生成的 SQL 中包含链接回差异块的注释（例如 -- from diff @@ -27,7 +27,10 @@）以便于审计。生成的 SQL 在执行前应检查依赖关系（例如外键顺序）。