全部产品
Search
文档中心

云原生大数据计算服务 MaxCompute:DataGrip连接MaxCompute

更新时间:Feb 06, 2025

MaxCompute支持您通过数据库管理工具DataGrip访问MaxCompute项目,进行数据管理操作。本文为您介绍如何通过MaxCompute JDBC驱动,连接DataGrip和MaxCompute项目并管理数据。

背景信息

DataGrip是面向开发人员的数据库管理环境,为查询、创建和管理数据库提供便利。数据库可以在本地、服务器或云中工作。更多DataGrip信息,请参见DataGrip

前提条件

在执行操作前,请确认您已满足如下条件:

  • 已创建MaxCompute项目。

    更多创建MaxCompute项目操作,请参见创建MaxCompute项目

  • 已获取可访问MaxCompute项目的AccessKey ID和AccessKey Secret。

    您可以进入AccessKey管理页面获取AccessKey ID和AccessKey Secret。

  • 已下载包含完整依赖JAR包jar-with-dependencies

    您可以直接单击odps-jdbc-3.9.0.jar进行下载,也可以通过GitHubMaven库获取MaxCompute最新版本的JAR包。本文中的MaxCompute JDBC驱动示例版本为v3.9.0。

  • 已下载并安装DataGrip

    更多安装DataGrip操作,请参见Install DataGrip

    本文中的DataGrip示例版本为2024.3.3。

操作流程

DataGrip连接MaxCompute的操作流程如下:

  1. 步骤一:添加驱动并配置数据源

    将MaxCompute JDBC驱动添加至DataGrip,后续DataGrip可通过该驱动访问MaxCompute项目。通过配置连接参数,连接DataGrip及MaxCompute项目。

  2. 步骤二:使用DataGrip管理MaxCompute项目

    在DataGrip上基于创建好的数据连接管理MaxCompute项目。

步骤一:添加驱动并配置数据源

  1. 启动DataGrip,进入DataGrip界面。

  2. 单击主菜单image,选择文件 > 新建 > 项目

    z1

  3. 在新建项目对话框,输入项目名,例如MaxCompute_test

    z2

  4. 在新建项目页面,单击左上角新建image>驱动程序

    z3

  5. 数据源和驱动程序页面,选择驱动程序页签,单击image新建用户驱动程序,并填写驱动名称。例如MaxCompute。

  6. 驱动程序文件区域,单击image>自定义JAR。从本地选择下载的MaxCompute JDBC驱动JAR包,例如odps-jdbc-3.9.0-rc4-jar-with-dependencies.jar

    z7

    参数

    说明

    Name

    添加的驱动名称,例如MaxCompute。

    Class

    上传MaxCompute JDBC驱动JAR包后,在下拉列表选择com.aliyun.odps.jdbc.OdpsDriver

  7. 选择数据源页签,单击image,选择刚创建的驱动程序,例如MaxCompute。

  8. 常规页签下配置以下信息。

    参数

    说明

    名称

    默认与驱动名称一致。您也可以自定义修改。

    身份验证

    选择用户与密码

    用户

    具备目标MaxCompute项目访问权限的AccessKey ID。

    您可以进入AccessKey管理页面获取AccessKey ID。

    密码

    AccessKey ID对应的AccessKey Secret。

    您可以进入AccessKey管理页面获取AccessKey Secret。

    URL

    连接MaxCompute项目的URL。格式为jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true|false}]。配置时删除<>符号。参数说明如下:

    • <MaxCompute_endpoint>:必填。MaxCompute项目所属区域的Endpoint。

      各地域的Endpoint信息,请参见Endpoint

    • <MaxCompute_project_name>:必填。待连接的目标MaxCompute项目名称。

      此处为MaxCompute项目名称,非工作空间名称。您可以登录MaxCompute控制台,左上角切换地域后,即可在项目管理页面查看到具体的MaxCompute项目名称。

    • interactiveMode:可选。查询加速功能开关。

      如果您需要启用查询加速功能,在URL后追加&interactiveMode=true配置即可。更多查询加速功能信息,请参见查询加速

    • useProjectTimeZone:可选。时区设置开关。如果您需要DataGrip与MaxCompute服务端实例的时区保持一致,在URL后追加&useProjectTimeZone=true配置即可。

  9. 单击测试连接,确认数据源配置成功。

    z6

  10. 单击确定完成配置。

步骤二:使用DataGrip管理MaxCompute项目

创建DataGrip和MaxCompute连接后,您可以在左侧查看到新建的MaxCompute连接。您可以通过编写SQL脚本来管理MaxCompute项目。更多操作,请参见DataGrip帮助

  • 查看所有表

    您可以在创建的MaxCompute连接下查看所有表的信息。

    z8

  • 查看表结构

    您可以在创建的MaxCompute连接下,在目标表上右键,单击新建 > 查询控制台,并在右侧SQL编辑器中编写并运行SQL脚本,即可查看表结构信息。

    z9

  • 查看表数据

    您可以在创建的MaxCompute连接下,在目标表上右键,单击新建 > 查询控制台,并在右侧SQL编辑器中编写并运行SQL脚本,即可查看表数据信息。

    z10