supabase-postgres-best-practices

Supabase Postgres Best Practices - 数据库性能优化权威指南

技能概述

Supabase Postgres Best Practices 是一套全面的数据库性能优化指南，提供 8 大类共 60+ 条经过验证的优化规则，帮助开发者快速定位和解决 Postgres 性能瓶颈。

适用场景

编写和优化 SQL 查询

在开发过程中自动检测查询中的性能问题，如缺少索引、N+1 查询、低效的 JOIN 操作等，获取具体的优化建议和改进后的 SQL 示例。

设计和优化数据库 Schema

在项目初期或重构阶段，根据业务场景选择合适的索引类型（B-tree、Hash、GIN 等），设计符合最佳实践的表结构，避免常见的反模式。

排查生产环境性能问题

当数据库出现慢查询、连接池耗尽、锁等待等问题时，通过规则优先级快速定位最关键的性能瓶颈，获取针对性的解决方案。

核心功能

按优先级分类的优化规则

将 60+ 条优化规则分为 8 个类别（查询性能、连接管理、安全与 RLS、Schema 设计等），按影响程度标记为 CRITICAL、HIGH、MEDIUM 等优先级，帮助开发者优先解决最严重的问题。

Supabase 专项优化建议

除了通用的 Postgres 最佳实践外，还包含 Supabase 特定的优化建议，如 Row-Level Security（RLS）策略的性能影响、连接池配置、API 响应优化等。

完整的 SQL 示例和解释

每条规则都包含错误示例和正确示例的对比，附带 EXPLAIN 输出分析和性能指标，让开发者不仅知道怎么做，还理解为什么。

常见问题

这个技能适合初学者使用吗？

适合。规则文档提供了详细的解释和 SQL 示例，即使没有深厚的数据库背景也能理解。建议从标记为 CRITICAL 和 HIGH 优先级的规则开始学习，这些是影响最大的优化点。

和官方 Postgres 文档有什么区别？

官方文档侧重于功能说明和语法参考，而本技能专注于性能优化实战，基于 Supabase 维护的生产环境经验总结，提供更贴近实际开发场景的优化建议。

规则会自动应用到我的数据库吗？

不会。这是一个参考指南，需要你根据规则建议手动修改 SQL 或 Schema。可以配合代码审查流程使用，在合并 PR 时检查是否符合最佳实践。