DataGrip

DataGrip 支持查询 StarRocks 中的内部数据和外部数据。

提示

DataGrip 文档

您可以使用原生的 StarRocks JDBC 驱动（推荐）或 MySQL 驱动从 DataGrip 连接到 StarRocks。

使用 StarRocks JDBC 驱动连接（推荐）

StarRocks JDBC 驱动提供准确的元数据发现，这使得 DataGrip 中能够进行模式浏览、自动完成和表内省。

先决条件

下载 StarRocks JDBC 驱动 JAR 包。请参阅 StarRocks JDBC 驱动 获取下载说明。

步骤

1. 在 DataGrip 中，转到 文件 > 数据源 （或点击 数据库 工具栏中的图标）。

2. 点击 + 并选择 驱动和数据源。

3. 在 驱动程序 选项卡中，点击 + 以创建新驱动。

   • 将 名称 设置为 StarRocks。
   • 在 驱动文件 下，点击 + 并添加您下载的 StarRocks JDBC 驱动 JAR 包。
   • 将 类 设置为 com.starrocks.cj.jdbc.Driver。
   • 将URL 模板设置为以下之一：

     jdbc:starrocks://{host}:{port}
     jdbc:starrocks://{host}:{port}/{database}

   • 点击确定以保存驱动程序。

   

4. 回到数据源选项卡，点击**+并选择StarRocks**您刚刚创建的驱动程序。

5. 配置连接设置：

   • 主机：您的 StarRocks 集群的 FE 主机 IP 地址。
   • 端口：您的 StarRocks 集群的 FE 查询端口，例如 9030。
   • 数据库：要连接的数据库，格式为 [{catalog_name}.]{database_name}。支持内部和外部目录。如果省略目录，则使用 default_catalog。
     • catalog_name：您的 StarRocks 集群中目标目录的名称。
     • database_name：您的 StarRocks 集群中目标数据库的名称。
   • 用户：登录您的 StarRocks 集群的用户名，例如 admin。
   • 密码：登录您的 StarRocks 集群的密码。

6. 点击测试连接以验证设置，然后点击确定。

备注

连接后，DataGrip 只加载数据库列表。在侧边栏中右键单击数据库并选择刷新之前，不会获取表。这是预期行为。

在侧边栏中浏览目录和数据库

连接后，有两种方法可以控制左侧边栏中显示的内容：

选项 1 — 使用 URL 直接限定到一个目录/数据库（最简单）

编辑URL字段以包含 catalog.database，如上方提示所示。DataGrip 将立即在侧边栏中显示该目录和数据库，无需进一步配置。

选项 2 — 在数据源属性中选择模式（多个目录/数据库）

1. 双击数据源（或右键单击 > 属性）。
2. 转到“模式”选项卡。
3. 勾选您希望在侧边栏中可见的目录和数据库。
4. 单击“确定”。DataGrip 将刷新并显示您的选择。

使用 MySQL 驱动程序连接

MySQL 驱动程序是 StarRocks JDBC 驱动程序的备用方案。

在 DataGrip 中创建数据源。请注意，您必须选择 MySQL 作为数据源。

您需要配置的参数如下所述：

• 主机：您的 StarRocks 集群的 FE 主机 IP 地址。
• 端口：您的 StarRocks 集群的 FE 查询端口，例如 9030。
• 身份验证：您要使用的身份验证方法。选择“用户名和密码”。
• 用户：用于登录您的 StarRocks 集群的用户名，例如 admin。
• 密码：用于登录您的 StarRocks 集群的密码。
• 数据库：您要在 StarRocks 集群中访问的数据源。此参数的值采用 <catalog_name>.<database_name> 格式。
  • catalog_name：您的 StarRocks 集群中目标目录的名称。支持内部和外部目录。
  • database_name：您的 StarRocks 集群中目标数据库的名称。支持内部和外部数据库。