| title | pg hardstorage logical | ||
|---|---|---|---|
| description | CLI reference for the pg hardstorage logical command. | ||
| tags |
|
Configure logical decoding sinks alongside physical WAL streaming
Manage per-deployment logical decoding pipelines.
A pipeline is the tuple (deployment, stream-name, slot, plugin, publication, sink). Logical decoding is an OPTIONAL second stream that complements the physical WAL stream — it does NOT replace it. A deployment with only logical configured is still NOT considered "backed up" — physical is the truth-of-record.
v0.1 ships pgoutput + chunked sink. The chunked sink writes batched XLogData payloads into the same CAS-backed repo as physical WAL, under logical///.json.
-h, --help help for logical
--airgapped airgapped: strict refuse outbound endpoints (LLM providers, sinks, OTLP collectors) outside loopback / RFC1918 / explicit airgap.allowlist. Also enabled by PG_HARDSTORAGE_AIRGAPPED=1 or airgapped: strict in the config file.
-c, --config string path to config file (default: XDG/FHS lookup)
--cpu-profile go tool pprof <path> write a pprof CPU profile to this path for the duration of the command (go tool pprof <path> to analyse). Off when empty.
--mem-profile string write a pprof heap profile to this path at command exit. Off when empty.
--no-color disable ANSI color in text output
--on-error-llm on a structured-error failure, drop into the matching LLM helper skill (auto_on_error trigger). Also enabled by PG_HARDSTORAGE_ON_ERROR_LLM=1.
--otel-endpoint string OpenTelemetry OTLP/HTTP endpoint (e.g. http://otel-collector:4318); empty disables tracing
--otel-stdout also export OpenTelemetry traces to stderr (useful for dev)
-o, --output string output format: text|json|ndjson|yaml|template|csv|markdown|html|tap|junit|pdf (default: text on TTY, json off-TTY)
--profile-port go tool pprof http://127.0.0.1:6060/debug/pprof/profile?seconds=30 if non-zero, expose net/http/pprof on 127.0.0.1:<port> for live profiling of long-running commands (e.g. go tool pprof http://127.0.0.1:6060/debug/pprof/profile?seconds=30). Off when zero.
-q, --quiet suppress non-essential output
--template string Go text/template applied when --output template (or implied if --template is set without --output)
- pg_hardstorage - PostgreSQL backup, done right.
- pg_hardstorage logical add - Register a logical-decoding stream
- pg_hardstorage logical list - List registered logical streams
- pg_hardstorage logical remove - Remove a registered logical stream
- pg_hardstorage logical status - Report registry state for one or all streams
- pg_hardstorage logical stream - Run the long-lived consumer for a registered stream