Repository navigation
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-arrowTable or RecordBatch as a temporary SQL source
withregisterArrowSource, or register a one-shot sync/async batch producer
withregisterArrowReader; query it througharrowstream(name). - Read typed query results as a complete Table with
Session.queryArrow/
queryArrowBind, or pull RecordBatch values withqueryArrowStream/
queryArrowStreamBind. Thechdb/arrowentrypoint supplies TypeScript
return types when the optionalapache-arrowpeer is installed. - Insert a materialized batch/Table or a batch iterable with
insertArrow/
insertArrowReader. Destination columns map by name;rowsSubmittedis
the input count, not a storage-side commit ledger.
npm install chdb@3.6.0 apache-arrowSee 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.