用途:通过 pscale branch 命令管理 PlanetScale 数据库分支,覆盖创建、删除、重命名、删除保护、提升到生产、schema 对比与恢复等操作,同时提供 PostgreSQL/Neki 日志查询、分支基础设施与连接检查能力。
主要能力:创建分支(可指定 --from 来源分支);用 --restore-point 将 PostgreSQL 分支恢复到指定时间点;列出与查看分支详情;重命名或修改删除保护;查看 schema 与 schema diff;查看分支基础设施/pod;列出 Postgres 分支镜像可用扩展;启动 Postgres/Neki 分支镜像维护;执行 Postgres 主库 switchover;查看 Vitess 路由规则与 tablet 状态;检查连接并终止查询或连接;下载查询模式 CSV 报告;删除分支或提升到生产。
使用方式:命令形如 pscale branch create <database> <branch-name> --from <source-branch>;列表默认一页最多 100 个分支,可用 --page 与 --per-page 翻页;自动化场景建议加 --format json。恢复分支示例:pscale branch create <database> <new-branch> --org <org> --from <source-branch> --restore-point <RFC3339-timestamp> --cluster-size <postgres-cluster-size> --wait --format json。日志查询示例:pscale logs <database> <branch> --org <org> --format json --period 1h。
适用场景:schema 迁移工作流(建开发分支、改 schema、diff、创建 deploy request)、为 MR/PR 建对应分支、Postgres 时间点恢复、分支基础设施与连接诊断、Vitess 运维检查。
限制:恢复、维护、switchover、重命名、删除保护变更等属于写操作,可能影响可用性或产生计费资源,需先检查并获明确批准;--restore-point 仅支持 PostgreSQL,且不能与 --seed-data 同用;--period 与 --from/--to 不能同时使用;维护期间不能有进行中的变更请求;switchover 一次只能运行一个,失败结果不确定且不会自动回滚;扩展列表只反映镜像可用扩展,不代表已安装;无 CLI 命令直接启用扩展。