Agent Skills
返回列表
💻

Supabase Postgres 最佳实践

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/supabase-agent-skills-supabase-postgres-best-practices。

技能介绍

你会遇到什么问题

Postgres 在 Supabase 或自建环境里一旦表变大、并发上来,常见问题很具体:慢查询拖垮 API、连接池打满、RLS 策略让计划器走偏、索引缺或冗余导致全表扫描。手工翻官方文档往往只能看到零散知识点,缺少按「影响大小」排序、可对照改 SQL 的检查清单。

技能在做什么

这是一套由 Supabase 维护 的 Postgres 性能与 schema 实践规则库,按 8 个类别、优先级从高到低 组织,前缀便于检索(如 query-、conn-、security-)。每条规则不是口号,而是固定结构:为什么重要 → 错误 SQL 与说明 → 正确写法与说明,可选 EXPLAIN 输出与 Supabase 特注。

优先级上,Query Performance、Connection Management、Security & RLS 标为 CRITICAL;Schema Design、并发与锁、数据访问模式、监控诊断、高级特性依次递减。你在写查询、设计表结构、加索引、审性能、配连接池或调 RLS 时,可按类别对照规则文件,而不是从零拼凑经验。

适用边界

它是 指南与示例集合,不会替你执行迁移或自动改库;复杂业务模型仍需结合 EXPLAIN ANALYZE 与真实负载验证。规则面向 Postgres 通用能力与 Supabase 文档语境,非 Supabase 专属运维(如计费、项目配额)不在此列。

使用场景

  • 线上接口因单条 SQL 全表扫描变慢的复盘,需要按 query- 类规则对照改写谓词与索引策略
  • 新功能上线前做 schema 评审,对照 schema- 与 data- 规则检查范式、访问路径是否会增加锁竞争
  • Supabase 项目连接数飙升,排查是否未用连接池或长事务占用,参考 conn- 类说明调整配置
  • 为表启用 RLS 后部分用户查询变慢,需要对照 security- 规则检查策略表达式与索引是否可被计划器利用

适合人员

  • 负责 Supabase/Postgres 后端、要在代码评审里系统化抓慢 SQL 与缺索引的全栈工程师
  • 每周处理客户库性能工单、需要可引用错误/正确 SQL 示例的 DBA 或平台数据库支持
  • 在 Supabase 上设计多租户 schema 并配置 RLS、担心策略拖慢查询的安全或后端负责人
  • 从单机 Postgres 迁到 Supabase 连接池模式、需理清连接与事务最佳实践的技术负责人