Skip to content

@sqlrooms/db / QueryExecutionRequest

Type Alias: QueryExecutionRequest

QueryExecutionRequest = object

Request payload for routed query execution.

Properties

connectionId?

optional connectionId: string

Target connection id. If omitted, core DuckDB is used.


sql

sql: string

SQL statement(s) to execute.


queryType?

optional queryType: "arrow" | "json" | "exec"

Expected result shape.


materialize?

optional materialize: boolean

Whether arrow results from non-core connectors should be materialized into core DuckDB. Defaults to true for arrow queries.


materializedName?

optional materializedName: string

Optional target relation name used when materializing.


materializedSchema?

optional materializedSchema: string

Optional schema override for materialized relations.

When omitted, routing falls back to coreMaterialization defaults.


materializedDatabase?

optional materializedDatabase: string

Optional database/catalog override for materialized relations.

When omitted, routing falls back to coreMaterialization defaults.


signal?

optional signal: AbortSignal

Abort signal for cancellation.