name: supabase-postgres-best-practices description: 来自Supabase的Postgres性能优化和最佳实践。在编写、审查或优化Postgres查询、模式设计或数据库配置时使用此技能。 license: MIT metadata: author: supabase version: “1.1.0” organization: Supabase date: 2026年1月 abstract: 面向使用Supabase和Postgres的开发者的全面Postgres性能优化指南。包含8个类别的性能规则,按影响优先级从关键(查询性能、连接管理)到增量(高级功能)排序。每个规则包括详细解释、错误与正确的SQL示例、查询计划分析以及具体的性能指标,以指导自动优化和代码生成。
Supabase Postgres 最佳实践
由Supabase维护的Postgres全面性能优化指南。包含8个类别的规则,按影响优先级排序,以指导自动化查询优化和模式设计。
何时应用
在以下情况下参考这些指南:
- 编写SQL查询或设计模式
- 实现索引或查询优化
- 审查数据库性能问题
- 配置连接池或扩展
- 为Postgres特定功能进行优化
- 使用行级安全性(RLS)
按优先级分类的规则类别
| 优先级 | 类别 | 影响 | 前缀 |
|---|---|---|---|
| 1 | 查询性能 | 关键 | query- |
| 2 | 连接管理 | 关键 | conn- |
| 3 | 安全与RLS | 关键 | security- |
| 4 | 模式设计 | 高 | schema- |
| 5 | 并发与锁 | 中高 | lock- |
| 6 | 数据访问模式 | 中 | data- |
| 7 | 监控与诊断 | 低中 | monitor- |
| 8 | 高级功能 | 低 | advanced- |
如何使用
阅读单个规则文件以获取详细解释和SQL示例:
references/query-missing-indexes.md
references/schema-partial-indexes.md
references/_sections.md
每个规则文件包含:
- 简要解释为什么重要
- 错误的SQL示例及解释
- 正确的SQL示例及解释
- 可选的EXPLAIN输出或指标
- 额外上下文和引用
- Supabase特定说明(如果适用)