IQueryService class abstract interface

Query-shaped operations subset of IOdbcService.

Use this narrower interface in consumers that only need to read or write data — they don't have to depend on transaction, pool, or administrative concerns. The full IOdbcService implements this type, so existing wiring keeps working unchanged.

Members are intentionally a subset; methods that bridge multiple categories (e.g. executeQueryParamBuffer) stay on IOdbcService for now and may be promoted here in a follow-up.

Implementers

• IOdbcService
• TelemetryOdbcQueryDecorator

Available extensions

• IQueryServiceConnectionOverloads
• IQueryServiceTypedParamExtensions

Properties

hashCode → int

The hash code for this object.

no setter, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

executeQuery(String sql, {String? connectionId}) → Future<Result<QueryResult>>

Convenience query after connect() using the active connection id.

executeQueryColumnarFromObjects(String connectionId, String sql, {List<Object?>? params}) → Future<Result<TypedColumnarResult>>

Available on IQueryService, provided by the IQueryServiceTypedParamExtensions extension

Columnar execute with automatic ParamValue conversion.

executeQueryColumnarParamValues(String connectionId, String sql, {List<ParamValue>? params}) → Future<Result<TypedColumnarResult>>

Column-major opt-in variant of executeQueryParamValues.

executeQueryColumnarParamValuesFor(Connection conn, String sql, {List<ParamValue>? params}) → Future<Result<TypedColumnarResult>>

Available on IQueryService, provided by the IQueryServiceConnectionOverloads extension

executeQueryColumnarParamValues overload that accepts a Connection.

executeQueryDirectedParams(String connectionId, String sql, List<DirectedParam> params) → Future<Result<QueryResult>>

executeQueryFor(Connection conn, String sql) → Future<Result<QueryResult>>

Available on IQueryService, provided by the IQueryServiceConnectionOverloads extension

executeQuery overload that accepts a Connection.

executeQueryNamed(String connectionId, String sql, Map<String, Object?> namedParams) → Future<Result<QueryResult>>

executeQueryNamedFor(Connection conn, String sql, Map<String, Object?> namedParams) → Future<Result<QueryResult>>

Available on IQueryService, provided by the IQueryServiceConnectionOverloads extension

executeQueryNamed overload that accepts a Connection.

executeQueryParamValues(String connectionId, String sql, List<ParamValue> params, {ResultEncoding? resultEncoding}) → Future<Result<QueryResult>>

Typed positional parameters via ParamValue wire tags.

executeQueryParamValuesFor(Connection conn, String sql, List<ParamValue> params, {ResultEncoding? resultEncoding}) → Future<Result<QueryResult>>

Available on IQueryService, provided by the IQueryServiceConnectionOverloads extension

executeQueryParamValues overload that accepts a Connection.

executeQueryParamValuesFromObjects(String connectionId, String sql, List<Object?> params, {ResultEncoding? resultEncoding}) → Future<Result<QueryResult>>

Available on IQueryService, provided by the IQueryServiceTypedParamExtensions extension

Positional execute with automatic ParamValue conversion.

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

streamQuery(String connectionId, String sql) → Stream<Result<QueryResult>>

streamQueryColumnar(String connectionId, String sql) → Stream<Result<TypedColumnarResult>>

Batched cursor streaming with columnar v2 wire encoding when the native library exports odbc_stream_start_batched_options (v4.2+). Each chunk is decoded to TypedColumnarResult via toTypedColumnar. On older natives the call transparently falls back to row-major batched streaming.

streamQueryColumnarFor(Connection conn, String sql) → Stream<Result<TypedColumnarResult>>

Available on IQueryService, provided by the IQueryServiceConnectionOverloads extension

streamQueryColumnar overload that accepts a Connection.

streamQueryFor(Connection conn, String sql) → Stream<Result<QueryResult>>

Available on IQueryService, provided by the IQueryServiceConnectionOverloads extension

streamQuery overload that accepts a Connection.

streamQueryMulti(String connectionId, String sql) → Stream<Result<QueryResultMultiItem>>

streamQueryNamed(String connectionId, String sql, Map<String, Object?> namedParams) → Stream<Result<QueryResult>>

streamQueryNamedFor(Connection conn, String sql, Map<String, Object?> namedParams) → Stream<Result<QueryResult>>

Available on IQueryService, provided by the IQueryServiceConnectionOverloads extension

streamQueryNamed overload that accepts a Connection.

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited