Skip to content

v3.6.0 — direct Arrow on chdb-core v26.11.1

Latest

Choose a tag to compare

@ShawnChen-Sirius ShawnChen-Sirius released this 16 Nov 22:15
· 2 commits to main since this release
65d9ba4

Node 3.6.0 uses chdb-core v26.11.1 and the matching
@chdb/lib-*@26.11.1-stable.1 native packages for Linux x64/arm64 (glibc)
and macOS x64/arm64. It adds direct Arrow C Data/C Stream paths alongside the
existing Arrow IPC output route.

Direct Arrow in Node

  • Register an apache-arrow Table or RecordBatch as a temporary SQL source
    with registerArrowSource, or register a one-shot sync/async batch producer
    with registerArrowReader; query it through arrowstream(name).
  • Read typed query results as a complete Table with Session.queryArrow /
    queryArrowBind, or pull RecordBatch values with queryArrowStream /
    queryArrowStreamBind. The chdb/arrow entrypoint supplies TypeScript
    return types when the optional apache-arrow peer is installed.
  • Insert a materialized batch/Table or a batch iterable with insertArrow /
    insertArrowReader. Destination columns map by name; rowsSubmitted is
    the input count, not a storage-side commit ledger.
npm install chdb@3.6.0 apache-arrow

See the Node Arrow guide
for examples, ownership and cancellation rules, supported types, and the
difference between direct Arrow and queryAsync(..., { format: 'arrow' }).toArrow().
Direct does not mean end-to-end zero-copy. Nested input and multi-chunk
dictionary layouts are not yet supported; unsupported paths fail explicitly.
The 3.6.0 npm tarball does not contain the guide, so use the online link.

Verification

The core v26.11.1 compatibility run
passed on all four platforms. The Node publication and verification run
finished with all 20 jobs successful after failed clean installs were retried
once npm's large native packages became available. Installed-package tests
used the published chdb@3.6.0 and exact native subpackage, on Node
18/20/22 across four platforms and on Debian bookworm for both Linux
architectures. They ran the Arrow end-to-end smoke as well as ordinary package
tests. latest was promoted only after those jobs passed.

Changes since v3.5.0