PgBeam Docs
db

db schema-catalog

Read a database's schema catalog

Connect to the upstream database read-only and return its user relations (tables and views) and columns. System schemas (pg_catalog, information_schema, pg_toast) are excluded and nothing is persisted. Relation kind distinguishes a view (whose masking/row-filters apply to the view itself, not its base tables) from a base table.

Usage

pgbeam db schema-catalog <id>

Options

OptionDescriptionRequiredDefault
<id>Database ID to introspectYes-

Global options

All global options (--token, --profile, --project, --org, --json, --no-color, --debug) are also available on this command.

Examples

# List a database's relations
pgbeam db schema-catalog db_xxx

# Get the full catalog with columns as JSON
pgbeam db schema-catalog db_xxx --json

Output

Displays a table of relations with columns: Relation, Kind, and Columns (count). With --json, returns the full catalog including every column and its data type.

On this page