> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bijection.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bijection catalog

> Discover existing tables and import their dataset or remote-table contracts

## bijection catalog

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Discover existing tables and import their dataset or remote-table contracts

Usage:
  bijection catalog [flags]
  bijection catalog [command]

Available Commands:
  apply       Apply the reviewed attachment with definition and binding conditions
  browse      Browse bounded provider metadata without importing data
  capture     Capture an exact snapshot as an existing run's output
  check       Check the selected source, schema and deployed attachment
  diff        Explain selected schema and identity changes
  import      Generate ordinary declarations and record the selected source identity
  refresh     Prepare a source patch for reviewed catalog changes
  status      Observe ordinary dataset status and retained import requests

Flags:
      --component string    Installed datasets component (default "datasets")
      --deployment string   Use catalogs on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
  -h, --help                help for catalog
      --help-all            Show all commands and options, including administrative controls.
      --help-json           Print command input and output schemas as JSON without executing it.
      --url string          Use catalogs on a private deployment at this explicit origin.

Global Flags:
      --target string   Execution target: project/reference/live or project/reference/<branch>; private deployments use URL#live or URL#branch/<name>. Git navigation never changes this target.

Use "bijection catalog [command] --help" for more information about a command.
```

## bijection catalog apply

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Apply the reviewed attachment with definition and binding conditions

Usage:
  bijection catalog apply <name> [flags]

Flags:
  -h, --help                help for apply
      --help-all            Show all commands and options, including administrative controls.
      --help-json           Print command input and output schemas as JSON without executing it.
      --request-id string   Stable identity for this exact attachment intent

Global Flags:
      --component string    Installed datasets component (default "datasets")
      --deployment string   Use catalogs on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --target string       Execution target: project/reference/live or project/reference/<branch>; private deployments use URL#live or URL#branch/<name>. Git navigation never changes this target.
      --url string          Use catalogs on a private deployment at this explicit origin.
```

## bijection catalog browse

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Browse bounded provider metadata without importing data

Usage:
  bijection catalog browse [flags]

Flags:
      --catalog string           Warehouse catalog or database
      --connection string        Existing warehouse connection
      --dataset-catalog string   Existing dataset catalog registration
  -h, --help                     help for browse
      --help-all                 Show all commands and options, including administrative controls.
      --help-json                Print command input and output schemas as JSON without executing it.
      --namespace string         Iceberg namespace segment; repeat for nested namespaces (default "[]")
      --namespaces               List child namespaces of the selected Iceberg namespace
      --page-token string        Continue the same catalog listing
      --schema string            Warehouse schema
      --table string             Exact provider table name

Global Flags:
      --component string    Installed datasets component (default "datasets")
      --deployment string   Use catalogs on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --target string       Execution target: project/reference/live or project/reference/<branch>; private deployments use URL#live or URL#branch/<name>. Git navigation never changes this target.
      --url string          Use catalogs on a private deployment at this explicit origin.
```

## bijection catalog capture

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Capture an exact snapshot as an existing run's output

Usage:
  bijection catalog capture <name> [flags]

Flags:
      --context string          Existing admitted pipeline attempt context
  -h, --help                    help for capture
      --help-all                Show all commands and options, including administrative controls.
      --help-json               Print command input and output schemas as JSON without executing it.
      --output-key string       Output port in the admitted run (default "result")
      --producer-grant string   Admit and claim the ordinary no-input pipeline using this existing grant
      --program-digest string   Program identity admitted for this capture
      --request-id string       Stable capture identity

Global Flags:
      --component string    Installed datasets component (default "datasets")
      --deployment string   Use catalogs on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --target string       Execution target: project/reference/live or project/reference/<branch>; private deployments use URL#live or URL#branch/<name>. Git navigation never changes this target.
      --url string          Use catalogs on a private deployment at this explicit origin.
```

## bijection catalog check

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Check the selected source, schema and deployed attachment

Usage:
  bijection catalog check <name> [flags]

Flags:
  -h, --help        help for check
      --help-all    Show all commands and options, including administrative controls.
      --help-json   Print command input and output schemas as JSON without executing it.

Global Flags:
      --component string    Installed datasets component (default "datasets")
      --deployment string   Use catalogs on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --target string       Execution target: project/reference/live or project/reference/<branch>; private deployments use URL#live or URL#branch/<name>. Git navigation never changes this target.
      --url string          Use catalogs on a private deployment at this explicit origin.
```

## bijection catalog diff

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Explain selected schema and identity changes

Usage:
  bijection catalog diff <name> [flags]

Flags:
  -h, --help        help for diff
      --help-all    Show all commands and options, including administrative controls.
      --help-json   Print command input and output schemas as JSON without executing it.

Global Flags:
      --component string    Installed datasets component (default "datasets")
      --deployment string   Use catalogs on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --target string       Execution target: project/reference/live or project/reference/<branch>; private deployments use URL#live or URL#branch/<name>. Git navigation never changes this target.
      --url string          Use catalogs on a private deployment at this explicit origin.
```

## bijection catalog import

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Generate ordinary declarations and record the selected source identity

Usage:
  bijection catalog import [flags]

Flags:
      --as string                dataset or remote-table
      --buckets string           Keyed external dataset verification buckets, 1..32
      --business-time string     Explicit dataset business time; none is supported
      --catalog string           Warehouse catalog or database
      --connection string        Existing warehouse connection
      --dataset-catalog string   Existing dataset catalog registration
      --dataset-table            Also scaffold defineRemoteTable({ source: dataset })
      --executor string          Executor export for a direct remote table
      --field string             Select and name a column; repeat for a projection (default "[]")
  -h, --help                     help for import
      --help-all                 Show all commands and options, including administrative controls.
      --help-json                Print command input and output schemas as JSON without executing it.
      --key string               Explicit row key field; repeat for composite keys (default "[]")
      --name string              Application export and import name
      --namespace string         Iceberg namespace segment; repeat for nested namespaces (default "[]")
      --output string            New editable TypeScript file relative to the backend
      --schema string            Warehouse schema
      --semantics string         Explicit dataset semantics; current-state is supported
      --table string             Exact provider table name
      --unkeyed                  Explicitly import without a business row key

Global Flags:
      --component string    Installed datasets component (default "datasets")
      --deployment string   Use catalogs on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --target string       Execution target: project/reference/live or project/reference/<branch>; private deployments use URL#live or URL#branch/<name>. Git navigation never changes this target.
      --url string          Use catalogs on a private deployment at this explicit origin.
```

## bijection catalog refresh

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Prepare a source patch for reviewed catalog changes

Usage:
  bijection catalog refresh <name> [flags]

Flags:
      --apply            Apply the exact retained patch if source has not changed
  -h, --help             help for refresh
      --help-all         Show all commands and options, including administrative controls.
      --help-json        Print command input and output schemas as JSON without executing it.
      --plan             Retain and print the proposed source and metadata patch
      --plan-id string   Exact catalog refresh plan returned by --plan

Global Flags:
      --component string    Installed datasets component (default "datasets")
      --deployment string   Use catalogs on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --target string       Execution target: project/reference/live or project/reference/<branch>; private deployments use URL#live or URL#branch/<name>. Git navigation never changes this target.
      --url string          Use catalogs on a private deployment at this explicit origin.
```

## bijection catalog status

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Observe ordinary dataset status and retained import requests

Usage:
  bijection catalog status <name> [flags]

Flags:
  -h, --help        help for status
      --help-all    Show all commands and options, including administrative controls.
      --help-json   Print command input and output schemas as JSON without executing it.

Global Flags:
      --component string    Installed datasets component (default "datasets")
      --deployment string   Use catalogs on a specific deployment. Accepts:
                            • a deployment name (e.g. joyful-capybara-123)
                            • a deployment reference (e.g. dev/james, staging)
                            • dev (for your personal dev deployment)
                            • prod (for your project’s default production deployment).
                            You can also select deployments in other projects with project-slug:reference.
      --format string       Output format; JSON preserves exact values. (pretty, json) (default "pretty")
      --target string       Execution target: project/reference/live or project/reference/<branch>; private deployments use URL#live or URL#branch/<name>. Git navigation never changes this target.
      --url string          Use catalogs on a private deployment at this explicit origin.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.