Skip to main content

Result Type Support

HarborSQL encodes Databricks SQL connector result pages directly from Arrow arrays. The current Thrift result type matrix is explicit:

Arrow/DataFusion typeDatabricks type metadataThrift value representation
Booleanbooleanboolean
Int8tinyintint
Int16smallintint
Int32intint
Int64, UInt8, UInt16, UInt32bigintbigint
UInt64bigintbigint only when the value fits in signed i64
Float32floatdouble
Float64doubledouble
Utf8, LargeUtf8, Utf8Viewstringstring
Date32, Date64datestring
Timestamptimestampstring
Binary, LargeBinary, FixedSizeBinarybinarybinary
Decimal128, Decimal256decimal with precision/scale qualifiersstring
List, LargeList, FixedSizeListarraystring
Mapmapstring
Structstructstring

Decimal and nested values are rendered in the compact Databricks-style display form expected by connector compatibility tests. Arrays render as bracketed values, maps and structs render as JSON-like objects, string values are quoted, and nested date/timestamp values use Databricks-style textual dates and timestamps.

Unsupported Arrow types, including interval, dictionary, duration, list views, and time-only values, return UNSUPPORTED_RESULT_TYPE instead of being coerced.

Query Surface

The default runtime is intentionally read-only. It targets SELECT workloads against Unity Catalog Delta tables and does not currently provide Cloud Fetch, durable result storage, streaming result storage, or broad Databricks SQL protocol coverage.