用途:通过 pscale 只读地检查 PlanetScale Enterprise 计划下 Vitess 数据库的维护计划(maintenance schedule)与维护窗口(window)数据,用于列出计划维护、核对待处理的 Vitess 版本、到期与截止时间等信息。
前提:先用 pscale auth check --format json 完成认证;明确目标组织与 Vitess 数据库;显式传入 --org,不要依赖默认组织;自动化场景优先使用 --format json,并将 schedule ID 视为不可修改的不透明值。
主要命令: 列出计划:pscale maintenance list <database> --org <org> --format json 查看单个计划:pscale maintenance show <schedule-id> --org <org> --format json 查看窗口:pscale maintenance windows <database> <schedule-id> --org <org> --format json
输出内容可能包含计划是否启用或必需、频率、日/周/小时、时长、下次与上次窗口时间、待处理的 Vitess/MySQL 版本、到期与截止元数据。JSON 中的时间戳为权威 API 值,不要从人类可读表格推断本地时区。月度计划含 week-of-month 值,非月度行该字段显示为短横线。窗口为历史或活动实例,空结果仅表示该计划当前无窗口,不代表维护被禁用。
安全审查流程:先运行 pscale database show <database> --org <org> --format json 确认引擎与身份;列出计划并从实时输出中选取准确 ID;先 show 计划再解读待处理版本、到期或截止字段;列出窗口,并将计划元数据与观察到的窗口历史分开报告。
限制:这些命令为只读,不能重新安排、批准或取消维护;当前 CLI 仅支持列出与查看记录。故障排查:命令不可用则更新 pscale 并核对 pscale maintenance --help;未找到则针对准确组织/数据库重新列出并原样复制 ID;无计划则确认数据库为 Vitess 且组织具备相应 Enterprise 维护功能;日/周异常需结合 JSON 字段与频率判断,week-of-month 仅适用于月度计划。更多命令帮助见 references/commands.md。