Skip to main content
Parable serves read-only SQL through Apache DataFusion and Arrow Flight SQL. The same query behavior applies across TypeScript, Python, Go, Rust, JDBC, ADBC, and other compatible clients.

Fully qualified names

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

Types and metadata

Read Arrow types, semantic scalars, and catalog annotations.

Keys and relationships

Discover logical primary keys, foreign keys, and safe joins.

Supported operations

Check statements, prepared statements, metadata, and unsupported commands.

​
Core guarantees

  • Queries are scoped to the Workspace selected by request metadata.
  • Every read of a Provider table applies the Workspace’s Provider Policies before the query’s own conditions. Their conditions use the same DataFusion expression syntax as your queries.
  • Query execution is read-only.
  • Results stream as Arrow record batches, up to 2,000,000 rows per query. A larger result fails with RESOURCE_EXHAUSTED and error code QL-SQ-005; it is never truncated. See the row limit.
  • Catalog metadata describes logical keys and semantic types without enforcing database constraints.
  • Clients can negotiate the supported subset through Flight SQL capability metadata.
Start with Query with SDKs for a working connection or Flight SQL for the transport-level contract.

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.