Class GeoparquetRuntime`Experimental`

Owns a single, lazily-initialized DuckDB instance shared across every GeoParquet source. Profiles (footer schema + geometry plan + row estimate) are memoized per source-URL set.

Index

Constructors

Methods

dispose profile query registerFileBuffer stream

Constructors

constructor

new GeoparquetRuntime(options?: GeoparquetRuntimeOptions): GeoparquetRuntime
Experimental
Parameters
- options: GeoparquetRuntimeOptions = {}
Returns GeoparquetRuntime
- Defined in work/honua-sdk-js/honua-sdk-js/src/geoparquet/index.ts:154

Methods

dispose

dispose(): Promise<void>
Experimental
Terminate the DuckDB worker / instance. Idempotent.

Returns Promise<void>
- Defined in work/honua-sdk-js/honua-sdk-js/src/geoparquet/index.ts:246

profile

profile(
    sources: readonly string[],
    geometryColumnOverride?: string,
    options?: DuckDbQueryOptions,
): Promise<SourceProfile>
Experimental
Detect (and memoize) the schema + geometry plan for a source-URL set.
Parameters
- sources: readonly string[]
- OptionalgeometryColumnOverride: string
- Optionaloptions: DuckDbQueryOptions
Returns Promise<SourceProfile>
- Defined in work/honua-sdk-js/honua-sdk-js/src/geoparquet/index.ts:198

query

query(sql: string, options?: DuckDbQueryOptions): Promise<DuckRow[]>
Experimental
Run a query and return raw rows. Escape hatch for advanced callers.
Parameters
- sql: string
- Optionaloptions: DuckDbQueryOptions
Returns Promise<DuckRow[]>
- Defined in work/honua-sdk-js/honua-sdk-js/src/geoparquet/index.ts:176

registerFileBuffer

registerFileBuffer(name: string, bytes: Uint8Array): Promise<void>
Experimental
Register parquet bytes under a name usable in read_parquet('name').
Parameters
- name: string
- bytes: Uint8Array
Returns Promise<void>
- Defined in work/honua-sdk-js/honua-sdk-js/src/geoparquet/index.ts:192

stream

stream(sql: string, options?: DuckDbQueryOptions): AsyncIterable<DuckRow[]>
Experimental
Stream Arrow record batches when supported, falling back to one materialized batch.
Parameters
- sql: string
- Optionaloptions: DuckDbQueryOptions
Returns AsyncIterable<DuckRow[]>
- Defined in work/honua-sdk-js/honua-sdk-js/src/geoparquet/index.ts:182