tcb db pg migration list
列出迁移状态,默认对比本地目录与远端已应用记录。
语法
# 默认:本地 vs 远端对比
tcb db pg migration list -e <envId>
# 仅查询远端(可选分页)
tcb db pg migration list -e <envId> --remote-only [--limit <n>] [--offset <n>]
参数
| 参数 | 必填 | 说明 | 默认值 |
|---|---|---|---|
--remote-only | 否 | 仅查询远端已应用的迁移,不扫描本地目录 | false |
--limit <n> | 否 | 单页条数,范围 [1, 500],仅用于 --remote-only 模式 | 100 |
--offset <n> | 否 | 分页偏移,仅用于 --remote-only 模式 | 0 |
-e, --env-id <envId> | 是 | 环境 ID | — |
--json | 否 | 输出 JSON | — |
示例
# 对比本地与远端
tcb db pg migration list -e <envId>
# JSON 格式输出,便于脚本消费
tcb db pg migration list -e <envId> --json
# 仅查看远端最新 200 条已应用 migration
tcb db pg migration list -e <envId> --remote-only --limit 200 --offset 0
输出包含 Local、Remote、Time (UTC) 三列。仅存在于一侧的记录在另一侧列中留空,便于识别未同步项。
注意事项
- 默认模式全量拉取远端迁移并与本地对比,传入
--limit/--offset会报错 - 只有
--remote-only模式支持分页