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 SDK 简介环境要求、版本选择、安装和第一个查询程序
使用 database/sql 查询DSN 参数、查询、参数绑定、SQL 参数、超时与取消、Arrow 结果读取
批量写入数据(Bulkload)Bulkload 写入模式、选项、提交和错误处理
使用 GORMGORM 方言的用法和限制

选型建议

场景推荐方式说明
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 版本变更,并在测试环境验证连接、参数绑定和数据类型映射。

相关文档

联系我们
预约咨询
微信咨询
电话咨询
邮件咨询