用途:pscale import d1 用于把 Cloudflare D1 数据库导出(SQLite SQL)离线迁移到 PlanetScale Postgres,覆盖 lint、SQLite DDL 转 PostgreSQL DDL、数据加载、本地迁移状态保存与导入校验。所有命令支持全局 --format json,便于自动化。
主要能力:lint 分析 D1 导出并报告问题;convert-schema 转换 DDL;start 执行 lint、规划并加载数据,支持 --dry-run 与 --migration-id;status 查看本地迁移状态;verify 校验行数与内容;complete 标记完成。转换器处理列/表级 CHECK、命名约束、生成列、NUMERIC/DECIMAL 精度及常见默认值,并将部分 SQLite 专用写法改写为 PostgreSQL 形式。
使用方式:先用 wrangler d1 export <d1-database-name> --remote --output ./d1-export.sql 导出,再运行 pscale import d1 doctor --format json 检查 pgloader 等前置条件。推荐顺序为 lint、convert-schema、start --dry-run、确认后 start、verify、complete。start 需要 pgloader 在 PATH 中;小库可用 --method psql,大导出用 --method pgloader。省略 branch 时使用默认分支,自动化建议显式指定。
限制:lint 错误会阻止 start(包括 --dry-run),--force 不能绕过;警告可审阅后接受。转换不保证语义等价或完整 lint 覆盖,json_valid 的 flags 会被丢弃,strftime('%s','now') 等未转换,部分函数形式不被改写。表达式/部分索引、视图、触发器可能需人工处理。导入使用默认验证 TLS,不应削弱。非 dry-run 的 start 与 complete 需用户明确确认目标。