SuperAPI AI 工具集

postgres-best-practices

数据与分析

查看项目

更新于 10-15 09:22

技能介绍

用途

本技能是一份由 Supabase 维护的 Postgres 综合性能优化指南,用于指导自动化的查询优化与数据库模式设计。它把最佳实践整理为按影响程度排序的规则集,帮助在编写、审查或优化 Postgres 查询、模式设计及相关配置时获得一致的参考依据。

主要能力

规则按优先级分为 8 个类别,每个类别带有统一前缀,便于检索与引用:

优先级 类别 影响 前缀
1 查询性能 CRITICAL query-
2 连接管理 CRITICAL conn-
3 安全与 RLS CRITICAL security-
4 模式设计 HIGH schema-
5 并发与锁 MEDIUM-HIGH lock-
6 数据访问模式 MEDIUM data-
7 监控与诊断 LOW-MEDIUM monitor-
8 高级功能 LOW advanced-

每条规则文件通常包含:该规则为何重要的简要说明、带有解释的错误 SQL 示例、带有解释的正确 SQL 示例、可选的 EXPLAIN 输出或指标、补充背景与参考,以及在适用时给出的 Supabase 专属说明。

使用方式

在以下情形参考这些指南:编写 SQL 查询或设计模式;实现索引或进行查询优化;审查数据库性能问题;配置连接池或扩展;针对 Postgres 特有功能进行优化;处理行级安全(RLS)。

可按需阅读单条规则文件以获取详细说明与 SQL 示例,例如:

  • rules/query-missing-indexes.md
  • rules/schema-partial-indexes.md
  • rules/_sections.md

如需包含全部规则展开的完整指南,请参阅 AGENTS.md。

适用场景

适用于与 Postgres 查询编写、模式设计、索引与查询优化、连接池与扩展配置、性能问题排查、Postgres 特有功能优化以及行级安全(RLS)相关的任务。

限制

仅在任务明确符合上述范围时使用本技能。不要将输出视为针对具体环境的验证、测试或专家评审的替代品。若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。