pgbackrest on PIG

pig v1.5.0

Sat, 04 Jul 2026 00:00:00 +0000

Pig v1.5.0 is a PostgreSQL operations release for day-to-day DBA work. It adds local database clone/fork workflows, clarifies the boundaries between pg, pt, pb, and pitr, and tightens preview, confirmation, and structured-output behavior for high-risk operations.

Highlights

pig pg is now more focused on local PostgreSQL operations. pig pg clone creates quick database-level copies, while pig pg fork creates disposable physical instance forks for local validation, recovery drills, and isolated experiments.
Recovery flows are split more clearly: pig pitr is the orchestration entry point across Patroni, PostgreSQL, and pgBackRest; pig pb restore remains the low-level pgBackRest restore primitive. Restore commands now require an explicit target and provide more concrete plans and post-restore guidance.
Patroni operations are more predictable: high-risk actions such as pig pt restart, reinit, switchover, and failover use Pig-managed confirmation and plan output; pig pt config pg points operators to pig pt restart --pending when a restart is required.
Automation is safer: structured output no longer implies confirmation for destructive commands. High-risk execution requires explicit -y/--yes, while --plan and next_actions are more consistent for preview-then-execute workflows.
Logs and status output are more useful during incidents: pg, pb, and pt log commands now cover common latest / tail / show / grep workflows, and structured log snapshots use JSONL semantics.
Build and release defaults were refreshed: Pig is 1.5.0, embedded Pigsty is 4.4.0, and pig build pgrx defaults to cargo-pgrx 0.19.1.

Extension Catalog

Available extensions: 524 -> 531, with no removals.
New extensions: pg_ducklake, pgdisablelogerror, pg_stat_log, pg_stat_plans, passwordpolicy, db2fce, plpgsql_wrap.
Refreshed a batch of existing extension versions and package metadata, including timescaledb 2.28.2, postgis 3.6.4, vector 0.8.4, biscuit 2.4.1, citus 14.1.0, orioledb 1.8, documentdb 0.113, credcheck 5.0, and pgtt 4.5.
orioledb aliases no longer pin to PG17; they resolve against the requested PostgreSQL major. EL9 ARM64 Patroni aliases now point to noarch packages.

Compatibility Notes

Use -y/--yes for destructive operations in automation; structured output mode no longer substitutes for human confirmation.
pig pb restore and pig pitr require exactly one explicit recovery target; use --target-action=promote for auto-promote behavior.
Several ambiguous short options were cleaned up. For log commands, -o json means a JSONL snapshot and is not used for tail/follow streaming modes.

Checksums

| File | Checksum | | --- | --- | | [pig\-1\.5\.0\-1\.aarch64\.rpm](https://github.com/pgsty/pig/releases/download/v1.5.0/pig-1.5.0-1.aarch64.rpm) | SHA-256 · `9f83b78ed2eccedd55a86c634f88364f1945c3cefa1b23efdd72a7cf2062e1df` | | [pig\-1\.5\.0\-1\.x86\_64\.rpm](https://github.com/pgsty/pig/releases/download/v1.5.0/pig-1.5.0-1.x86_64.rpm) | SHA-256 · `b792001498e9907d4659db46640f9c5164152b20689f90f93418f76fb4633e6e` | | [pig\-v1\.5\.0\.darwin\-amd64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.5.0/pig-v1.5.0.darwin-amd64.tar.gz) | SHA-256 · `ae1081dfbff8564ecdf713c85e8025c91bfd38e6575ea9ac99a92f968ab8a29d` | | [pig\-v1\.5\.0\.darwin\-arm64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.5.0/pig-v1.5.0.darwin-arm64.tar.gz) | SHA-256 · `6d69efcdcdc79fd90d2112e1e8042887020402aa037252d89d632243e7085dc6` | | [pig\-v1\.5\.0\.linux\-amd64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.5.0/pig-v1.5.0.linux-amd64.tar.gz) | SHA-256 · `8f914821b317cde73d3aec4ed311d5e90710bbc8cb372c1de3322083c31f4a85` | | [pig\-v1\.5\.0\.linux\-arm64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.5.0/pig-v1.5.0.linux-arm64.tar.gz) | SHA-256 · `d4de9ef1c28d0a3661c4a4d47c469b7bfd5f5bddb610325796afb669ab162234` | | [pig\_1\.5\.0\-1\_amd64\.deb](https://github.com/pgsty/pig/releases/download/v1.5.0/pig_1.5.0-1_amd64.deb) | SHA-256 · `35fd32affb4cb5bcca845d47a768782fb7005f06fcc1bcb5b7755d2627f96245` | | [pig\_1\.5\.0\-1\_arm64\.deb](https://github.com/pgsty/pig/releases/download/v1.5.0/pig_1.5.0-1_arm64.deb) | SHA-256 · `2be1df804d3f630560bc3ced0107c49ffad8bb52b004f72c7f8b4d09dc8d3e04` |

v1.5.0 · 2026-07-04

One Grammar for Dangerous Work: PIG's Operations CLI Safety Contract

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

Decision date: 2026-07-02
Status: Released for pg, pb, pt, and pitr by v1.5.0; the 2026-08-29 do and build proxy refinements were released in v1.8.1.
Current reference: pig pg, pig pb, pig pitr, pig do, and pig build
Scope: PIG-owned operational commands; transparent upstream commands retain upstream confirmation and exit behavior.

Decision

Operational convenience must not blur operational meaning. PIG distinguishes low-level primitives from multi-stage orchestrators, makes destructive intent explicit, reserves aliases carefully, and requires plans and structured results to describe the same action that text mode will execute.

pig v1.0.0

Mon, 26 Jan 2026 00:00:00 +0000

This release introduces three major new subcommand groups (pig pg, pig pt, pig pb) for managing PostgreSQL, Patroni, and pgBackRest, along with an orchestrated PITR command and enhanced extension availability display.

New Commands

pig pg - PostgreSQL instance management
- pg init/start/stop/restart/reload/status - Control and manage PostgreSQL instances
- pg role/promote - Detect and switch instance role (primary/replica)
- pg psql/ps/kill - Connection and session management
- pg vacuum/analyze/freeze/repack - Database maintenance operations
- pg log - Log viewing (list/tail/cat/less)
pig pt - Patroni cluster management

pig pgbackrest

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

The pig pgbackrest command (alias pig pb) manages pgBackRest backups and provides low-level restore primitives. It wraps common pgbackrest operations for a simplified backup management experience. All commands run as the database superuser (default postgres). For orchestrated point-in-time recovery on managed clusters, prefer pig pitr.

pig pb - Manage pgBackRest backup and point-in-time recovery.

Information:
  pig pb info                      show backup info
  pig pb list                      list backups
  pig pb list repo                 list configured repositories
  pig pb list stanza               list all stanzas

Backup & Restore:
  pig pb backup                    create backup (auto: full/incr)
  pig pb backup full               create full backup
  pig pb restore                   low-level restore primitive
  pig pb restore -t "..."          restore to specific time
  pig pb expire                    cleanup expired backups

Stanza Management:
  pig pb create                    create stanza (first-time setup)
  pig pb upgrade                   upgrade stanza (after PG upgrade)
  pig pb delete                    delete stanza (DANGEROUS!)

Control:
  pig pb check                     verify backup integrity
  pig pb start                     enable pgBackRest operations
  pig pb stop                      disable pgBackRest operations
  pig pb log                       view pgBackRest logs

Examples:
  pig pb info                      # show all backup info
  pig pb backup                    # auto: full if none, else incr
  pig pb backup full               # full backup
  pig pb restore -d                # restore to latest (end of WAL)
  pig pb restore -t "2025-01-01 12:00:00+08"  # restore to time
  pig pb create                    # initialize stanza
  pig pb expire                    # cleanup per retention policy

Command Overview

Information Query:

pig pitr

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

The pig pitr command performs point-in-time recovery through pgBackRest and conservatively handles the local PostgreSQL and Patroni lifecycle. Unlike the lower-level pig pb restore, pig pitr runs pre-restore checks, stops Patroni and PostgreSQL when needed, executes restore, then decides whether to start PostgreSQL based on the selected options.

Note: for a managed default data directory, pig pitr leaves Patroni stopped after recovery. Validate the restored result first, then manually restore Patroni management. This command does not automatically rejoin a Patroni cluster, perform failover, or validate cluster member state.