{"repo":"chdb-io/chdb-node","free":true,"listed":false,"github":"https://github.com/chdb-io/chdb-node","clone":"git clone https://github.com/chdb-io/chdb-node.git","description":"Native NodeJS bindings for chDB, an in-process SQL OLAP Engine powered by ClickHouse","language":"TypeScript","stars":57,"topics":["chdb","clickhouse","ffi","napi","nodejs","olap"],"license":"Apache-2.0","category":"databases-storage","readme_excerpt":"chdb-node chDB Node.js bindings — an in-process ClickHouse engine for Node, Bun and Deno. v3 (Layer 1) is in development. The v2 query / queryBind / Session API is preserved (your v2 code keeps working); v3 adds async queries, server-side parameter binding, inserts, streaming, and Arrow output. Install Prebuilt native binaries ship as per-platform subpackages ( @chdb/lib- , resolved via optionalDependencies ) — no local compilation, no node-gyp , no Python. First-batch platforms: Linux x64/arm64 (glibc) and macOS x64/arm64. Windows is not supported (use WSL2). Usage Errors are typed ( ChdbSyntaxError , ChdbQueryError , ChdbConnectionError , ChdbBindError , ChdbInsertError , ChdbStreamError , ChdbArrowError , ChdbAbortError , ChdbTimeoutError , …), each carrying .code , the ClickHouse .clickhouseCode , and .cause . One data directory at a time libchdb binds a single data directory per process, so opening a Session takes the slot the stateless query / queryAsync calls were using and closes their connection. A connection closed while an operation is still running on it aborts the engine for the rest of the process, so new Session() refuses instead: Awaiting your own promise is not always enough. An aborted or timed-out call rejects immediately while the engine keeps computing, and close() returns before the connection is really gone when an operation is still using it. drainPending() waits for both: Moving between directories works the same way: after session.close() , wait with","default_branch":null,"files":null,"tree":[],"storefront":"/r/chdb-io","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/chdb-io/chdb-node/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}