数据库目录 / PostgreSQL
PostgreSQL 官方文档目录
功能完善的开源对象关系型数据库,MVCC、扩展生态、逻辑复制与丰富的索引类型是其核心优势。
文档章节
- 文档总览 — 当前版本与历史版本的官方手册入口。
- 安装与配置 — 源码与包管理安装、initdb 与 postgresql.conf。
- SQL 命令参考 — 完整 SQL 语法、命令与数据类型说明。
- 备份与恢复 — pg_dump、pg_basebackup、PITR 与 WAL 归档。
- 复制与高可用 — 流复制、逻辑复制、复制槽与故障转移。
- 性能调优 — EXPLAIN、统计信息、VACUUM 与参数调优。
- 安全 — 认证方式、角色权限、行级安全与 SSL。
- 常见问题 · 版本升级 — 升级前先读目标版本发行说明与不兼容变更,完成备份和回滚演练,再按“测试库→从库→主库”的顺序灰度执行。 大版本升级需 pg_upgrade 或逻辑复制,升级前必须运行 pg_upgrade --check。
- 常见问题 · 连接与网络 — 按“客户端→DNS→网络→端口→认证→权限”的顺序逐层验证,先用 telnet/nc 确认端口可达,再查服务端监听与认证日志。 检查 listen_addresses、pg_hba.conf 与 max_connections;连接拒绝常与 pg_hba 规则顺序有关。
- 常见问题 · 账号与权限 — 按最小权限原则拆分管理账号、应用账号与只读账号,禁止应用使用超级用户;权限问题先确认认证方式,再查对象级授权与角色继承。 权限由 GRANT/REVOKE 与默认权限控制,还需检查 schema 的 USAGE 与函数执行权限。
- 常见问题 · 集群与扩缩容 — 扩缩容前先确认分片键与数据分布,评估迁移带宽与业务低峰窗口;扩容后要触发再均衡并观察热点、复制延迟与连接路由。 PostgreSQL 的具体命令与视图请以官方文档对应章节为准。
- 常见问题 · 索引设计 — 索引要围绕真实查询模式设计:先保证等值与排序字段顺序正确,再控制索引数量与写入成本;定期清理未使用索引并更新统计信息。 支持 B-tree、Hash、GIN、GiST、BRIN;高写入表谨慎增加索引。
- 常见问题 · 锁与死锁 — 先找到持锁会话与等待链,再判断是长事务、缺失索引导致锁范围扩大,还是 DDL 与业务事务冲突;优先缩短事务,终止会话只作为最后手段。 pg_locks 联合 pg_stat_activity 查询;关注 idle in transaction 与 lock_timeout。
- 常见问题 · 事务与隔离级别 — 隔离级别越高一致性越强但并发越低;先确认业务能接受的异常(脏读、不可重复读、幻读),再选择级别并用锁等待与死锁指标验证。 默认 READ COMMITTED,支持 SERIALIZABLE 可串行化快照隔离,冲突时应用需重试。
- 常见问题 · 表空间与磁盘空间 — 先确认是数据增长、日志膨胀、临时文件还是删除后未回收;再选择归档、清理、重建或扩容,避免在业务高峰做高 IO 操作。 VACUUM 回收死元组,膨胀严重时用 pg_repack 在线重整;WAL 目录膨胀检查复制槽。
- 常见问题 · 内存与缓存 — 先区分数据缓存、连接内存、排序/临时内存与内存泄漏,再结合命中率与换页情况判断是容量不足还是参数不合理。 shared_buffers 只是一部分,work_mem 会乘以并发排序节点,需重点控制。
- 常见问题 · 连接数治理 — 连接数打满先看活跃连接与空闲连接比例,再定位连接池配置、慢查询占用与连接泄漏;盲目调大上限可能压垮数据库。 pg_stat_activity 按 state 与 application_name 统计;连接池建议使用 PgBouncer。
- 常见问题 · 字符集与排序规则 — 乱码通常来自客户端、连接、库表与存储四层字符集不一致;先确认全链路编码,再决定转换或重建,避免直接修改生产表字符集。 数据库编码创建后不可随意修改,需 initdb 或逻辑迁移;排序规则依赖 collation 与 ICU。
- 常见问题 · 分区与数据归档 — 先按时间或业务维度评估查询与清理模式,再选择分区、归档表或冷热分离;清理必须可回滚、可审计,并避免大事务与长时间锁表。 声明式分区支持 ATTACH/DETACH,配合 pg_partman 自动管理;归档可结合外部存储。
- 常见问题 · 监控与告警 — 监控要覆盖可用性、连接、容量、复制、锁等待、慢查询与错误日志;告警必须有阈值、分级、抑制与处置手册,避免告警疲劳。 postgres_exporter 关注连接、事务年龄、复制槽与检查点。
- 常见问题 · 数据迁移 — 迁移分为结构、存量数据、增量同步与割接四步;先做兼容性评估与试迁移,再用校验和/抽样比对保证一致,最后准备回滚方案。 pg_dump/pg_restore 或逻辑复制,注意 sequence、extension 与 owner。
- 常见问题 · 错误码速查 — 报错先记录完整错误码、SQLSTATE 与上下文,再按官方错误手册定位;不要只看最后一层报错,应用、驱动与代理层都可能改写错误。 SQLSTATE 五字符编码是定位核心,服务端日志包含 DETAIL/HINT。
- 常见问题 · 性能压测 — 压测要模拟真实读写比例、数据量与并发,逐步加压倒拐点;关注 P95/P99 延迟、错误率与资源瓶颈,而不是只看峰值 TPS。 pgbench 可自定义脚本;关注 WAL 生成、检查点与连接数。
- 常见问题 · 索引设计与失效 — 先按查询模式设计联合索引,遵循最左前缀与选择性优先;上线后用执行计划验证是否真正命中,避免函数、隐式转换与范围条件导致失效。 优先 B-Tree,按需使用部分索引与表达式索引;用 EXPLAIN (ANALYZE, BUFFERS) 确认 Index Scan 与回表代价。
- 常见问题 · 统计信息与执行计划 — 优化器依赖统计信息估算行数,统计过期或分布倾斜会导致计划突变;大表变更后及时收集统计信息,并对关键 SQL 固定或监控执行计划。 autovacuum 负责 ANALYZE;对倾斜列提高 statistics target,用 pg_stats 检查 n_distinct 与直方图。
- 常见问题 · 分区表与冷热分离 — 分区用于管理大表与历史数据,不必然提升查询性能;按时间或业务维度分区,并确保查询条件能命中分区裁剪,冷数据及时归档或降冷存储。 使用声明式分区,配合 pg_partman 自动建分区;注意全局索引与分区索引的差异。
- 常见问题 · 账号权限与最小授权 — 按角色分配权限,应用账号只授予必要对象的 DML 权限,禁止使用超级账号连接业务;定期回收闲置账号与过高权限,并保留变更记录。 用角色与 GRANT 控制库、模式与表权限,默认 public 模式权限要收紧。
- 常见问题 · 审计日志与合规 — 审计要明确目标:登录、DDL、敏感数据访问与权限变更;只审计必要范围,日志独立存储并设置留存周期,避免审计表写满业务表空间。 通过 pgaudit 扩展记录语句级审计,结合 log_statement 与 log_connections。
- 常见问题 · 在线 DDL 与大表变更 — 大表变更先确认是否支持 Online DDL、是否会锁表与重建表;优先在低峰执行,必要时使用 gh-ost、pt-online-schema-change 或原生在线变更工具。 加列带默认值在 11+ 为快速操作;加索引用 CREATE INDEX CONCURRENTLY,注意失败残留无效索引。
- 常见问题 · 主从与副本延迟 — 复制延迟先区分网络、主库写入压力、从库回放能力与锁冲突;优先解决大事务与无主键批量更新,再考虑并行复制与硬件升级。 用 pg_stat_replication 看 replay_lag,关注长事务、max_wal_senders 与恢复冲突。
- 常见问题 · 容量规划与磁盘治理 — 容量规划按数据增长、日志增长与备份保留三部分测算;保持磁盘水位低于 70%,对日志与临时空间单独监控,预留扩容与归档时间窗。 关注 pg_wal、临时文件与表膨胀;用 pg_database_size 与 pg_total_relation_size 监控增长。
- 常见问题 · 数据归档与清理 — 归档按业务保留策略执行,优先用分区切换或分批删除,避免一次性大事务;归档前校验一致性,归档后保留可追溯的校验与恢复手段。 用分区 DETACH/DROP 快速归档;批量删除后 VACUUM,避免膨胀。
- 常见问题 · 连接池与短连接 — 连接池大小按数据库并发处理能力与单条 SQL 耗时估算,不是越大越好;短连接会放大握手与认证开销,应用侧必须复用连接并设置合理的最大连接与空闲回收。 每连接对应一个进程,连接数过高会放大内存与上下文切换;建议引入 PgBouncer。
- 常见问题 · 数据导入导出与迁移 — 迁移先确认字符集、类型映射与自增/序列策略,使用一致性快照导出;导入时关闭非必要约束与索引、分批提交,最后做行数与校验和比对。 pg_dump 自定义格式配合 pg_restore 并行恢复;大库可用逻辑复制做增量追平。
相关知识条目
- PostgreSQL 的 VACUUM 有什么作用?理解死元组清理、可见性映射与事务冻结,区分普通 VACUUM 和 VACUUM FULL 的代价。
- PostgreSQL 锁等待与阻塞如何定位?用 pg_blocking_pids 还原阻塞链,结合事务时长与语句决定安全的处理方式。
- PostgreSQL 报 sorry, too many clients already 如何恢复?区分连接池配置过大、空闲连接不释放与长事务占用,先释放异常会话,再调整 max_connections 与连接池。
- PostgreSQL 出现 idle in transaction 与锁阻塞怎么办?idle in transaction 会长期持有快照与锁并阻止 vacuum,先定位事务为何不结束,再终止异常会话并设置空闲事务超时。
- PostgreSQL WAL 目录暴涨导致磁盘满如何处理?先区分归档失败、复制槽滞留与检查点过慢三类原因,再恢复归档或清理失效复制槽,避免直接删除 pg_wal 文件。
- PostgreSQL 复制槽导致 WAL 无法释放怎么办?确认复制槽是否仍被订阅或备库使用,评估丢失该槽的影响后再删除;活跃槽应修复消费端而不是直接清理。