Skip to main content
SQL gives you one read-only surface for the data available to a Workspace. Use a Flight SQL client SDK to query tables from Providers, published files, materialized Plots, and live Workspace metadata without copying them into a separate query system.

​
Choose what to query

Provider quality is a companion catalog at providers_quality. It describes the health of Provider tables; it is not another data pool. Bronze, Silver, and Gold are not part of this SQL surface. They are storage and processing details behind the logical tables above.

​
Run your first query

  1. Connect with a client SDK and select a Workspace.
  2. Discover its tables and columns.
  3. Use fully qualified table names in a read-only SQL statement.
The Workspace selected on the request determines which tables you can see. A catalog name never contains the Workspace slug.

​
Learn the contract

Data catalog

Understand pools, discover tables, and find the source of each table.

SQL behavior

Learn naming, types, relationships, and supported operations.

Flight SQL

Use the underlying Arrow Flight SQL protocol directly.

Query with SDKs

Execute Workspace SQL with TypeScript, Python, Go, or Rust Flight SQL clients.

Flight SQL

Connect directly to Parable's read-only Workspace data plane through Arrow Flight SQL.

Data Catalog

Discover Tables and Columns

Inspect Workspace catalogs, schemas, tables, columns, and semantic annotations before writing SQL.

Provider Pool

Query and join the current data supplied by Provider Plugins.

Artifact Pool

Query files that a Workspace has published as SQL tables.

Parable Pool

Query materialized Plot results by Parable and Plot slug.

Workspace Pool

Query live Workspace membership, Provider, role, Parable, Plot, and run metadata.

Provider Quality

Query checks, statistical process control, shape, and health for Provider tables.

SQL Behavior

Fully Qualified Names

Address SQL pools, schemas, tables, flattened fields, and child tables precisely.

Types and Metadata

Interpret Arrow field types, semantic scalar annotations, and Parable catalog metadata.

Keys and Relationships

Discover logical primary keys, foreign keys, and safe relationships between SQL tables.

Supported Operations

Check the supported read-only SQL, prepared statement, and metadata operations.