SuperAPI AI 工具集

pscale-inspect

数据与分析

查看项目

更新于 10-16 07:17

技能介绍

用途:pscale inspect 通过临时凭据对 PlanetScale 数据库分支运行只读、有界的诊断查询,检查项会按 MySQL/Vitess、PostgreSQL 或 Neki 自动适配,并与 pscale insights 的服务端生产流量分析互补。

主要能力:可运行 table-sizes、index-sizes、unused-indexes、redundant-indexes、invalid-indexes、seq-scans、long-running-queries、locks、outliers、calls、bloat、vacuum-stats、replication-slots、subscriptions 等单项检查,或用 all 生成全部适用检查的合并报告。单项检查支持 human、JSON、CSV 输出;all 仅支持 human 与 JSON,CSV 因各检查结果结构不同而被拒绝。

使用方式:先运行合并报告,例如 pscale inspect all <database> <branch> --org <org> --format json。PostgreSQL 可用 --dbname 指定应用数据库;Vitess 用 --keyspace '<keyspace>/<shard>' 指定单个分片;Neki 用 --shard 指定分片,必要时加 --router、--replica。单项检查用法相同,如 pscale inspect locks <database> <branch> --org <org> --format json。建议在自动化流程中显式传 --org。默认临时角色为 reader,仅在连接因权限失败且确认需要提权时才用 --role admin。

适用场景:排查表与索引体积、未使用或冗余索引、全表扫描、阻塞锁、超过五分钟的长查询、膨胀、autovacuum 健康度与复制状态,并据报告 next_steps 用 pscale insights 获取流量证据。

限制:每次检查有 30 秒查询超时;all 中单项失败会记为 skipped 而不中断其余报告;Vitess 分片库一次运行只反映一个分片的 MySQL 实例;--shard 与 --router 对非 Neki 数据库会被拒绝;不支持的检查会返回跳过说明。诊断结果只是证据,不应据此自动终止会话或改 schema,写操作或破坏性修复需另行获得明确批准。相关技能包括 pscale-insights、pscale-sql、pscale-branch。