postgres-patterns

何时使用

当你在写 PostgreSQL 查询、设计表结构、或者排查慢查询时触发此 Skill。

核心能力

查询优化

• 用 EXPLAIN ANALYZE 分析执行计划，关注 Seq Scan vs Index Scan
• 避免 SELECT *，只查需要的列
• IN 大列表改 JOIN 或 EXISTS
• 分页用 keyset pagination（WHERE id > last_id）替代 OFFSET

Schema 设计

• 主键用 BIGSERIAL 或 UUID v7，避免 SERIAL 溢出
• 大文本用 TEXT，不用 VARCHAR(n) 限制长度
• JSON 存储用 JSONB，支持 GIN 索引
• 时间用 TIMESTAMPTZ，不存无时区时间

索引策略

• 高选择性列建 B-tree，低选择性用部分索引（Partial Index）
• 多条件查询用复合索引，列顺序遵循等值 → 范围 → 排序
• JSONB 字段用 GIN 索引
• 频繁更新的列少建索引，写入开销大

安全

• 永远用参数化查询，禁止字符串拼接 SQL
• 行级安全（RLS）控制多租户数据隔离