DBeaver连接MaxCompute

更新时间:2025-03-14 06:37:02

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

背景信息

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

前提条件

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

  • 已创建MaxCompute项目。

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

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

    详情请参见创建访问密钥AccessKey

  • 已下载包含完整依赖jar-with-dependenciesJAR包。

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

  • 已下载并安装DBeaver

    更多安装DBeaver操作,请参见Install。本文中的DBeaver示例版本为Community Edition 24.3.1。

步骤一:连接DBeaverMaxCompute

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

  2. 选择要连接的数据库类型。

    在顶部菜单栏单击新建图标后,在选择您的数据库对话框选择SQL > SQLite,单击下一步,进入通用JDBC连接设置对话框。

  3. 编辑驱动设置。

    1. 通用JDBC连接设置主要页签单击编辑驱动设置

    2. 设置类名和URL模板。

      编辑驱动'SQLite'对话框的设置页签,填写类名com.aliyun.odps.jdbc.OdpsDriverURL模板jdbc:odps:{file}image

    3. 添加JDBC驱动JAR包。

      编辑驱动'SQLite'对话框的页签,通过添加文件方式将MaxCompute JDBC驱动JARodps-jdbc-3.9.0-rc4-jar-with-dependencies.jar关联到数据源的驱动库(Libraries)中。image

    4. 单击确定

  4. 填写JDBC URL信息。

    通用JDBC连接设置对话框的主要页签填写如下JDBC URL信息。

    参数

    说明

    参数

    说明

    连接方式

    选择URL

    JDBC URL

    连接MaxCompute项目的URL。

    • 示例:jdbc:odps:https://service.cn-hangzhou.maxcompute.aliyun.com/api?project=test&accessId=xx&accessKey=xx

    • URL格式:jdbc:odps:<maxCompute_endpoint>?project=<maxCompute_project_name>&accessId=<access_id>&accessKey=<access_key>[&interactiveMode={true|false}]。配置时删除<>符号。

      • <maxCompute_endpoint>:必填。MaxCompute项目所属区域的Endpoint。详情请参见Endpoint

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

      • access_id:必填。具备目标MaxCompute项目访问权限的AccessKey ID。您可以进入AccessKey管理页面获取AccessKey ID。

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

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

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

  5. 单击测试链接,若弹出的连接测试对话框中显示已连接,则表示DBeaverMaxCompute连接成功。P6

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

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

  • 查看所有表

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

    P7

  • 查看表结构

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

    P8

  • 查看表数据

    • 您可以在创建的MaxCompute连接下,单击SQL编辑器 > 新建SQL编辑器,在编辑器页面输入目标表查询SQL进行查询,即可查看表数据信息。

      p9

    • 若您的项目并未开启Schema语法开关,详情请参见Schema语法开关。您也可以在创建的MaxCompute连接下,在目标表处单击右键,选择查看表后,在数据页签即可查看表数据信息。

      p10

  • 本页导读 (1)
  • 背景信息
  • 前提条件
  • 步骤一:连接DBeaver和MaxCompute
  • 步骤二:使用DBeaver查询及分析数据
AI助理

点击开启售前

在线咨询服务

你好,我是AI助理

可以解答问题、推荐解决方案等