You need to enable JavaScript to run this app.
导航

通过驱动连接到 ByteHouse

最近更新时间2023.11.17 17:58:52

首次发布时间2023.07.27 10:36:23

计算组和默认角色

与ByteHouse的连接初始化始终采用默认的计算组和默认角色,因此这些值不能为空。在使用驱动程序之前,用户需要通过 控制台-帐户详细信息 中确认这些值。

图片

获取连接信息

一般情况下,连接到 ByteHouse 需要以下信息:

  • {HOST}:{PORT} 集群的访问地址和端口
  • {API_KEY} 当前账户的 API Token

说明

火山引擎 ByteHouse 的 User 用户默认为bytehouse
非火山引擎托管的 ByteHouse, 需要与平台管理员获取 {USERNAME} 信息。

获取集群信息

您也可以在控制台 右上角 设置图标 - 我的账户 页面,获取到集群相关连接方式的连接地址。
图片
火山引擎 ByteHouse 集群的{HOST}:{PORT} 信息,您也可以根据节点位置参考 支持的地域及可用区 查询。

获取 API Token

帐户详细信息 页面中,单击 Access Token 表单下的”新建“按钮来创建 API Token。
图片

图片

ByteHouse Driver 连接示例

Go 连接示例

db, err := sql.Open("bytehouse", "tcp://{HOST}:{PORT}?secure=true&user=bytehouse&password={API_KEY}")

// 或者您也可以在url中指定连接某数据库
db, err := sql.Open("bytehouse", "tcp://{HOST}:{PORT}?secure=true&user=bytehouse&password={API_KEY}&database={DATABASE}")

if err != nil {
    fmt.Printf("error = %v", err)
    return
}
defer db.Close()

JDBC 连接示例

String url = String.format("jdbc:bytehouse://{HOST}:{PORT}/?secure=true&user=bytehouse&password={API_KEY}");

*// 或者您也可以在url中指定连接某数据库
String url = String.format("jdbc:bytehouse://{HOST}:{PORT}/?secure=true&user=bytehouse&password={API_KEY}&database={DATABASE}");

Python 连接示例

from bytehouse_driver import Client

client = Client.from_url('bytehouse://{}:{}/?user=bytehouse&password={}&secure=true'.format(HOST, PORT, API_KEY))

# 或者您也可以在url中指定连接某数据库
client = Client.from_url('bytehouse://{}:{}/?user=bytehouse&password={}&database={}&secure=true'.format(HOST, PORT, API_KEY, DATABASE))

说明

如果您想设置连接的默认数据库,可以参考设置默认数据库