概述--ByteHouse云数仓版-火山引擎

文档中心

立即注册

导航

概述

最近更新时间：2025.10.22 19:30:57首次发布时间：2025.10.22 19:18:53

ByteHouse 云数仓版提供了丰富的连接驱动工具，帮助您通过不同编程语言、框架快速接入并开展数据开发工作。本文将介绍驱动的核心特性、选择逻辑及使用注意事项。

概述

您可以通过连接连接驱动连接 ByteHouse 与应用程序，支持数据查询、写入、管理等操作。选择驱动时可参考以下维度：

开发语言：优先匹配您的技术栈，例如 Java 选 JDBC 类驱动；
协议兼容性：需与 ByteHouse 服务的连接协议（TCP 19000/HTTP 8123/MySQL 兼容 3306）保持一致；
功能需求：关注是否需支持 ByteHouse 自定义 Settings、长连接（KeepAlive）等特性。

驱动分类

以下按开发语言分类展示各驱动的核心信息，帮助您选择所需的连接驱动。

语言	驱动名称	支持的协议	推荐版本	默认超时时间配置	是否支持 KeepAlive	是否支持 ByteHouse 自定义 Settings
Java	ByteHouse JDBC Driver	TCP（19000）	建议使用最新版本	ping_timeout：10s query_timeout：0s send_timeout：当前不生效 receive_timeout：当前不生效 connect_timeout：0s	支持（默认即支持）	支持
	ClickHouse JDBC Driver	HTTP（8123）	建议使用 0.4.6 版本	socket_timeout：30000ms connect_timeout：5s	支持，需搭配 JDK11 使用	支持
	MySQL JDBC Driver	TCP（3306）	建议使用 8.3.0 版本	connectTimeout：0 socketTimeout：0	支持，需搭配 JDK11 使用	不支持
Golang	ClickHouse Go Driver	TCP（19000） HTTP（8123）	建议使用 V2 版本及 V2.30.0 以下的版本	TCP： dial_timeout：30s read_timeout：300s HTTP： dial_timeout：30s read_timeout：300s	TCP（19000）：支持（默认即支持） HTTP（8123）：支持（默认即支持）	支持
Golang	MySQL Go Driver	TCP（3306）	建议使用 1.8.1 版本	timeout：0s readTimeout：0s writeTimeout：0s	支持（默认即支持）	不支持
Python	ClickHouse Python Driver	TCP（19000）	建议使用 0.2.9 版本	connect_timeout：10s send_receive_timeout：300s	支持	支持
	PyMySQL	TCP（3306）	建议使用 1.1.2 版本	connect_timeout：10s read_timeout：none write_timeout：none	支持	不支持
	ClickHouse SQLAlchemy Connector	TCP（19000）	建议使用 SQLAlchemy 2.0.38 版本 Clickhouse Connect 0.3.2 版本 Bytehouse Connect 0.3.2 版本 Python 3.10	无	支持	支持
	MySQL SQLAlchemy Conncetor	无	建议使用 SQLAlchemy 2.0.41 版本 Python 3.12.6	无	不支持	不支持
C#	ClickHouse C# Driver	HTTP（8123）	建议使用 7.13.0 版本	Timeout：120s	不支持	支持
Rust	ClickHouse Rust (HTTP) Driver	HTTP（8123）	建议使用 0.13.1 版本	send_timeout：None end_timeout：None	支持	支持
PHP	ClickHouse PHP Driver	HTTP（8123）	建议使用 1.6.0 版本	setConnectTimeOut：5s setTimeout：20s setTimeout：指定的是 max_execution_time 的 ClickHouse 参数	不支持	支持

其他驱动工具

除上述语言专属驱动外，ByteHouse 还支持以下工具 / 框架的连接器，适用于特定场景：

ClickHouse NodeJS：适用于 Node.js 环境的 HTTP 协议驱动，支持服务端 JavaScript 开发场景；
Flink Connector Driver：用于 Flink 实时计算引擎与 ByteHouse 的数据同步，满足流式数据处理需求；
Spark Connector Driver：用于 Spark 批处理引擎与 ByteHouse 的数据交互，适配离线大数据分析场景。