被动故障切换
节点宕机，导致领导者租约过期触发集群领导竞选的故障路径
Module: PGSQL
默认配置模板的参数优化策略说明
了解在 Pigsty 中，预置的四种 Patroni 场景化模板所采用的不同参数优化策略
管理 PostgreSQL 数据库集群
创建/销毁 PostgreSQL 集群，以及对现有集群进行扩容，缩容，克隆集群。
集群实例
根据需求场景选择合适的实例与集群类型，配置出满足需求的 PostgreSQL 数据库集群。
OLTP 模板
针对在线事务处理负载优化的 PostgreSQL 配置模板
内核版本
如何选择合适的 PostgreSQL 内核与大版本。
管理 PostgreSQL 业务用户
用户管理：创建、修改、删除用户，管理角色成员关系，连接池用户配置
主动故障检测
PostgreSQL 主库进程崩溃，Patroni 存活并尝试重启，超时后触发故障切换的路径
OLAP 模板
针对在线分析处理负载优化的 PostgreSQL 配置模板
别名翻译
Pigsty 提供软件包别名翻译机制，可以屏蔽底层操作系统的二进制包细节差异，让安装更简易。
管理 PostgreSQL 业务数据库
数据库管理：创建、修改、删除、重建数据库，使用模板克隆数据库
CRIT 模板
面向一致性优先业务的 PostgreSQL 参数模板，启用严格同步复制、数据校验和详细连接日志。
管理 Patroni 高可用
使用 Patroni 管理 PG 集群高可用，包括，修改参数，查看状态，主从切换，重启，重做从库等操作。
用户/角色
如何通过配置来定制所需 PostgreSQL 用户与角色？
TINY 模板
针对微型实例和资源受限环境优化的 PostgreSQL 配置模板
Pgbouncer 连接池管理
使用 Pgbouncer 管理连接池，包括暂停、恢复、禁用、启用、重连、终止、重载等操作。
数据库
如何通过配置来定制所需 PostgreSQL 数据库？
HBA 规则
Pigsty 中 PostgreSQL 与 PgBouncer 的 HBA（Host-Based Authentication）规则配置参考。
参数配置
如何配置集群、实例、用户和数据库级别的 PostgreSQL 参数
访问控制
Pigsty 内置角色、用户、默认权限与数据库 ACL 的配置参考。
管理 PostgreSQL 组件服务
使用 systemctl 管理 PostgreSQL 集群中的各个组件服务：启动、停止、重启、重载与状态检查。
管理 PostgreSQL 定时任务
配置 Crontab 定期调度 PostgreSQL 备份任务，执行备份 / Vacuum Freeze / Analyze 任务，以及处理表膨胀
升级 PostgreSQL 大小版本
版本升级：小版本滚动升级、大版本迁移、扩展升级
管理 PostgreSQL 扩展插件
扩展管理：下载、安装、配置、启用、更新、卸载扩展
PG 高可用
Pigsty 使用 Patroni 实现了 PostgreSQL 的高可用，确保主库不可用时自动进行故障转移，由从库接管。
RPO 利弊权衡
针对 RPO （Recovery Point Objective）进行利弊权衡，在可用性与数据损失之间找到最佳平衡点。
PGSQL 架构
PostgreSQL 模块的组件交互与数据流。
RTO 利弊权衡
针对 RTO （Recovery Time Objective）进行利弊权衡，在故障恢复速度与误切风险之间找到最佳平衡点。
故障切换模型
详细分析三种经典故障检测/恢复路径下，最差，最优，平均 RTO 的计算逻辑与结果
时间点恢复 —— 数据库的时间机器（PITR）
高可用解决"机器坏了"，时间点恢复解决"数据错了"。Pigsty 基于 pgBackRest 提供开箱即用的 PITR 能力，让您可以将集群回滚至恢复窗口内的任意时刻，为人为失误与软件缺陷兜底。
时间点恢复的工作原理
快照与历史、恢复窗口、恢复目标与时间线：理解 PITR 的四个核心概念，建立正确的心智模型。
时间点恢复的实现架构
Pigsty 以 pgBackRest 为引擎实现 PITR：仓库抽象、归档链路、调度机制，以及"备份跟随主库"的工程设计。
时间点恢复的策略权衡
备份是一份保险：备在哪里决定容灾等级，保留多久决定恢复窗口，多久备一次决定恢复速度 —— 三个问题定义一份备份策略。
声明式恢复
恢复不该是深夜里的十几步手工操作：用 pg_pitr 参数声明想回到的时刻，由 pgsql-pitr.yml 剧本或 pig 命令行工具编排执行。
时间点恢复的典型场景
误删数据、发布事故、审计取证、机房灾难 —— 事故发生时如何选择恢复目标与恢复方式，以及为什么要把事故排练成例行演练。
安全合规
Pigsty 以安全即代码的方式管理认证、授权、加密、审计与备份恢复，并提供从默认配置到生产加固的清晰路径。
安全模型
Pigsty 的信任边界与纵深防御体系：管理节点作为高信任控制面，从默认基线逐步完成生产加固。
身份认证
Pigsty 以声明式方式管理 PostgreSQL 与 PgBouncer 的 HBA 规则，配合 SCRAM 密码与客户端证书，回答“谁能连进来、如何证明身份”。
访问控制
Pigsty 内置四层角色模型与默认权限模板，将最小权限原则落实为可声明、可复用的集群配置。
加密通信
Pigsty 内置自签名 CA，为受管组件签发证书并分发信任，提供统一的 TLS 基础设施。
数据安全
使用校验和、备份与 PITR、加密和审计日志保护 PostgreSQL 数据的完整性、可恢复性、保密性与可追溯性。
合规实践
合规是配置、流程与证据的组合：上线加固清单、等保与 SOC 2 控制点映射、供应链完整性与漏洞响应机制。
快速上手 PostgreSQL
快速上手 PostgreSQL，使用命令行与图形客户端连接上 PostgreSQL 并开始使用。
运维 SOP 索引
面向新手用户的 Pigsty 与 PostgreSQL 运维文档索引：按常见任务找到应读文档。
模块：PGSQL
如何使用 Pigsty 部署并管理世界上最先进的开源关系型数据库 —— PostgreSQL，按需定制，开箱即用！
配置指南
PGSQL 集群模型
介绍 Pigsty 中 PostgreSQL 集群的实体-关系模型，E-R 关系图，实体释义与命名规范。
集群配置
根据需求场景选择合适的实例与集群类型，配置出满足需求的 PostgreSQL 数据库集群。
服务/接入
分离读写操作，正确路由流量，稳定可靠地交付 PostgreSQL 集群提供的能力。
PostgreSQL 安全
PostgreSQL 身份认证、访问控制、加密通信、数据保护与安全运维入口。
用户/角色
用户/角色指的是使用 SQL 命令 CREATE USER/ROLE 创建的，数据库集簇内的逻辑对象。
数据库
数据库指的是使用 SQL 命令 CREATE DATABASE 创建的，数据库集簇内的逻辑对象。
服务/接入
分离读写操作，正确路由流量，稳定可靠地交付 PostgreSQL 集群提供的能力。
认证 / HBA
Pigsty 中基于主机的身份认证 HBA（Host-Based Authentication）详解。
访问控制
PostgreSQL 访问控制的概念、配置与管理入口。
管理任务
日常管理
数据库日常管理任务标准操作指南（SOP）
故障排查
常见故障与分析排查思路
误删处理
处理误删数据，误删表，误删数据库
数据迁移
如何将现有的 PostgreSQL 集群以最小的停机时间迁移至新的、由 Pigsty 管理的 PostgreSQL 集群？
参考资料
监控系统
Pigsty 监控系统架构概览，以及如何监控现存的 PostgreSQL 实例？
监控面板
Pigsty 为 PostgreSQL 提供了诸多开箱即用的 Grafana 监控仪表盘
指标列表
Pigsty PGSQL 模块提供的完整监控指标列表与释义
3坏2应急处理
高可用典型场景处理预案：三节点坏了两个节点，高可用不生效了，怎么从紧急状态中恢复？
使用 VIP-Manager 为 PostgreSQL 集群配置二层 VIP
Citus 集群部署
如何部署 Citus 高可用分布式集群？
预置剧本
如何使用 ansible 剧本来管理 PostgreSQL 集群
扩展插件
利用 PostgreSQL 扩展的协同超能力
PostgreSQL
带有 531 扩展的原版 PostgreSQL 内核
Citus
使用 Pigsty 部署原生高可用的 Citus 水平分片集群，将 PostgreSQL 无缝伸缩到多套分片并加速 OLTP/OLAP 查询。
Babelfish
在 Pigsty 中使用 Babelfish（PG17/18）提供 SQL Server 协议/T-SQL 兼容能力
IvorySQL
使用瀚高开源的 IvorySQL 内核，基于 PostgreSQL 集群实现 Oracle 语法/PLSQL 兼容性。
PolarDB PG
使用阿里云开源的 PolarDB for PostgreSQL 内核提供国产信创资质支持，与类似 Oracle RAC 的使用体验。
PolarDB Oracle
使用阿里云商业版本的 PolarDB for Oracle 内核（闭源，PG14，仅在特殊企业版定制中可用）
Percona
支持 TDE 透明加密的 Percona Postgres 发行版
openHalo
MySQL 兼容的 Postgres 14 分支
Greenplum
使用 Pigsty 部署/监控 Greenplum 集群，构建大规模并行处理（MPP）的 PostgreSQL 数据仓库集群！
OrioleDB
PostgreSQL 的下一代 OLTP 引擎
Cloudberry
在 Pigsty 中使用 Cloudberry 开源 MPP 数仓内核，通过 gpsql 模式统一纳管节点、监控与配置。
Neon
使用 Neon 开源的 Serverless 版本 PostgreSQL 内核，自建灵活伸缩，Scale To Zero，灵活分叉的 PG 服务。
AgensGraph
在 Pigsty 中使用 AgensGraph（PG17）图数据库内核，在 PostgreSQL 体系内获得属性图与 Cypher/SQL 混合查询能力。
pgEdge
在 Pigsty 中使用 pgEdge（PG15~18）内核，借助 Spock 多主逻辑复制构建面向边缘场景的分布式 PostgreSQL。
场景模板
使用 Pigsty 预置的四种场景化 Patroni 模版，或者基于这些模板自定义您的配置模板
内核分支
如何在 Pigsty 中使用其他 PostgreSQL 内核分支？例如 Citus，Babelfish，IvorySQL，PolarDB 等
快速开始
使用扩展的四步流程速览
扩展简介
PostgreSQL 扩展的核心概念与 Pigsty 扩展生态
软件包
扩展包别名与类别命名规则
下载扩展
从软件仓库下载扩展包到本地
安装扩展
在集群节点上安装扩展软件包
配置扩展
预加载扩展库与配置扩展参数
启用扩展
在数据库中创建和启用扩展
更新扩展
升级 PostgreSQL 扩展版本
移除扩展
卸载 PostgreSQL 扩展
常见问题
PostgreSQL 常见问题答疑
默认扩展
Pigsty 默认安装的 PostgreSQL 扩展
扩展仓库
Pigsty 扩展软件仓库配置
其他说明
其他说明与杂项文档
服务接入
Pigsty 使用 HAProxy 提供服务接入，并提供可选的 pgBouncer 池化连接，以及可选的 L2 VIP 与 DNS 接入。