Interface GeoparquetSourceHandleExperimental

Readonly Experimentalruntime

Readonly Experimentalsources

describe

• describe(signal?): Promise<GeoparquetDescription>
• Experimental

  Schema, geometry column(s), CRS, and row estimate.

  Parameters

  • Optionalsignal: AbortSignal

  Returns Promise<GeoparquetDescription>

executeResolvedQuery

• executeResolvedQuery<T>(input): Promise<Result<T>>
• Experimental

  Execute a reviewed plan with ephemeral sources supplied by an opaque resource resolver. The sources are compiled and consumed immediately and never enter the runtime profile cache.

  Type Parameters

  • T = Record<string, unknown>

  Parameters

  • input: GeoparquetResolvedQueryInput<T>

  Returns Promise<Result<T>>

queryColumnar

• queryColumnar<T>(input): Promise<GeoparquetColumnarQueryResult>
• Experimental

  Execute a query and return a ColumnarBatchV1 instead of feature objects.

  This is the executable producer behind the query planner's representation: "columnar" selection: the geometry column is encoded straight into GeoArrow buffers, so no per-row feature object is materialized on the way out. The identity must come from the accepted plan (columnarBatchIdentityFromPlan), which is what makes the batch admissible to the persistent batch cache without a hand-written identity.

  Refuses with HonuaCapabilityNotSupportedError — never a silent object fallback — when the source's declared geometry encoding is not a 1:1 geoarrow-* native encoding, when the query suppresses geometry, or when the query is an aggregate.

  Type Parameters

  • T = Record<string, unknown>

  Parameters

  • input: GeoparquetColumnarQueryInput<T>

  Returns Promise<GeoparquetColumnarQueryResult>

sql

• sql(query): Promise<DuckRow[]>
• Experimental

  Run arbitrary SQL against the shared DuckDB instance.

  Parameters

  • query: string

  Returns Promise<DuckRow[]>