使用 clickhouse-local DATABASE
clickhouse-local 是一个嵌入了 ClickHouse 的命令行工具。
它使用户能够使用 ClickHouse 而无需安装服务器。
在本指南中，我们将学习如何从 chDB 使用 clickhouse-local 数据库。
Setup
首先创建一个虚拟环境：
python -m venv .venv
source .venv/bin/activate
现在我们将安装 chDB。
确保你安装的版本是 2.0.2 或更高版本：
pip install "chdb>=2.0.2"
现在我们将安装 ipython：
我们将使用 ipython 来运行本指南中的命令，你可以通过运行以下命令启动它：
Installing clickhouse-local
下载和安装 clickhouse-local 的过程与 下载和安装 ClickHouse 相同。
我们可以通过运行以下命令来实现：
curl https://clickhouse.com/ | sh
要启动 clickhouse-local 并将数据持久化到某个目录中，我们需要传递一个 --path 参数：
./clickhouse -m --path demo.chdb
Ingesting data into clickhouse-local
默认数据库仅存储内存中的数据，因此我们需要创建一个命名数据库，以确保我们输入的任何数据都持久化到磁盘。
让我们创建一个表并插入一些随机数字：
CREATE TABLE foo.randomNumbers
ORDER BY number AS
SELECT rand() AS number
FROM numbers(10_000_000);
让我们写一个查询来查看我们有哪些数据：
SELECT quantilesExact(0, 0.5, 0.75, 0.99)(number) AS quants
FROM foo.randomNumbers
┌─quants────────────────────────────────┐
│ [69,2147776478,3221525118,4252096960] │
└───────────────────────────────────────┘
完成后，请确保从 CLI 中 exit;，因为只有一个进程可以锁定该目录。
如果我们不这样做，当尝试从 chDB 连接到数据库时会出现以下错误：
ChdbError: Code: 76. DB::Exception: Cannot lock file demo.chdb/status. Another server instance in same directory is already running. (CANNOT_OPEN_FILE)
Connecting to a clickhouse-local database
返回到 ipython shell 并从 chDB 导入 session 模块：
from chdb import session as chs
初始化一个指向 demo..chdb 的会话：
sess = chs.Session("demo.chdb")
然后我们可以运行相同的查询，返回数字的分位数：
sess.query("""
SELECT quantilesExact(0, 0.5, 0.75, 0.99)(number) AS quants
FROM foo.randomNumbers
""", "Vertical")
Row 1:
──────
quants: [0,9976599,2147776478,4209286886]
我们也可以从 chDB 向这个数据库插入数据：
sess.query("""
INSERT INTO foo.randomNumbers
SELECT rand() AS number FROM numbers(10_000_000)
""")
Row 1:
──────
quants: [0,9976599,2147776478,4209286886]
然后我们可以从 chDB 或 clickhouse-local 重新运行分位数查询。
