核心概述
本 skill 是一份面向生产环境的 PostgreSQL 综合开发手册，内容覆盖数据库设计的全生命周期：从数据类型选择、schema 规范到复杂查询优化和运维管理。
核心用法
数据类型与 Schema 设计：推荐 BIGINT GENERATED ALWAYS AS IDENTITY 作为主键（避免 SERIAL 的序列归属问题），强制使用 TIMESTAMPTZ 存储时间，JSON 场景优先 JSONB 并配合 GIN 索引。schema 规范要求外键必建索引、非空约束默认、CHECK 约束承载业务规则。
迁移安全（Expand-Contract 模式）：核心亮点是零停机变更策略——通过"扩展-迁移-收缩"三阶段实现列/表的重命名和删除，避免单步变更导致的部署期故障。强调 CREATE INDEX CONCURRENTLY、分批 backfill（SKIP LOCKED）等操作规范。
索引策略：系统化指导 B-tree、GIN、GiST、BRIN 的选型，涵盖复合索引列序、部分索引、覆盖索引（INCLUDE）、表达式索引等高级技巧，并提供未索引外键的检测脚本。
高级特性：包括 RLS（行级安全）的性能优化技巧（标量子查询缓存）、分区表设计（RANGE/LIST/HASH）、pgvector 向量搜索（HNSW/IVFFlat 索引选型）、以及连接池（PgBouncer 事务模式）的注意事项。
查询优化：强调 EXPLAIN (ANALYZE, BUFFERS) 的必用原则，提供 CTE 控制、游标分页、EXISTS 优于 IN、近似计数等实用模式，附带慢查询、表膨胀、未使用索引的检测脚本。
显著优点
- 生产导向：所有建议均围绕高可用、零停机、性能可观测性展开，而非基础语法教学
- 反模式清单：明确列出
SELECT *、OFFSET分页、ORDER BY RANDOM()等常见问题及修复方案 - 安全内嵌：RLS 强制启用、public schema 权限回收、迁移不可变性等安全实践贯穿全文
- 现代特性覆盖：包含 PG15+ 的
NULLS NOT DISTINCT、PG13+ 的gen_random_uuid()、pgvector 扩展等较新能力
潜在局限
- 版本依赖：部分特性（如
CONCURRENTLY索引、某些 RLS 优化）需要较新 PG 版本，老版本需调整 - 场景聚焦：专为 OLTP 及混合负载设计，纯 OLAP 场景可能需要补充列式存储方案
- 扩展生态：pgvector 等内容依赖第三方扩展，非官方核心功能
- 云托管差异：部分底层调优（如 WAL、复制）在不同托管服务（RDS、Aurora、AlloyDB）中可控性不同
适合人群
- 后端工程师进行 schema 设计和查询优化
- DBA 或 SRE 负责生产数据库运维和性能调优
- 架构师制定数据层技术规范和迁移策略
常规风险
- RLS 性能陷阱：策略表达式每行求值，复杂逻辑未优化可能导致严重性能退化
- 迁移顺序错误：跳过 expand-contract 模式直接重命名/删除列，将引发生产事故
- 连接池模式误配：PgBouncer 的
statement模式与会话级功能（advisory locks、临时表）不兼容 - 向量索引误用：未预过滤直接进行向量搜索会产生大量无效计算，内存消耗高
本 skill 作为 PostgreSQL 生产的权威参考，建议结合实际执行计划验证（EXPLAIN）和监控指标（pg_stat_statements）持续调优。