SQL Workbench/J连接云器Lakehouse

云器Lakehouse为您提供了一种便捷的途径，通过数据库管理工具SQL Workbench/J来访问和管理Lakehouse中的数据。本文档将详细介绍如何使用SQL Workbench/J连接云器Lakehouse，并提供一些实用的操作示例。

背景信息

SQL Workbench/J是一款免费的、跨平台的SQL查询工具，采用Java语言编写，适用于所有提供Java运行环境的操作系统。

预备条件

在开始操作前，请确保您已满足以下条件：

• 已安装Java 11版本。
• 已开通Lakehouse服务。
• 已下载Lakehouse JDBC驱动。
• 已下载并安装SQL Workbench/J。本文以SQL Workbench/J Build 128为例。

步骤一：启动SQL Workbench/J

1. 为确保SQL Workbench/J正常运行，需要在环境变量中添加JDK_JAVA_OPTIONS=--add-opens=java.base/java.nio=ALL-UNNAMED。请注意，仅当您使用的是Java 1.8或更低版本时，才需要修改此参数。由于SQL Workbench/J Build 128要求使用Java 11，因此必须进行此修改。
2. 在Linux系统下，通过执行sh sqlwbconsole.sh命令启动SQL Workbench/J。对于Windows系统，直接点击SQLWorkbench64.exe即可启动。

步骤二：添加云器Lakehouse驱动

1. 启动SQL Workbench/J后，系统会自动弹出“Select Connection Profile”对话框。如果没有弹出，请点击“Driver”菜单，选择“Manage Drivers”。
2. 在“Manage Drivers”对话框左下角，点击“Add Driver”按钮，创建一个新的驱动。输入自定义驱动名称，并上传已下载的云器JDBC驱动JAR包。完成后，点击“OK”按钮，完成驱动配置。请注意，上传Lakehouse JDBC驱动后，将“Classname”配置为com.clickzetta.client.jdbc.ClickZettaDriver。

预览

步骤三：SQL Workbench/J连接云器Lakehouse

1. 在“Select Connection Profile”对话框右侧的Profile配置界面，选择刚刚创建的云器驱动。从Lakehouse首页复制JDBC连接字符串。

预览

预览

2. 在Profile配置界面的“Connection”选项卡中，粘贴刚刚复制的JDBC连接字符串。如有需要，您还可以在“Advanced”选项卡中设置其他连接参数，如SSL、最大连接数等。

步骤四：使用SQL Workbench/J管理云器Lakehouse

1. 连接成功后，您可以在左侧菜单栏查看所有的schema和table。

预览

2. 在右侧的SQL编辑器中，您可以编写并执行SQL查询。例如，尝试执行以下查询，查看某个表的数据：

SELECT * FROM your_table_name LIMIT 10;

3. 您还可以使用SQL Workbench/J的导入导出功能，将数据从其他数据源导入到云器Lakehouse，或将数据导出到其他数据源。

通过以上步骤，您已成功使用SQL Workbench/J连接并管理云器Lakehouse。如有疑问或需要进一步的帮助，请随时联系我们的技术支持团队。