| title | pg hardstorage partial | ||
|---|---|---|---|
| description | CLI reference for the pg hardstorage partial command. | ||
| tags |
|
Table-level inspection (v0.1) and restore
Partial / table-level operations.
v0.1 ships partial inspect: given a backup and a list of tables, list the manifest entries (heap files) that contain the table data. This answers the operator's "would my partial restore work?" question before the extraction path lands.
partial restore — the actual table extraction into a running DB — ships alongside the sandbox-PG verifier. The v0.1 fallback documented in the structured error is: full restore into a staging directory + pg_dump --table=...
-h, --help help for partial
--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 partial dump - Restore + start sandbox PG + pg_dump SQL for selected tables
- pg_hardstorage partial inspect - Report which manifest entries a partial restore would touch
- pg_hardstorage partial restore - Extract specific tables' files from a backup into --target