跳转到主要内容
chDB-go 为 chDB 提供 Go 语言绑定,让您无需任何外部依赖,即可在 Go 应用程序中直接运行 ClickHouse 查询。

安装

1

安装 libchdb

首先,安装 chDB 库:
2

安装 chdb-go

安装 Go 包:
或者将其添加到 go.mod 中:

用法

命令行客户端

chDB-go 提供了一个命令行客户端,可用于快速执行查询:

Go 库 - 快速入门

无状态查询

对于简单的单次查询:

使用会话的有状态查询

对于需要持久状态的复杂查询:

SQL 驱动程序接口

chDB-go 实现了 Go 的 database/sql 接口:

大型数据集的流式查询

对于无法装入内存的大型数据集,请使用流式查询进行处理:
流式查询的优势:
  • 节省内存 - 无需将所有数据都加载到内存中,即可处理大型数据集
  • 实时处理 - 第一个数据块一到达,就能开始处理数据
  • 支持取消 - 可使用 Cancel() 取消长时间运行的查询
  • 错误处理 - 可在流式查询过程中使用 Error() 检查错误

API 文档

chDB-go 同时提供高级 API 和低级 API:

系统要求

  • Go 1.21 或更高版本
  • 兼容 Linux 和 macOS