跳到主要内容
跳到主要内容

使用 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 重新运行分位数查询。