Go SDK
goclickzetta
goclickzetta
是云器 Lakehouse 的官方 Go 驱动,相当于 Go 应用与 Lakehouse 之间的
database/sql
database/sql
适配层。Go 服务或批处理程序需要执行 SQL、读取结果或批量写入数据时使用它;Java 和 Python 应用分别使用
Java SDK 和
Python SDK,数据已经位于对象存储时优先使用
COPY INTO
COPY INTO
。
驱动通过空白导入向
database/sql
database/sql
注册
clickzetta
clickzetta
,由
sql.DB
sql.DB
管理连接池,再将查询和写入请求提交到 Lakehouse。
概述
| 能力 | 入口 | 适用场景 |
|---|
| 标准 SQL 接口 | database/sql
database/sql | 查询、DML、参数绑定和 Go 应用集成 |
| Arrow 结果读取 | QueryArrowStream
QueryArrowStream | 以列式格式读取大结果集,避免逐行转换 |
| 批量写入 | CreateBulkloadStream
CreateBulkloadStream | 将 Go 内存中的大量结构化数据写入 Lakehouse |
| GORM 适配 | goclickzetta.Open
goclickzetta.Open | 使用 GORM 执行查询和 DML |
本章内容
选型建议
| 场景 | 推荐方式 | 说明 |
|---|
| Go 服务执行查询并读取结果 | database/sql
database/sql | 标准接口,兼容常见 Go 框架和连接池用法 |
| 少量、低频写入 | ExecContext
ExecContext | 直接执行 INSERT
INSERT 、UPDATE
UPDATE 或 DELETE
DELETE ,调用方式与标准 database/sql
database/sql 一致 |
| Go 内存中的大批量数据 | Bulkload | 支持 APPEND
APPEND 、OVERWRITE
OVERWRITE 和 UPSERT
UPSERT ,适合高吞吐批量任务 |
| 已在 OSS、COS 或 S3 中的文件 | COPY INTO
COPY INTO | 直接从对象存储加载,减少应用侧数据传输 |
| 读取大结果集做列式处理 | QueryArrowStream
QueryArrowStream | 直接返回 Arrow RecordReader |
使用注意
- 新应用使用主版本。Arrow v12 兼容版和无 Arrow 版已冻结,只在应用无法使用主版本依赖时选用,详见 版本选择。
- 复用
sql.DB
sql.DB
,让 database/sql
database/sql
管理连接池;不要为每条查询重复创建连接池。
context.Context
context.Context
的超时只控制客户端等待结果的时间,不会取消服务端作业。需要取消作业时使用 sdk.job.timeout
sdk.job.timeout
或 Cancel
Cancel
,详见 超时与取消。
- 使用完成后关闭
sql.DB
sql.DB
;查询返回多行时还需要关闭 sql.Rows
sql.Rows
并检查 rows.Err()
rows.Err()
。
- GORM 适配器不支持 Schema 迁移,表结构应通过 Lakehouse DDL 管理。
- 升级 SDK 前查看 GitHub 版本变更,并在测试环境验证连接、参数绑定和数据类型映射。
相关文档