> ## 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 virtual-query

> Start, inspect and page an expiring virtual table query

## bijection virtual-query

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Start, inspect and page an expiring virtual table query

Usage:
  bijection virtual-query [flags]
  bijection virtual-query [command]

Available Commands:
  cancel      Request cancellation of source work
  get         Read current query status
  page        Read a page of the complete retained result
  release     Release retained inputs and results
  request-id  Create a request identity to keep across start retries
  start       Freeze and execute one query under a retained request identity

Flags:
  -h, --help   help for virtual-query

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

## bijection virtual-query cancel

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Request cancellation of source work

Usage:
  bijection virtual-query cancel <executionId> [flags]

Flags:
      --branch string       Use a branch under your current business identity.
      --deployment string   Inspect definitions in 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       Print the exact public protocol as JSON. (json) (default "json")
  -h, --help                help for cancel
      --prod                Inspect definitions in this project's default production deployment.
```

## bijection virtual-query get

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Read current query status

Usage:
  bijection virtual-query get <executionId> [flags]

Flags:
      --branch string       Use a branch under your current business identity.
      --deployment string   Inspect definitions in 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       Print the exact public protocol as JSON. (json) (default "json")
  -h, --help                help for get
      --prod                Inspect definitions in this project's default production deployment.
```

## bijection virtual-query page

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Read a page of the complete retained result

Usage:
  bijection virtual-query page <executionId> [flags]

Flags:
      --branch string       Use a branch under your current business identity.
      --cursor string       Continue the exact retained result.
      --deployment string   Inspect definitions in 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       Print the exact public protocol as JSON. (json) (default "json")
  -h, --help                help for page
      --limit int           Return one to one thousand rows. (default 100)
      --prod                Inspect definitions in this project's default production deployment.
```

## bijection virtual-query release

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Release retained inputs and results

Usage:
  bijection virtual-query release <executionId> [flags]

Flags:
      --branch string       Use a branch under your current business identity.
      --deployment string   Inspect definitions in 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       Print the exact public protocol as JSON. (json) (default "json")
  -h, --help                help for release
      --prod                Inspect definitions in this project's default production deployment.
```

## bijection virtual-query request-id

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Create a request identity to keep across start retries

Usage:
  bijection virtual-query request-id [flags]

Flags:
  -h, --help   help for request-id
```

## bijection virtual-query start

```text theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
Freeze and execute one query under a retained request identity

Usage:
  bijection virtual-query start <collection> [flags]

Flags:
      --branch string       Use a branch under your current business identity.
      --deployment string   Inspect definitions in 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       Print the exact public protocol as JSON. (json) (default "json")
  -h, --help                help for start
      --prod                Inspect definitions in this project's default production deployment.
      --query string        Filters, selection or expressionJson, with maxRows and maxBytes bounds.
      --request-id string   Identity from virtual-query request-id; reuse it after an uncertain reply.
```


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