跳到主要内容

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 模式支持分页