tcb db pg migration fetch
将远端已应用的迁移拉取到本地目录，默认全量拉取。传入 version 可拉取指定版本。
语法
# 全量拉取远端 migration
tcb db pg migration fetch -e <envId>
# 拉取单条
tcb db pg migration fetch <version> -e <envId>
参数
| 参数 | 必填 | 说明 | 默认值 |
|---|---|---|---|
[version] | 否 | 14 位版本号；不传则拉取全部迁移 | — |
-f, --force | 否 | 覆盖本地已存在的同名文件 | false |
--dry-run | 否 | 预览将要写入的文件，不实际写入 | false |
-e, --env-id <envId> | 是 | 环境 ID | — |
--json | 否 | 输出 JSON | — |
示例
# 首次接入远端历史，把已应用 migration 全部拉到本地
tcb db pg migration fetch -e <envId>
# 拉取指定版本
tcb db pg migration fetch 20260724153000 -e <envId>
# 覆盖本地同名文件（以远端为准）
tcb db pg migration fetch -e <envId> --force
# 只看计划，不落盘
tcb db pg migration fetch -e <envId> --dry-run
已存在的本地文件默认跳过，使用 --force 才会覆盖。