参考 on PIG

pig

Mon, 01 Jan 0001 00:00:00 +0000

pig CLI 提供了全面的工具集，用于管理 PostgreSQL 安装、扩展、软件仓库以及从源码构建扩展。使用 pig help <command> 查看命令文档。

pig repo：管理软件仓库
pig ext：管理 PostgreSQL 扩展
pig build：从源码构建扩展
pig install：使用原生包管理器安装包，并对 PostgreSQL 别名做翻译
pig sty：管理 Pigsty 安装与 Grafana 仪表盘
pig inventory：检视、编辑、校验与交换 Pigsty 配置清单（v1.6.0 新增）
pig do：执行 Pigsty 管理 playbook 任务
pig pe：访问 pg_exporter 指标与配置
pig pg：管理本地 PostgreSQL 服务器
pig pt：透明运行 patronictl，附带服务与配置辅助命令
pig pb：管理 pgBackRest 备份与恢复
pig pitr：进行完整 PITR 工作流
pig context：输出面向人工和 Agent 的环境上下文快照
pig status / update / version：查看环境、升级 pig、打印版本信息

概览

pig - PostgreSQL 的 Linux 包管理器

Usage:
  pig [command]

Examples:

  pig repo add -ru            # 覆盖现有仓库并更新缓存
  pig install pg18            # 安装 PostgreSQL 18 PGDG 软件包
  pig install pg_duckdb       # 安装指定的 PostgreSQL 扩展
  pig install pgactive -v 18  # 为特定 PG 版本安装扩展

  访问 https://pigsty.io/ext/ 获取详情

PostgreSQL Extension Manager
  build       构建 Postgres 扩展
  ext         管理 PostgreSQL 扩展 (pgext)
  repo        管理 Linux 软件仓库 (apt/dnf)

Pigsty Management Commands
  context     显示环境上下文快照
  do          运行管理任务
  inventory   检视、编辑、校验与交换 Pigsty 配置清单
  patroni     透明运行 patronictl（附 Pigsty 服务与配置辅助）
  pg_exporter 管理 pg_exporter 与监控指标
  pgbackrest  管理 pgBackRest 备份与恢复
  pitr        使用 pgBackRest 进行时间点恢复
  postgres    管理本地 PostgreSQL 服务器与数据库
  sty         管理 Pigsty 安装与控制器服务

Additional Commands:
  completion  生成指定 shell 的自动补全脚本
  help        获取任何命令的帮助信息
  install     使用原生包管理器安装软件包
  status      显示环境状态
  update      升级 pig 自身
  version     显示 pig 版本信息

Flags:
      --debug              启用调试模式
  -h, --help               获取帮助信息
  -H, --home string        Pigsty 主目录路径
  -i, --inventory string   配置清单路径
      --log-level string   日志级别: debug, info, warn, error, fatal, panic (默认 "info")
      --log-path string    日志文件路径，默认为终端输出
  -o, --output string      输出格式：text, yaml, json, json-pretty（默认 "text"）

使用 "pig [command] --help" 获取命令的详细信息。

pig repo

管理 PostgreSQL 软件包的 APT/YUM 仓库，详情请参考 pig repo

pig repo

Mon, 01 Jan 0001 00:00:00 +0000

pig repo 命令是一个综合性的软件包仓库管理工具。它提供了添加、移除、创建和管理软件仓库的功能，支持 RPM 系统（RHEL/CentOS/Rocky/Alma）和 Debian 系统（Debian/Ubuntu）。

pig ext

Mon, 01 Jan 0001 00:00:00 +0000

pig ext 用于检索扩展目录并管理主机上的 PostgreSQL 扩展 软件包。它可以解析名称、查询软件包可用性，安装、移除、升级 RPM/DEB 包，也能处理 PostgreSQL 内核包；数据库内部的启用与迁移不属于这一命令组的职责。

pig build

Mon, 01 Jan 0001 00:00:00 +0000

pig build 命令是一个强大的工具，简化了从源码构建 PostgreSQL 扩展的整个工作流程。它提供了完整的构建基础设施设置、依赖管理，以及标准和自定义 PostgreSQL 扩展在不同操作系统上的编译环境。

pig sty

Mon, 01 Jan 0001 00:00:00 +0000

pig 也可作为 Pigsty 的命令行工具使用 —— 这是一款开箱即用的免费 PostgreSQL RDS 解决方案。它为你的 PostgreSQL 集群带来高可用（HA）、PITR、监控、基础设施即代码（IaC）以及丰富的扩展支持。

pig do

Mon, 01 Jan 0001 00:00:00 +0000

pig do 将常见 Pigsty 管理 Playbook 暴露为明确的 CLI 操作。它使用选定的 Pigsty 主目录与 Inventory，构造对应的 Playbook 命令，并通过 PIG 的旧命令结构化结果适配器返回操作结果。

pig inventory

Mon, 01 Jan 0001 00:00:00 +0000

pig inventory 命令组（别名 pig inv）自 v1.6.0 起提供，用于以无损方式检视、编辑、校验与体检 Pigsty 配置清单（pigsty.yml），并可通过实验性的 cmdb 子命令与 PostgreSQL CMDB 交换配置。

pig postgres

Mon, 01 Jan 0001 00:00:00 +0000

pig pg 命令（别名 pig postgres）用于管理本地 PostgreSQL 服务器和数据库。它封装了 pg_ctl、psql、vacuumdb 等本地原语；集群级 Patroni 操作请使用 pig pt，编排式 PITR 请使用 pig pitr。

pig patroni

Mon, 01 Jan 0001 00:00:00 +0000

pig patroni 命令（别名 pig pt）自 v1.6.0 起是已安装 patronictl 的 透明启动器： pig 只负责选择配置文件与少量本地辅助命令，其余一切命令与参数 原样转发 给 patronictl，使用原生的参数、交互确认、输出与退出码——patronictl 的新功能无需等待 pig 发版即可使用。

pig pe

Mon, 01 Jan 0001 00:00:00 +0000

pig pe（别名：pgexp、pgexporter）是运行中 pg_exporter 的 legacy 便利包装。它读取默认指标与统计端点，也可以请求配置重载，但不是一套通用或版本化的 pg_exporter 客户端。

pig pgbackrest

Mon, 01 Jan 0001 00:00:00 +0000

pig pgbackrest 命令（别名 pig pb）用于管理 pgBackRest 备份，并提供低层 restore 原语。它封装了常用的 pgbackrest 操作，提供简化的备份管理体验。所有命令均以数据库超级用户身份（默认 postgres）执行。托管集群的编排式时间点恢复请优先使用 pig pitr。

pig pitr

Mon, 01 Jan 0001 00:00:00 +0000

pig pitr 命令用于通过 pgBackRest 执行时间点恢复，并以保守方式处理本地 PostgreSQL 与 Patroni 生命周期。与底层的 pig pb restore 不同，pig pitr 会先做恢复前检查，必要时停止 Patroni 与 PostgreSQL，执行 restore，然后按参数决定是否启动 PostgreSQL。