通过驱动连接到 ByteHouse

计算组和默认角色

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

获取连接信息

一般情况下，连接到 ByteHouse 需要以下信息：

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

获取集群信息

您也可以在控制台 右上角 设置图标 - 我的账户 页面，获取到集群相关连接方式的连接地址。

火山引擎 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))