DataGrip（TCP）

DataGrip 是 JetBrains 公司专为数据库开发人员和管理员设计的一套集成开发环境（IDE）。它支持各种数据库管理系统，提供智能代码完成，并便于版本控制集成。
本文将介绍 DataGrip 如何通过JDBC 驱动，以 TCP 的方式来连接 ByteHouse 云数仓版。

前提条件

1. 请提前安装好 DataGrip ，并获得相应的商用授权。
2. 从 ByteHouser JDBC driver 的 发布页面 获取最新版本的jar文件。

使用限制

当使用Bytehouse JDBC TCP驱动程序进行连接时，设置项 max_result_rows可能不生效。因此，分页功能没有得到很好的支持。预期返回的行可能与实际返回的行不同。

使用 DataGrip 连接 ByteHouse

1. 启动 DataGrip，在 Database Explorer 页签单击 + 图标，选择 Driver 。

2. 给驱动取一个名称，如“ByteHouse JDBC Driver"。 单击 Driver Files 中的 + 号，在弹出的窗口中选择 Custom JARs ，选择本地下载好的 JDBC 驱动 jar文件。

3. 在 Class 中选择 com.bytedance.bytehouse.jdbc.ByteHouseDriver，点击 Apply 保存。

4. 在 Database Explorer 页签单击 + 图标，选择 Data Source -> ByteHouse JDBC Driver。

5. User 字段默认为bytehouse。Password 字段为 API key 可以从 我的账户-Access Token 获取。URL 字段格式如下:

jdbc:bytehouse://{HOST}:{PORT}/?secure=true&user=bytehouse&password={API_KEY}

其中，{HOST}:{PORT}字段取决于集群所在区域，请点击 支持的地域及可用区 查询。

6. 单击 Test Connection，显示 Succeeded 则连接成功。

参考

1. 要了解有关 DataGrip 的更多信息，请访问 DataGrip官方文档。
2. 如果您不希望在 DataGrip 中指定计算组/数据库，可以在设置-我的帐户 的详细信息页面来选择默认的计算组/数据库。