supabase-postgres-best-practices

Supabase Postgres 最佳实践

适用场景

当你需要 Supabase 提供的 Postgres 性能优化和最佳实践时，请使用此技能。在编写、审查或优化 Postgres 查询、架构设计或数据库配置时，也请使用此技能。

这是一份由 Supabase 维护的 Postgres 全面性能优化指南，涵盖 8 个类别的规则，并按影响程度排序，以指导自动化查询优化和架构设计。

适用时机

以下情况请参考这些指南：

• 编写 SQL 查询或设计架构
• 创建索引或优化查询
• 排查数据库性能问题
• 配置连接池或扩展规模
• 针对 Postgres 特定功能进行优化
• 使用行级安全（RLS）

执行与证据边界

SQL 仅作示例，不是修改实时数据库的指令。在执行 DDL/DML、全局设置、重置或扩展变更前，请确认目标、权限、锁、备份和回滚方案。EXPLAIN ANALYZE 会执行其语句，即使是 SELECT 也可能触发副作用；请先检查，并在必要时使用一次性环境。本文中的所有提速效果、行数、内存估算和执行计划输出均为示例，不是经过测量的保证值。请对等效工作负载进行基准测试，并在优化时保留 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/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

限制

• 仅当任务明确符合其上游产品或 API 的适用范围时，才使用此技能。
• 进行更改前，请根据当前官方文档核实命令、API 行为、价格、配额、凭据和部署影响。
• 不要将生成的示例视为环境特定测试、安全审查或破坏性操作及高成本操作所需用户批准的替代品。