cli on PIG

pig v1.8.1

Thu, 03 Sep 2026 00:00:00 +0000

Pig v1.8.1 是 v1.8.0 之上的安全、正确性与维护版本。本版本加固命令初始化、提权日志访问、仓库与构建流程、发布完整性，以及结构化输出脱敏；同时刷新内置扩展目录，并将构建工具链升级到 Go 1.27.1 与 cargo-pgrx 0.19.2。内置 Pigsty 版本仍为 4.5.0。

从面向人类到 Agent-Native：PIG 的 CLI 契约

Thu, 12 Feb 2026 00:00:00 +0000

决策日期： 2026-02-12
状态： 在 pig v1.1.0 中实现，之后继续通过命令层重构收敛。
当前参考： pig 命令总览
范围： PIG 自己拥有的命令及其机器消费契约；不透明的透传命令保留原生接口。

pig v1.6.0

Tue, 28 Jul 2026 00:00:00 +0000

Pig v1.6.0 是一个大版本：pig pt 重写为 patronictl 原生透传，新增根级 pig inventory 命令组提供 pigsty.yml 的无损编辑与校验（附带实验性的 PostgreSQL CMDB 交换能力），pig sty grafana 提供原生 Grafana 仪表盘管理，已打包扩展目录增至 562 个。

为什么 PIG 保持扁平的 Cobra 命令层

Tue, 30 Jun 2026 00:00:00 +0000

决策日期： 2026-06-30
状态： 当前仍在执行的仓库架构。
当前参考： pig 命令总览与源码仓库
范围： Go 源码归属与命令注册方式，而不是公开命令分类本身。

决策

cmd 包保持扁平。一个顶层命令对应一个顶层 Go 文件：pg.go、pb.go、pt.go、 pe.go、sty.go、do.go、repo.go 等。即使命令树很复杂，也继续留在这个入口文件中，除非另有明确的布局决策。

危险操作只有一套语法：PIG 运维 CLI 安全契约

Thu, 02 Jul 2026 00:00:00 +0000

决策日期： 2026-07-02
状态： pg、pb、pt、pitr 已于 v1.5.0 交付；2026-08-29 的 do 与 build proxy 修订已随 v1.8.1 发布。
当前参考： pig pg、pig pb、pig pitr、pig do 与 pig build
范围： PIG 自己拥有的运维命令；透明上游命令继续采用上游的确认与退出行为。

让 Patronictl 自己说话

Tue, 21 Jul 2026 00:00:00 +0000

决策日期： 2026-07-21
状态： 已实现并随 pig v1.6.0 发布。
当前参考： pig pt
范围： Patronictl 集群命令，以及 PIG 拥有的配置选择、参数设置、服务、状态和日志辅助功能。

决策

pig pt 是已安装 patronictl 的透明启动器。PIG 选择配置并分派少量本地辅助命令；其它命令 token 及其后的所有参数原样传递，保留原生提示、终端行为、输出格式与退出码。

PIG 2.0 产品方向：一份提案，而不是发布契约

Thu, 13 Aug 2026 00:00:00 +0000

决策日期： 2026-08-13
状态： 等待 owner 审议的提案；尚未实现，也不是 PIG 2.0 发布承诺。
当前参考： PIG 文档与当前 v1.8.1 发布
范围： 未来 PIG 2.0 / Pigsty 5.0 的候选产品边界与验证门槛。

决策

提案方向是让 PIG 成为从空白控制节点到经过校验、可以部署的 Pigsty Inventory 的稳定初始化前门。 PIG 拥有 Catalog 选择、解析、计划、有边界的执行编排、结构化结果与脱敏 receipt；软件包事务、配置应用与基础设施状态继续委托给 DNF/APT、Ansible 和未来的 provider 工具。

Catalog v2 提案：不可变 typed snapshot，而不是更大的 CSV

Thu, 13 Aug 2026 00:00:00 +0000

决策日期： 2026-08-13
状态： 实现前提案；安全机制、overlay 范围、打包方式与路径 ADR 仍未决定。
当前参考： pig ext 与 pig repo描述 v1 Catalog 行为。
范围： PIG 2.0 产品元数据的候选发布与消费模型，不包含 Inventory 或实时系统状态。

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 v1.3.0

Fri, 27 Feb 2026 00:00:00 +0000

这是从 v1.2.0 到 v1.3.0 的一次工程强化与目录扩展版本：15 commits、74 files changed、代码行 +1184 / -236。

该版本重点围绕 pig build 构建链路和 ext 目录/别名能力增强，并将可用扩展数量从 451 增加到 461。

pig v1.2.0

Mon, 23 Feb 2026 00:00:00 +0000

扩展目录与别名解析增强：
- 引入动态 PG 分类别名解析，按 PG 主版本选择别名映射。
- 引入 OS 维度别名覆盖（ansible/bootstrap），并在未知发行版回退中收敛为 PGDG-only。
- 新增 node/infra、babelfish/cloudberry 等别名并更新扩展元数据，减少包解析歧义。
高风险操作计划预览：

pig v1.1.0

Thu, 12 Feb 2026 00:00:00 +0000

该版本是从 v1.0.0 到 v1.1.0 的一次规划中架构级升级（79 commits，193 files 变更），核心目标是把 pig 从“人类可用 CLI”推进到“Agent-native 可编排 CLI”。

pig do

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

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

pig pe

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

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

瞬间克隆 PostgreSQL 数据库，无需黑魔法

Mon, 06 Jul 2026 00:00:00 +0000

老冯在半年前（2026-01-08）写过一篇文章《Git for Data：瞬间克隆 PG 数据库与实例》，介绍了 PostgreSQL 18 和 Pigsty v4.0 的一个新特性：瞬间克隆新数据库。利用文件系统 CoW 机制，以及 PG 18 的 file_copy_method = clone 新参数，可以在秒级克隆一个非常大的数据库，而且不占用额外的存储。

PG扩展云：解锁 PG 生态的全部潜力

Wed, 12 Nov 2025 00:00:00 +0000

微信公众号链接

PostgreSQL 拥有极为强大的扩展插件体系。在《PostgreSQL 正在吞噬数据库世界》中，老冯已经阐述过 可扩展性 是 PostgreSQL 成功的核心要素。举例来说，PG 有 GIS 领域的事实标准 PostGIS，向量数据库的瑞士军刀 pgvector，还有可以替代 ElasticSearch 的 pg_search，以及使用 DuckDB 在 PG 内进行分析的 pg_duckdb / pg_mooncake 等等，这些扩展为 PostgreSQL 赋予了超乎想象的能力。只有加装了这些扩展，PG 才能称得上是 “全盛完全体”。

小猪骑大象：PG内核与扩展包管理神器

Mon, 23 Dec 2024 00:00:00 +0000

微信公众号

最近我在忙一个非常有趣的新项目，这两天总算弄完了。各位朋友们，给大家介绍一下这个有趣的小东西，PostgreSQL 与 Pigsty 中久久缺失的一个命令行工具，我称之为 “pig”。