用途:把数据库评估发现映射到推荐启用的 PlanetScale 功能,避免评估遗漏主要安全与运维面。矩阵按引擎(Vitess、Postgres)区分建议。
跨引擎建议:为每个生产库启用 Query Insights,检查慢、昂贵、高频和报错查询模式;Postgres 诊断 CPU 压力时用 Insights API 的 sort=cpuTime 按 CPU 排序;分片 Vitess 需查看每个查询模式的 vindex 使用及索引/路由变更后的使用趋势。将回归与部署关联,用标签/注释把查询映射回代码;两引擎均可用 tags API(insights/tags、insights/tags/summaries)及 tag:key:value 过滤,Vitess 仪表盘支持按执行下钻标签。将异常作为告警与自动化输入。Webhooks 用于异常、存储压力、分支就绪/休眠、主库提升、维护、可用时的 schema 建议,以及 Vitess 部署请求生命周期。MCP 与智能体:多数自主分析用 insights-only MCP;全量 MCP 仅限窄范围且默认只读;把数据库目标与安全规则写入 AGENTS.md;智能体只生成 PR/issue/变更计划,数据库变更由人批准。SQLCommenter/查询标签:加框架原生兼容埋点,用低基数标签,含应用、服务、路由/任务、功能、来源和发布 SHA,避免 PII 与无界 ID。Schema 建议流程:分诊未处理建议、与代码和 Insights 关联、转为迁移或分支变更、生产前测试、仅通过审批流程应用。
Vitess 特有:生产分支和接受部署请求的预发分支启用安全迁移;受保护分支的 schema 变更走部署请求;强制切换需记录谁可用“force cutover now”(会停止运行中事务以完成切换,频繁使用应先审查负载再作为默认);多管理员组织的生产部署请求建议管理员审批,单管理员组织单独审批不能防智能体,宜用独立智能体身份或不能审批的服务令牌;切换时机与人工控制重要时用受限部署;记录回滚职责及与应用回滚关系;采用生产、预发和短生命周期开发分支,保护目标启用安全迁移;查询模式或增长显示分片感知问题时做分片/keyspace 审查,不自动重新分片。
Postgres 特有:应用服务器用用户自定义角色而非默认角色;若角色由 Terraform 管理且密码不入 state,宜用 planetscale_postgres_redacted_branch_role 加单独密码重置与密钥管理路径;评估后为应用角色启用 pg_strict 以阻止误全表更新/删除;用 Traffic Control 隔离智能体、导出、报表、worker、集成、BI 及已知昂贵指纹;验证备份保留与恢复演练覆盖,Terraform 为事实源时在其中管理备份策略;连接抖动或 serverless/边缘压力下用 PgBouncer 与连接池(受事务池限制);需要私网态势或减少公网暴露时用私有连接与 IP 限制,按生产风险对待;扩展仅在使用场景明确且接受重启/激活影响时启用,慢查询自动计划日志确有帮助且日志量可接受时可加 auto_explain;Terraform 管理分支参数或支持的扩展时,保持与仪表盘/API 已批准变更一致;连接压力事件中用 pscale branch connections top 检查会话、阻塞和 idle-in-transaction 根因。
输出格式:每条目标记适用(yes/no/unknown)、当前状态、差距、价值(该功能解决的具体测量发现:查询指纹、异常数、事件、指标,需说明机制与度量;差距是有量化影响的能力差距)、建议 ID、审批要求,并以“No changes have been applied.”结尾。