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

背景信息

DBeaver是一款免费的多平台数据库工具,适用于开发人员、数据库管理员、分析师和所有需要使用数据库的人员。更多DBeaver信息,请参见DBeaver

前提条件

在执行操作前,请确认您已满足如下条件:
  • 已创建MaxCompute项目。

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

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

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

  • 已下载包含完整依赖JAR包jar-with-dependenciesMaxCompute JDBC驱动(v3.2.8及以上版本)

    本文中的MaxCompute JDBC驱动示例版本为v3.2.9。

  • 已下载并安装DBeaver

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

    本文中的DBeaver示例版本为Community Edition 21.1.3。

步骤一:连接DBeaver和MaxCompute

  1. 启动DBeaver,进入DBeaver界面。
  2. 在顶部菜单栏单击新建图标后,在选择新连接类型对话框选择SQL > SQLite,单击下一步
    新建连接
  3. 通用JDBC连接设置对话框的常规页签单击编辑驱动设置后,在编辑驱动对话框的页签,通过添加文件方式将MaxCompute JDBC驱动JAR包odps-jdbc-3.2.9-jar-with-dependencies.jar关联到数据源的驱动库(Libraries)中。
    编辑驱动
  4. 再次在通用JDBC连接设置对话框的常规页签单击编辑驱动设置。在编辑驱动'SQLite'对话框的设置页签填写类名com.aliyun.odps.jdbc.OdpsDriverURL模板jdbc:odps:{file},单击确定
    修改和保存了数据源配置定义后,当前的数据源已经为支持MaxCompute JDBC驱动的数据源。填写驱动类名
  5. 通用JDBC连接设置对话框的常规页签填写路径信息。
    测试连接
    参数 说明
    路径 连接MaxCompute项目的URL。格式为<MaxCompute_endpoint>?project=<MaxCompute_project_name>&accessId=<access_id>&accessKey=<access_key>[&interactiveMode={true|false}]。配置时删除<>符号。参数说明如下:
    • <MaxCompute_endpoint>:必填。MaxCompute项目所属区域的Endpoint。

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

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

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

    • access_id:必填。具备目标MaxCompute项目访问权限的AccessKey ID。

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

    • access_key:必填。AccessKey ID对应的AccessKey Secret。

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

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

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

  6. 单击测试链接,连接成功后依次单击确定完成,完成DBeaver和MaxCompute连接。
    测试连接

步骤二:使用DBeaver查询及分析数据

连接DBeaver和MaxCompute后,您可以在DBeaver左侧查看到新建的MaxCompute连接,并通过SQL管理MaxCompute项目。您可以执行如下操作,更多操作,请参见DBeaver帮助
  • 查看所有表

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

    查看所有表
  • 查看表结构

    您可以在创建的MaxCompute连接下,在目标表处单击右键,选择查看表,即可查看表结构信息。

    查看表结构
  • 查看表数据

    您可以在创建的MaxCompute连接下,在目标表处单击右键,选择查看表后,在数据页签即可查看表数据信息。

    查看表数据