用途
Supabase Postgres Best Practices 是一份由 Supabase 维护的 Postgres 综合性能优化指南,以技能(skill)形式提供。它包含跨 8 个类别的规则,按影响程度排序,用于指导自动化的查询优化与模式设计。
何时适用
在以下场景中可参考这些指南:
- 编写 SQL 查询或设计数据库模式
- 实现索引或进行查询优化
- 排查数据库性能问题
- 配置连接池或扩展
- 针对 Postgres 特有功能进行优化
- 使用行级安全(RLS)
规则类别与优先级
规则按优先级和影响程度分为以下类别,每类使用对应前缀:
| 优先级 | 类别 | 影响 | 前缀 |
|---|---|---|---|
| 1 | 查询性能 | CRITICAL | query- |
| 2 | 连接管理 | CRITICAL | conn- |
| 3 | 安全与 RLS | CRITICAL | security- |
| 4 | 模式设计 | HIGH | schema- |
| 5 | 并发与锁 | MEDIUM-HIGH | lock- |
| 6 | 数据访问模式 | MEDIUM | data- |
| 7 | 监控与诊断 | LOW-MEDIUM | monitor- |
| 8 | 高级功能 | LOW | advanced- |
使用方式
阅读各个规则文件以获取详细说明和 SQL 示例,例如:
- rules/query-missing-indexes.md
- rules/schema-partial-indexes.md
- rules/_sections.md
每个规则文件包含:
- 简要说明为何重要
- 错误的 SQL 示例及解释
- 正确的 SQL 示例及解释
- 可选的 EXPLAIN 输出或指标
- 补充背景与参考
- Supabase 特定说明(如适用)
完整编译文档
如需包含所有规则展开的完整指南,请参阅 AGENTS.md。
限制
资料中未提供该技能的具体安装命令、收费方式、支持平台或实际使用效果等信息,暂未提供。