name: supabase-postgres-best-practices description: Postgres性能优化和Supabase的最佳实践。在编写、审查或优化Postgres查询、schema设计或数据库配置时使用此技能。 license: MIT metadata: author: supabase version: “1.0.0”
Supabase Postgres 最佳实践
由Supabase维护的Postgres全面性能优化指南。包含8个类别的规则，按影响优先级排序，以指导自动查询优化和schema设计。
应用时机
在以下情况下参考这些指南：
- 编写SQL查询或设计schema
- 实现索引或查询优化
- 审查数据库性能问题
- 配置连接池或扩展
- 优化Postgres特定功能
- 使用行级安全（RLS）
规则类别按优先级
| 优先级 | 类别 | 影响 | 前缀 |
|---|---|---|---|
| 1 | 查询性能 | 关键 | query- |
| 2 | 连接管理 | 关键 | conn- |
| 3 | 安全与RLS | 关键 | security- |
| 4 | Schema设计 | 高 | schema- |
| 5 | 并发与锁定 | 中-高 | lock- |
| 6 | 数据访问模式 | 中 | data- |
| 7 | 监控与诊断 | 低-中 | monitor- |
| 8 | 高级功能 | 低 | advanced- |
如何使用
阅读单个规则文件以获取详细解释和SQL示例：
rules/query-missing-indexes.md
rules/schema-partial-indexes.md
rules/_sections.md
每个规则文件包含：
- 简要解释为什么重要
- 错误SQL示例及解释
- 正确SQL示例及解释
- 可选的EXPLAIN输出或指标
- 附加上下文和参考
- Supabase特定说明（如适用）
完整编译文档
要获取完整指南及所有规则展开：AGENTS.md