最佳实践
- 作者仓库星标 2,180
- 许可证 MIT
- 作者仓库 agent-skills
- 领域
- 设计与多媒体
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 94 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @supabase · MIT
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Supabase Postgres Best Practices
Comprehensive performance optimization guide for Postgres, maintained by Supabase. Contains rules across 8 categories, prioritized by impact to guide automated query optimization and schema design.
## When to Apply
Reference these guidelines when:
- Writing SQL queries or designing schemas
- Implementing indexes or query optimization
- Reviewing database performance issues
- Configuring connection pooling or scaling
- Optimizing for Postgres-specific features
- Working with Row-Level Security (RLS)
## Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Query Performance | CRITICAL | `query-` |
| 2 | Connection Management | CRITICAL | `conn-` |
| 3 | Security & RLS | CRITICAL | `security-` |
| 4 | Schema Design | 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-` |
## How to Use
Read individual rule files for detailed explanations and SQL examples:
```
references/query-missing-indexes.md
references/query-partial-indexes.md
references/_sections.md
```
Each rule file contains:
- Brief explanation of why it matters
- Incorrect SQL example with explanation
- Correct SQL example with explanation
- Optional EXPLAIN output or metrics
- Additional context and references
- Supabase-specific notes (when applicable)
## References
- 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
章节与文件索引
按说明文件中的顺序排列。
何时申请
按优先级划分的规则类别
如何使用
参考文献
文件/命令 -> query- · conn- · security- · schema- · lock- · data- · monitor- · advanced-
内容校验值 -> 4c09f08e0007
当前原文的自动摘译,尚未人工审校。
何时申请
在以下情况下请参考这些指南: 编写 SQL 查询或设计架构 实施索引或查询优化 检查数据库性能问题 配置连接池或扩展
按优先级划分的规则类别
优先级 · 类别 · 影响 · 前缀 1 · 查询性能 · 关键 ·
query-2 · 连接管理 · 关键 ·conn-3 · 安全性和 RLS · 关键 ·security-4 · 架构设计 · 高 ·schema-如何使用
阅读各个规则文件以获取详细说明和 SQL 示例: 每个规则文件包含: 简要说明其重要性 不正确的 SQL 示例及其说明 正确的 SQL 示例及其说明
参考文献
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