PIG

当前文档版本：v1.10.3，查看 发布说明。 本次版本新增四个扩展并更新扩展版本与包信息，内嵌扩展目录增至 620 个条目。 PIG 用统一的命令查找、安装和构建 PostgreSQL 扩展包，也提供 PostgreSQL、Patroni、pgBackRest 和 Pigsty 管理命令。软件包安装由系统的 apt、dnf 或 yum 完成。 从这里开始 你要做什么 阅读页面 安装 PostgreSQL 并启用第一个扩展 快速上手 了解用途、工作方式与支持平台 简介 下载、安装、升级或卸载 …

使用 pig pitr 从 pgBackRest 备份恢复本地 PostgreSQL 实例。 托管恢复时，PIG 按需停止服务并恢复数据。 默认在恢复后启动 PostgreSQL，保持 Patroni 停止，便于你验证恢复结果。 恢复会替换目标目录中的数据。先用 --plan 检查目录、备份来源、恢复目标和服务操作。 恢复前准备 需要已安装的 pgBackRest、可读取的配置文件、可用备份，以及到达恢复目标所需的 WAL 归档。 默认配置文件是 …

pig pgbackrest（别名 pig pb）用于创建备份、恢复数据和管理 pgBackRest stanza。 PIG 以 PostgreSQL 操作系统用户运行 pgBackRest，依次从 --dbsu、$PIG_DBSU 选择用户，默认 postgres。 首次备份前，先安装 pgBackRest，在 pgbackrest.conf 中配置 stanza 和备份仓库。 一个 stanza 对应一个 PostgreSQL 集群的备份配置。 在 PostgreSQL 中启用 …

使用 pig pe 读取运行中的 pg_exporter 指标，或重载其配置。 完整命令名为 pig pg_exporter，别名为 pe、pgexp 和 pgexporter。 pig pe get # 查看 PostgreSQL 指标 pig pe list # 列出 PostgreSQL 指标族 pig pe stat # 查看 exporter 统计信息 pig pe reload # 重载 exporter 配置 选择 exporter 默认端点为 …

pig patroni（别名 pig pt）运行已安装的 patronictl，用于查看集群成员、修改集群配置和切换主库。 PIG 负责选择配置文件，并提供本地服务、状态和日志命令。 其他命令使用 patronictl 的参数、交互确认、输出和退出码。 执行集群操作前，先安装 Patroni 并配置集群访问方式。 使用 pig pt COMMAND --help 查看原生命令帮助，使用 pig pt -- --help 查看 patronictl 根帮助。 单独运行 pig pt 显示 PIG …

pig postgres（别名 pig pg）管理本地 PostgreSQL 实例和数据库， 用于初始化与控制实例、执行 SQL、维护表和创建数据库副本。 Patroni 集群操作使用 pig pt，pgBackRest 恢复流程使用 pig pitr。 命令以 PostgreSQL 操作系统用户运行，通常为 postgres。先安装 PostgreSQL。 初始化新数据目录前，为该用户准备可写的父目录，或创建归该用户所有的空目录。 命令概览 实例控制： 命令 别名 描述 备注 pg init …

pig do 在选定的 Pigsty 目录中运行管理剧本，按 Inventory 配置添加集群、创建数据库和用户、安装软件包或移除服务。 先在 Inventory 中写好目标配置，再执行对应命令。命令会直接调用 Ansible；该命令组不提供通用 --plan 模式。 pig do pgsql-add pg-test 10.10.10.12 # 添加一个 PostgreSQL 实例 pig do pgsql-rm pg-test 10.10.10.12 # 移除一个 PostgreSQL 实例 …

pig inventory（别名 pig inv）查看、编辑和校验 Pigsty 配置清单 pigsty.yml，检查部署条件，并通过实验性的 cmdb 子命令与 PostgreSQL CMDB 交换配置。 编辑单个片段时，PIG 保留片段外的 YAML 内容与格式。保存前会重新解析完整文件；解析失败或原文件已被其他进程修改时，保留原文件并报告错误。 命令 别名 说明 inv status 检视当前生效的清单来源（不执行清单） inv list ls 列出清单拓扑与取值类型（--depth 限制 …

pig sty 安装 Pigsty，准备控制节点，生成配置，并运行部署剧本。它还通过 Grafana HTTP API 管理仪表盘。 命令 用途 sty init 下载并解压 Pigsty 到安装目录 sty boot 安装 Ansible 依赖并准备控制节点 sty conf 从模板生成并校验 Inventory sty deploy 运行部署剧本 sty list / sty get 查询或下载 Pigsty 发行版 sty grafana 管理 Grafana 仪表盘、语言和外观；别名 …

pig build 使用 Pigsty 的构建配方下载源码、安装依赖并生成 RPM/DEB 软件包。它适用于 EL、Debian 和 Ubuntu 构建主机；Rust、pgrx 和 Xray 客户端也支持各自的 macOS 使用场景。 命令 描述 备注 build spec 初始化构建规范目录 build repo 初始化所需仓库 需要 sudo 或 root 权限 build tool 初始化构建工具 需要 sudo 或 root 权限 build rust 安装 Rust 工具链 当前用户 …

pig ext 查询扩展目录，安装、升级或移除主机上的 PostgreSQL 扩展软件包。它也支持 PostgreSQL 内核包。安装软件包后，按扩展要求在数据库中执行 SQL 并修改配置。 命令 描述 备注 ext list 搜索扩展 ext info 显示扩展详细信息 ext avail 显示扩展可用性矩阵 ext status 显示主机可见的扩展文件/软件包 不会逐库查询 ext scan 扫描已安装的控制文件/共享库 不会逐库查询 ext add 安装扩展 需要 sudo 或 root …

pig repo 管理 Linux 软件仓库：添加或移除 APT/YUM/DNF 软件源，更新索引，并制作或解压离线包。repo create 还支持在 macOS 上通过 SOW 创建仓库。 命令 描述 备注 repo list 打印可用仓库与模块列表 repo info 获取仓库详细信息 repo status 显示当前仓库状态 repo add 添加新仓库 需要 sudo 或 root 权限 repo set 清空、覆盖并更新仓库 需要 sudo 或 root 权限 repo rm 移除仓 …

pig 管理 PostgreSQL 软件包、本地数据库服务和 Pigsty 部署。按任务选择下列命令；用 pig COMMAND --help 查看当前程序支持的选项。 pig repo：管理软件仓库 pig ext：管理 PostgreSQL 扩展 pig build：从源码构建扩展 pig install：使用原生包管理器安装包，并对 PostgreSQL 别名做翻译 pig sty：管理 Pigsty 安装与 Grafana 仪表盘 pig inventory：检视、编辑、校验与交换 …

以下记录 v1.10.3 及历史版本的变更。 版本 日期 摘要 GitHub v1.10.3 2026-10-29 新增四个扩展，刷新目录元数据，620 个目录条目 v1.10.3 v1.10.2 2026-10-24 新增 pg_nanotime，更新扩展版本与包信息，616 个目录条目 v1.10.2 v1.10.1 2026-10-24 Go 1.27.3 安全修复、依赖更新、615 个目录条目 v1.10.1 v1.10.0 2026-10-17 603 条目录记录，PostgreSQL …

可通过 Linux 安装脚本、系统软件包或发布压缩包安装 PIG。当前版本为 v1.10.3，全部发布文件见 下载页。 脚本安装 在 Linux 上执行： curl -fsSL https://repo.pigsty.cc/pig | bash 中国大陆以外可使用： curl -fsSL https://repo.pigsty.io/pig | bash 脚本检测 CPU 架构，下载 RPM 或 DEB 包，再调用 rpm 或 dpkg 安装。安装需要 root 或 sudo 权限。 检查安装后 …

PIG 是 PostgreSQL 与扩展的命令行管理工具。它将扩展名转换为 RPM 或 DEB 软件包名，再调用 apt、dnf 或 yum 完成安装。 扩展目录收录了 620 个条目。PIG 根据 PostgreSQL 大版本、操作系统和 CPU 架构选择对应包名，也提供源码构建、本地 PostgreSQL 管理、备份恢复和 Pigsty 管理命令。 可以做什么 任务 命令 参考文档 查找扩展，检查是否有包可用 pig ext list、pig ext avail 扩展管理 添加 PGDG 与 …

本教程安装 PostgreSQL 18 和 pgvector，启动本地测试实例，并在数据库中启用扩展。 准备一台 受支持的 Linux 测试主机，确保能联网并已安装 curl。你需要 root 或 sudo 权限。按顺序执行以下命令。 安装 PIG curl -fsSL https://repo.pigsty.cc/pig | bash pig version 中国大陆以外可使用 https://repo.pigsty.io/pig。安装脚本会选择与主机匹配的 RPM 或 DEB 包。其他方式见 …