使用 clickhouse-local 数据库
clickhouse-local 是一个带有嵌入版本 ClickHouse 的 CLI。
它赋予用户使用 ClickHouse 的能力,而无需安装服务器。
在本指南中,我们将学习如何从 chDB 使用 clickhouse-local 数据库。
Setup
让我们首先创建一个虚拟环境:
现在我们将安装 chDB。
确保您拥有 2.0.2 或更高版本:
现在我们要安装 ipython:
我们将使用 ipython
来运行本指南中的其余命令,您可以通过运行以下命令启动它:
Installing clickhouse-local
下载和安装 clickhouse-local 的过程与 下载和安装 ClickHouse 相同。
我们可以通过运行以下命令来完成这一步:
为了通过将数据持久化到目录中来启动 clickhouse-local,我们需要传入 --path
:
Ingesting data into clickhouse-local
默认数据库仅在内存中存储数据,因此我们需要创建一个命名数据库,以确保我们所摄取的任何数据都持久保存在磁盘上。
让我们创建一个表并插入一些随机数字:
让我们写一个查询来查看我们得到了哪些数据:
完成后,确保您从 CLI 中 exit;
,因为只有一个进程可以在这个目录上保持锁定。
如果不这样做,当我们尝试从 chDB 连接到数据库时,将会出现以下错误:
Connecting to a clickhouse-local database
返回到 ipython
shell 并从 chDB 导入 session
模块:
初始化一个指向 demo..chdb
的会话:
然后我们可以运行相同的查询,返回数字的分位数:
我们还可以从 chDB 向这个数据库插入数据:
然后我们可以从 chDB 或 clickhouse-local 重新运行分位数查询。