配置DBeaver连接DLI进行数据查询和分析

操作前准备

• 工具包
  • DLI的JDBC驱动：

    在DLI管理控制台下载JDBC驱动，驱动名称：huaweicloud-dli-jdbc-xxx-dependencies.jar。

  • DBeaver客户端安装包：

    DBeaver官网提供了针对不同操作系统的客户端安装包，单击下载DBeaver访问DBeaver官网下载系统对应的DBeaver客户端安装包并完成安装 。推荐使用24.0.3版本的DBeaver。

• 连接信息：

  表1 连接信息

  类别	说明	获取方式
  DLI AKSK	AK/SK认证就是使用AK/SK对请求进行签名，从而通过身份认证。	获取AK/SK
  DLI Endpoint地址	地区与终端节点，即云服务在不同Region有不同的访问域名。	获取EndPoint
  DLI所在的项目ID	项目编号，用于资源隔离。	获取项目ID
  DLI区域信息	DLI所属区域信息	地区和终端节点

步骤1：在DBeaver新建DLI JDBC驱动

1. 在DBeaver单击“数据库 > 驱动管理器”，创建新的驱动连接。

   使用驱动类加载DLI的JDBC驱动，请确保使用的jar包为huaweicloud-dli-jdbc-2.1.1-jar-with-dependencies.jar。

2. 打开创建新驱动界面。
3. 在“设置”页输入驱动相关参数说明，单击“确定”创建驱动。
   驱动参数配置说明请参考表2。

   表2 驱动相关参数说明

   参数	说明
   驱动名称	命名为便于识别的名称，例如GaussDB Driver。
   驱动类型	驱动类型选择Generic。
   类名	在JDBC驱动中用于建立数据库连接的Java类名。
   URL模板	DLI JDBC驱动连接的格式： DLI JDBC驱动连接配置示例请参考•DLIJDBC驱动连接的格式：和•DLIJDBC驱动连接配置示例：。 jdbc:dli://<endPoint>/projectId?<key1>=<val1>;<key2>=<val2>...
   默认端口	需要连接的数据库端口。
   Default Database	需要连接的数据库名。
   Default User	账号名称。默认root。

   • DLI JDBC驱动连接的格式

     jdbc:dli://<endPoint>/projectId?<key1>=<val1>;<key2>=<val2>...

     ? 后面接其他配置项，每个配置项以 key=value 的形式列出，配置项之间以 ; 隔开。

   • DLI JDBC驱动连接配置示例

     jdbc:dli://dli.ap-southeast-2.myhuaweicloud.com/0b33ea2a7e0010802fe4c009bb05076d?databasename=tpch;queuename=auto;accesskey=XXXX;secretkey=XXXXX;regionname=ap-southeast-2;enginetype=trino;catalog=lfcatalog

     详细参数说明请参考表3和表4。

     表3 驱动连接配置信息参数说明

     参数	说明	获取方式
     endPoint	地区与终端节点，即云服务在不同Region有不同的访问域名。	获取AK/SK
     projectId	DLI资源所在的项目ID。	获取EndPoint
     <key1>=<val1>	连接中? 后面接其他配置项，每个配置项以 key=value 的形式列出，配置项之间以 ; 隔开。	请参考表4

     表4 key=value参数说明

     参数	说明	是否必选	示例
     queuename	DLI服务的队列名称。	是	dli_test
     databasename	数据库名称。	是	tpch
     accesskey和secretkey	AK/SK认证密钥。 如果使用AK/SK认证方式。	是	accesskey=your-access-key secretkey=your-secret-key
     regionname	DLI的区域名称。 如果使用AK/SK认证方式时配置。	是	-
     charset	JDBC编码方式。 默认为UTF-8。	否	-
     enginetype	DLI的队列类型。 spark：Spark队列 hetuEngine：HetuEngine队列 默认配置为spark。	否	spark
     catalog	元数据catalog名称。 使用Lakeformation catalog时必填，对应的Lakeformation catalog名称。 查询Lakeformation catalog时， catalog下面必须有 default数据库。 不填写时默认DLI catalog，使用DLI catalog时无需配置该参数。	否	假设使用名称为lfcatalog的Lakeformation catalog时，配置如下：catalog=lfcatalog

4. 在“库”页中，单击添加文件，添加1中的dli-jdbc-xxx-dependencies.jar。
5. 添加后驱动类为空，需要单击“找到类”。识别出来的驱动类，需要与“设置”页的“类名”一致。
6. 单击“确定”，驱动设置完成。

步骤2：测试连接数据库

1. 在DBeaver客户端单击“数据库 > 新建数据库连接”，选择步骤1：在DBeaver新建DLI JDBC驱动中创建的数据驱动。
2. 单击“完成”，即可连接到DLI。在“数据库导航”栏可查看到连接的数据库信息。
3. 通过新建的连接即可对DLI执行后续的数据查询相关工作。

步骤3：在DBeaver编写SQL查询

在DBeaver建立与DLI的连接后，即可在DBeaver编写SQL查询：

1. 您可以在左侧的数据库导航面板中选择数据库对象，然后在中间的查询编辑器中编写SQL语句。
2. 编写完查询后，可以单击工具栏上的“运行”按钮（通常是一个绿色的播放图标）来执行查询。
3. 查询执行后，结果将显示在查询编辑器下方的数据网格中。