Supabase Postgres Best Practices 是一份由 Supabase 维护的 Postgres 综合性能优化指南,用于指导自动化的查询优化与模式设计。
用途:当你编写 SQL 查询或设计模式、实现索引或优化查询、排查数据库性能问题、配置连接池或扩容、针对 Postgres 特定特性做优化,以及使用行级安全(RLS)时,可参考该指南中的规则。
规则分类与优先级:规则按影响程度分为 8 个类别,并用前缀标识。
- 查询性能(CRITICAL,前缀 query-)
- 连接管理(CRITICAL,前缀 conn-)
- 安全与 RLS(CRITICAL,前缀 security-)
- 模式设计(HIGH,前缀 schema-)
- 并发与锁定(MEDIUM-HIGH,前缀 lock-)
- 数据访问模式(MEDIUM,前缀 data-)
- 监控与诊断(LOW-MEDIUM,前缀 monitor-)
- 高级特性(LOW,前缀 advanced-)
使用方式:阅读单个规则文件可获取详细说明与 SQL 示例,例如 rules/query-missing-indexes.md、rules/schema-partial-indexes.md、rules/_sections.md。每个规则文件包含:该规则为何重要的简要说明;带有解释的错误 SQL 示例;带有解释的正确 SQL 示例;可选的 EXPLAIN 输出或指标;额外上下文与参考;以及(如适用)Supabase 特定说明。
完整汇总文档:如需包含全部规则展开的完整指南,请参阅 AGENTS.md。
适用场景:编写与审查 SQL、设计模式与索引、优化查询、处理连接池与扩容、使用 Postgres 特定特性及 RLS 等。
限制:资料未提供具体安装命令、代码示例内容、价格或收费信息、平台差异细节,以及各规则的具体条文与指标数值,这些内容暂未提供。