用途
Supabase Postgres Best Practices 是 Supabase 维护的一套 Postgres 性能优化指南,面向任何环境运行的 Postgres,而不仅限于 Supabase 平台。它以技能(skill)形式提供,供在编写或修改任何位于 Postgres 中的内容之前加载,用于指导自动化查询优化与 Schema 设计。
主要能力与规则分类
该指南按影响程度对 8 类规则进行优先级排序,每类规则带有前缀标识:
| 优先级 | 分类 | 影响 | 前缀 |
|---|---|---|---|
| 1 | Query Performance(查询性能) | CRITICAL | query- |
| 2 | Connection Management(连接管理) | CRITICAL | conn- |
| 3 | Security & RLS(安全与行级安全) | CRITICAL | security- |
| 4 | Schema Design(Schema 设计) | HIGH | schema- |
| 5 | Concurrency & Locking(并发与锁) | MEDIUM-HIGH | lock- |
| 6 | Data Access Patterns(数据访问模式) | MEDIUM | data- |
| 7 | Monitoring & Diagnostics(监控与诊断) | LOW-MEDIUM | monitor- |
| 8 | Advanced Features(高级特性) | LOW | advanced- |
适用时机
在以下情况参考这些准则:
- 编写 SQL 查询或设计 Schema
- 实现索引或进行查询优化
- 审查数据库性能问题
- 配置连接池或扩展
- 针对 Postgres 特有功能进行优化
- 使用行级安全(RLS)
使用方式
读取单个规则文件以获取详细解释与 SQL 示例,例如:
- references/query-missing-indexes.md
- references/query-partial-indexes.md
- references/_sections.md
每个规则文件包含:
- 关于该规则为何重要的简要说明
- 带有解释的错误 SQL 示例
- 带有解释的正确 SQL 示例
- 可选的 EXPLAIN 输出或指标
- 补充背景与参考链接
- Supabase 专属说明(在适用时)
参考资料
- https://www.postgresql.org/docs/current/
- https://supabase.com/docs
- https://wiki.postgresql.org/wiki/Performance_Optimization
- https://supabase.com/docs/guides/database/overview
- https://supabase.com/docs/guides/auth/row-level-security
限制
资料未提及收费、价格与具体安装命令,相关内容暂未提供。规则文件的具体数量、完整文件列表以及每条规则的正文内容,资料中亦未完整给出,需查阅对应 references 文件获取。