/libchdb

Library builder for chDB, an embedded SQL Engine powered by ClickHouse

Primary LanguageShellApache License 2.0Apache-2.0

Build Status

libchdb

Action based builder generating a chdb dynamic library for FFI bindings and integrations

chDB is an embedded SQL OLAP Engine powered by ClickHouse



📦 Installation

Install libchdb manually on x64 or arm64 Linux platforms:

Linux

📦 x86_64
wget https://github.com/metrico/libchdb/releases/latest/download/libchdb.zip
unzip libchdb.zip
mv libchdb.so /usr/lib/libchdb.so
📦 arm64
wget https://github.com/metrico/libchdb/releases/latest/download/libchdb_arm64.zip
unzip libchdb_arm64.zip
mv libchdb.so /usr/lib/libchdb.so

Packages

Install libchdb on any deb or rpm based operating system:

📦 Debian Repository (x64/arm64)
wget -q -O - https://metrico.github.io/libchdb_installer.sh | sudo bash
sudo apt install libchdb
📦 RPM Repository (x64/arm64)
wget -q -O - https://metrico.github.io/libchdb_installer.sh | sudo bash
sudo yum install -y libchdb

:octocat: Usage

A basic libchdb usage example is included with this repository:

cd example
./run.sh

Experimental libchdb binding examples:


🚧: Project Status

  • patch builder, bypass python bindings
  • package library as deb, rpm
  • host package repository on github pages/actions
  • arm64 library support
  • header files and examples