MaxCompute支持您通过数据库管理工具DBeaver访问MaxCompute项目,进行数据管理操作。本文为您介绍如何通过MaxCompute JDBC驱动,连接DBeaver和MaxCompute项目并管理数据。
背景信息
DBeaver是一款免费的多平台数据库工具,适用于开发人员、数据库管理员、分析师和所有需要使用数据库的人员。更多DBeaver信息,请参见DBeaver。
前提条件
在执行操作前,请确认您已满足如下条件:
已创建MaxCompute项目。
更多创建MaxCompute项目操作,请参见创建MaxCompute项目。
已获取可访问MaxCompute项目的AccessKey ID和AccessKey Secret。
您可以进入AccessKey管理页面获取AccessKey ID和AccessKey Secret。
已下载包含完整依赖jar-with-dependenciesJAR包。
您可以直接单击odps-jdbc-3.9.0.jar进行下载,也可以通过GitHub或Maven库获取MaxCompute最新版本的JAR包。本文中的MaxCompute JDBC驱动示例版本为v3.9.0。
已下载并安装DBeaver。
更多安装DBeaver操作,请参见Install。
本文中的DBeaver示例版本为Community Edition 24.3.1。
步骤一:连接DBeaver和MaxCompute
启动DBeaver,进入DBeaver界面。
在顶部菜单栏单击
图标后,在选择新连接类型对话框选择 ,单击下一步。
在通用JDBC连接设置对话框的常规页签单击编辑驱动设置后,在编辑驱动对话框的库页签,通过添加文件方式将MaxCompute JDBC驱动JAR包
odps-jdbc-3.9.0-rc4-jar-with-dependencies.jar
关联到数据源的驱动库(Libraries)中。再次在通用JDBC连接设置对话框的常规页签单击编辑驱动设置。在编辑驱动'SQLite'对话框的设置页签填写类名为com.aliyun.odps.jdbc.OdpsDriver,URL模板为jdbc:odps:{file},单击确定。
修改和保存了数据源配置定义后,当前的数据源已经支持MaxCompute JDBC驱动的数据源。
在通用JDBC连接设置对话框的常规页签填写JDBC URL信息。
参数
说明
路径
连接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
配置即可。更多查询加速功能信息,请参见查询加速。
单击测试链接,连接成功后依次单击确定、完成,完成DBeaver和MaxCompute连接。
步骤二:使用DBeaver查询及分析数据
连接DBeaver和MaxCompute后,您可以在DBeaver左侧查看到新建的MaxCompute连接,并通过SQL管理MaxCompute项目。您可以执行如下操作,更多操作,请参见DBeaver帮助。
查看所有表
您可以在创建的MaxCompute连接下查看所有表的信息。
查看表结构
您可以在创建的MaxCompute连接下,在目标表处单击右键,选择查看表,即可查看表结构信息。
查看表数据
您可以在创建的MaxCompute连接下,单击
,在编辑器页面输入目标表查询SQL进行查询,即可查看表数据信息。若您的项目并未开启Schema语法开关,详情请参见Schema语法开关。您也可以在创建的MaxCompute连接下,在目标表处单击右键,选择查看表后,在数据页签即可查看表数据信息。