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

前提条件

1. 请提前安装好 DataGrip ，并获得相应的商用授权。
2. 从 ByteHouser JDBC driver 的 发布页面 获取最新版本的jar文件。
3. 您可以在 租户管理-参数设置 页面设置默认连接的计算组/数据库。

使用限制

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

可以通过在DataGrip上进行如下设置可以解决此问题：

1. 进入DataGrip-Settings-Database-Data Editor and Viewer页签。
2. 将 Limitations 的第一项“ Limit page size to:” 选项去掉勾选。
3. 点击 OK 按钮保存设置。

使用 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 可以在 租户管理-连接信息 页面中创建。URL 字段格式如下:

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

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

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

参考

要了解有关 DataGrip 的更多信息，请访问 DataGrip官方文档。