pitr on PIG

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