被动故障切换
节点宕机，导致领导者租约过期触发集群领导竞选的故障路径
Categories: 概念
简介
Patroni 简介、快速上手以及高可用核心概念。
特性
PgBouncer 特性——池化模式与 SQL 兼容性
简介
为什么我们还需要一个新的包管理器？尤其是针对 Postgres 扩展？
主动故障检测
PostgreSQL 主库进程崩溃，Patroni 存活并尝试重启，超时后触发故障切换的路径
网络分区
主库与 DCS 网络分区，导致租约过期并触发脑裂防护与故障切换的路径
复制模式
Patroni 管理的异步与同步复制模式。
社区
PgBouncer 社区资源、教程与支持
项目指标
pgBackRest 项目代码覆盖率指标与质量统计。
Watchdog 支持
Patroni 集群的 watchdog 集成与隔离（fencing）注意事项。
DCS 故障安全模式
DCS 故障安全模式的行为机制、启用条件与操作注意事项。
Citus 支持
Patroni 与 Citus 协调节点及工作节点组的集成详情。
概念
理解 Pigsty 的核心概念、架构设计与设计理念，掌握高可用、备份恢复、安全合规等关键能力。
与其他工具的集成
Patroni 与外部备份及编排工具的集成方法。
安全注意事项
DCS、REST API 及凭据处理的安全注意事项。
积木式架构
Pigsty 的模块化架构介绍 —— 声明式组合，按需定制，自由部署。
节点
节点（node）是对硬件资源/操作系统的抽象，可以是物理机，裸金属、虚拟机、或者容器与 pods。
多数据中心高可用
基于 Patroni 复制的多数据中心高可用架构模式。
集群模型图
Pigsty 是如何将不同种类的功能抽象成为模块的，以及这些模块的逻辑模型，实体关系图。
声明式配置 —— 基础设施即代码（IaC）
Pigsty 使用基础设施即代码（IaC）的理念管理所有组件，针对大规模集群提供声明式管理能力。
PG 高可用
Pigsty 使用 Patroni 实现了 PostgreSQL 的高可用，确保主库不可用时自动进行故障转移，由从库接管。
RPO 利弊权衡
针对 RPO （Recovery Point Objective）进行利弊权衡，在可用性与数据损失之间找到最佳平衡点。
INFRA 架构
Pigsty 中基础设施模块的架构，组件与功能详解。
PGSQL 架构
PostgreSQL 模块的组件交互与数据流。
RTO 利弊权衡
针对 RTO （Recovery Time Objective）进行利弊权衡，在故障恢复速度与误切风险之间找到最佳平衡点。
故障切换模型
详细分析三种经典故障检测/恢复路径下，最差，最优，平均 RTO 的计算逻辑与结果
时间点恢复 —— 数据库的时间机器（PITR）
高可用解决"机器坏了"，时间点恢复解决"数据错了"。Pigsty 基于 pgBackRest 提供开箱即用的 PITR 能力，让您可以将集群回滚至恢复窗口内的任意时刻，为人为失误与软件缺陷兜底。
时间点恢复的工作原理
快照与历史、恢复窗口、恢复目标与时间线：理解 PITR 的四个核心概念，建立正确的心智模型。
时间点恢复的实现架构
Pigsty 以 pgBackRest 为引擎实现 PITR：仓库抽象、归档链路、调度机制，以及"备份跟随主库"的工程设计。
配置向导
使用 configure 脚本根据当前环境自动生成推荐的配置文件。
配置参数
使用配置参数对 Pigsty 进行精细化定制
时间点恢复的策略权衡
备份是一份保险：备在哪里决定容灾等级，保留多久决定恢复窗口，多久备一次决定恢复速度 —— 三个问题定义一份备份策略。
声明式恢复
恢复不该是深夜里的十几步手工操作：用 pg_pitr 参数声明想回到的时刻，由 pgsql-pitr.yml 剧本或 pig 命令行工具编排执行。
时间点恢复的典型场景
误删数据、发布事故、审计取证、机房灾难 —— 事故发生时如何选择恢复目标与恢复方式，以及为什么要把事故排练成例行演练。
配置模板
使用预制的配置模板，快速生成适配当前环境的配置文件
元数据库
使用 PostgreSQL 作为 CMDB 元数据库，存储 Ansible 配置清单。
监控系统
Pigsty 的监控系统是如何架构与实现的，被监控的目标对象又是如何被自动纳入管理的。
安全合规
Pigsty 以安全即代码的方式管理认证、授权、加密、审计与备份恢复，并提供从默认配置到生产加固的清晰路径。
安全模型
Pigsty 的信任边界与纵深防御体系：管理节点作为高信任控制面，从默认基线逐步完成生产加固。
身份认证
Pigsty 以声明式方式管理 PostgreSQL 与 PgBouncer 的 HBA 规则，配合 SCRAM 密码与客户端证书，回答“谁能连进来、如何证明身份”。
访问控制
Pigsty 内置四层角色模型与默认权限模板，将最小权限原则落实为可声明、可复用的集群配置。
加密通信
Pigsty 内置自签名 CA，为受管组件签发证书并分发信任，提供统一的 TLS 基础设施。
数据安全
使用校验和、备份与 PITR、加密和审计日志保护 PostgreSQL 数据的完整性、可恢复性、保密性与可追溯性。
合规实践
合规是配置、流程与证据的组合：上线加固清单、等保与 SOC 2 控制点映射、供应链完整性与漏洞响应机制。
PGSQL 集群模型
介绍 Pigsty 中 PostgreSQL 集群的实体-关系模型，E-R 关系图，实体释义与命名规范。
ETCD 集群模型
介绍 Pigsty 中 ETCD 集群的实体-关系模型，E-R 关系图，实体释义与命名规范。
MINIO 集群模型
介绍 Pigsty 中 MinIO 集群的实体-关系模型，E-R 关系图，实体释义与命名规范。
REDIS 集群模型
介绍 Pigsty 中 Redis 集群的实体-关系模型，E-R 关系图，实体释义与命名规范。
INFRA 集群模型
介绍 Pigsty 中 INFRA 基础设施节点的实体-关系模型，组件构成与命名规范。
3坏2应急处理
高可用典型场景处理预案：三节点坏了两个节点，高可用不生效了，怎么从紧急状态中恢复？
PostgreSQL
带有 562 扩展的原版 PostgreSQL 内核
Supabase
如何使用 Pigsty 自建 Supabase，一键拉起开源 Firebase 替代，后端全栈全家桶。
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 使用 HAProxy 提供服务接入，并提供可选的 pgBouncer 池化连接，以及可选的 L2 VIP 与 DNS 接入。
Patroni 4.1.4 中文文档
Patroni PostgreSQL 高可用模板，v4.1.4 中文文档
pgBouncer 1.25 中文文档
PgBouncer —— PostgreSQL 轻量级连接池，v1.25 中文文档
pgBackRest 2.59 中文文档
可靠的 PostgreSQL 备份与恢复工具 —— pgBackRest 文档与参考手册。