You need to enable JavaScript to run this app.
导航
Go Driver
最近更新时间:2025.08.01 15:52:59首次发布时间:2024.09.20 18:02:26
复制全文
我的收藏
有用
有用
无用
无用

本文介绍如何通过 ClickHouse Go Driver 连接并访问 ByteHouse 企业版。

前提条件

点击 此处 下载 v2.3.0 版本驱动程序。

注意

推荐使用 v2.3.0 版本驱动连接到 ByteHouse 企业版,其他版本的驱动可能会导致不兼容情况。

连接到 ByteHouse

请参考获取集群连接信息,获取集群连接地址、连接用户名与密码。

基本使用

连接集群

您可以参考如下代码,连接到ByteHouse企业版。使用时,请替换其中的验证信息。

import (
  "context"
  "fmt"
  "github.com/ClickHouse/clickhouse-go/v2"
)

conn, _ := clickhouse.Open(&clickhouse.Options{
Addr: []string{"<HOST>:9000"},
Auth: clickhouse.Auth{Database: "default", Username: "<USERNAME>", Password: "<连接密码>"},
})

// test connection
if err := conn.Ping(context.Background()); err != nil {
fmt.Printf("error %s", err)
}

defer conn.Close()

参数说明:

参数

配置要点

<HOST>

配置为 ByteHouse 企业版网关地址。
您可登录 ByteHouse 企业版控制台,通过集群管理 > 集群列表 > 集群 > 基本信息路径,查看并复制公网或私网网关地址。

<PORT>

固定配置为 9000。

Database

配置为 default。如需连接至其他数据库,可设置为所需数据库名称。

Username

配置为用户名。
您可登录 ByteHouse 企业版控制台,通过权限管理 > 用户 > 用户列表 路径,查看并复制用户名。

Password

配置为用户名对应的密码。
您可登录 ByteHouse 企业版控制台,单击右上角个人中心,单击账号管理,复制集群连接账号中的连接密码。

您也可以在 集群管理 > 集群列表 > 集群 > 连接集群 页签中,查看到 Golang 驱动程序的连接命令,点击复制按钮即可获取。
Image

官方使用示例

另外,您可参考以下 SQL 用例,连接和使用 ByteHouse 企业版。