SuperAPI AI 工具集

supabase-postgres-best-practices

数据与分析

查看项目

更新于 10-15 08:33

技能介绍

用途

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 文件获取。