SuperAPI AI 工具集

postgresql-best-practices-cloudbase

数据与分析

查看项目

更新于 10-16 07:14

技能介绍

用途:把可运行的 CloudBase PostgreSQL 实现整理成可评审的访问设计,在代码完成前明确查询路径、索引、行级授权与上线容量。

适用时机:新增或变更访问模式;应用代码出现重复、串行或高频 PG 查询;SQL、RPC、接口或轮询路径变慢;高流量上线需要数据库就绪审查。

不适用:PG 环境搭建、app.rdb() 语法、迁移、GRANT 或基础 RLS 正确性(用 ../postgresql-development-cloudbase/SKILL.md);登录提供方或 UI(用对应 auth 技能);已确认的 NoSQL 集合工作(用文档数据库技能);平台告警诊断或慢日志收集(用 ../ops-inspector/SKILL.md)。

工作流:一、清点访问路径,列出每个变更端点、任务、RPC 或 UI 流程的读写,记录过滤、连接、排序键、预期基数和请求频率,未知量标记为假设。二、联合设计模式、索引与行授权,为每个频繁过滤、连接和稳定排序做明确索引决策;用户自有行以角色作策略门、身份作行谓词,例如 CREATE POLICY orders_select_own ON public.orders FOR SELECT TO authenticated USING ((SELECT auth.uid()) = owner_id); DDL 通过版本化 applyMigration 工作流应用。三、实现有界数据库访问,批量相关键、合并重复读取、并发执行独立查询,结果用过滤加 .limit()/.range() 或键集分页 RPC 限定;日志、追踪和高量分析发往平台日志或专用分析存储。四、流量可观时检查上线容量,用 queryEnv(action="info", envId=...) 查看目标环境,报告 PG 分配、预期峰值与未决风险;CloudBase 目前要求显式容量规划,不保证自动扩缩容。

路由参考:重复调用、串行查询、轮询、分页或日志表读 references/access-patterns.md;缺索引、慢 SQL/RPC 或查询计划读 references/indexes-and-explain.md;新模式、租户隔离或 RLS 性能读 references/schema-and-rls.md;活动上线或数据库规格读 references/capacity-and-connections.md。仅加载当前分支所需参考。

限制:同级技能仅本地相对路径可用,缺失时请用户安装完整 CloudBase 插件,不要 HTTP 拉取远程技能或协议 markdown 到智能体上下文。