SuperAPI AI 工具集

pscale-read-only-replica

通用与其它

查看项目

更新于 10-16 07:17

技能介绍

用途:通过 PlanetScale CLI 管理 PostgreSQL 分支的专用只读容量。这些命名资源独立于主分支集群的副本,也不同于 Vitess/MySQL 的只读区域。

主要能力:列出与查看副本、创建副本、调整副本数量与集群规格、设置参数、删除副本。命令组会自行校验数据库类型并拒绝 Vitess 数据库。

使用方式:

  • 列出:pscale read-only-replica list <database> <branch> --org <org> --format json
  • 查看:pscale read-only-replica show <database> <branch> <name> --org <org> --format json
  • 创建:pscale read-only-replica create <database> <branch> <name> --region <region> --org <org> --format json,可用 --replicas 与 --cluster-size 显式指定容量
  • 更新:pscale read-only-replica update <database> <branch> <name> --replicas 3 --cluster-size PS_20_GCP_X86 --parameters pgconf.max_connections=300 --org <org> --format json
  • 删除:pscale read-only-replica delete <database> <branch> <name> --org <org>,非交互场景需显式批准后加 --format json --force

可用 pscale region list --org <org> --format json 查询区域;用 pscale size cluster list --org <org> --engine postgresql --format json 选择规格。创建与更新为异步操作,需轮询 list 或 show 直到 ready。

限制:JSON 输出为底层 API 模型,字段结构可能嵌套,需防御性访问。pscale sql --replica 与 pscale shell --replica 无法将查询固定到某个命名只读副本,验证特定目标需走生产应用连接路径或区域端点。删除前应确认客户端与替代容量,不要仅为绕过交互提示而使用 --force。参数值不得低于主分支对应值。