7 社区版产品使用指南（问题排查攻略）-7.7 使用过程中可能遇到的问题-7.7.4 Waterdrop连接与使用相关问题-TDH Community Edition-星环科技

星环大数据基础平台社区版

文档搜索

7.7.4 Waterdrop连接与使用相关问题

更新时间：8/2/2024, 9:31:38 AM

Waterdrop是什么，如何安装？

产品介绍

Waterdrop是面向开发者个人的数据库开发IDE，目标是提高开发者的开发效率。产品主要功能有元数据管理、SQL开发、数据对象管理、驱动管理、连接管理、用户管理等等，更多介绍可参考：【汇总】TDS平台各工具能力一览

链接数据库教程

星环产品支持通过 Beeline、应用程序、外部工具等多种方式连接数据库，Waterdrop的链接教程可参考：连接教程

Waterdrop下载后，打开报错显示：The Waterdrop executable launcher was unable to locate its companion shared library

【核心原因】: 这个问题一般是安装的jdk版本不对，需更换为jdk1.8。

Windows系统打开Waterdrop时出现无JRE/JDK报错，应如何解决？

【报错情况】

【根因分析】

Waterdrop运行需要JAVA环境，因此需要进行Java环境的配置。
环境说明：Windows 11、Java 8

【解决步骤】

第一步：JDK的下载与安装

Jdk下载地址：

https://www.oracle.com/java/technologies/downloads/#java8 选择与电脑系统匹配的版本进行下载，Windows x86对应32位系统，Windows x64对应64位系统。MacOS系统下载请参考该文章（ https://community.transwarp.cn/article/detail?id=357 ），其他系统可以在官网寻找对应系统即可。
第二步：安装

双击下载的安装包，根据提示完成安装即可。

在此可选择安装的路径，建议使用默认路径。需记录一下安装路径，后续配置环境时会用到。

此时，已完成Java的安装。接下来要进行环境变量的配置。
第三步：配置环境变量
1. 打开环境变量
  
  右键我的电脑，点击下面的“属性”按钮，之后在弹窗中选择“高级系统设置”。
2. 配置JAVA_HOME
  
  新建系统变量
  
  变量名：JAVA_HOME
  
  变量值：安装路径
3. 配置ClassPath
  
  新建系统变量
  
  变量名：CLASSPATH
  
  变量值：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
4. 配置PATH
  
  在PATH变量后添加两条变量
  
  编辑环境变量
  
  变量值：%JAVA_HOME%\bin
  
  变量值：%JAVA_HOME%\jre\bin
5. 配置完成后，验证是否安装成功
  
  使用快捷键（win+r），输入“cmd”打开“命令提示符”以后，输入“java -version”。出现下图所示内容，即表示安装成功。
第四步：打开Waterdrop

最后，尝试打开Waterdrop可以顺利打开，问题解决。

Waterdrop 1.2.x 在MacOS Ventura 13.x上无法正常运行

【问题描述】

Waterdrop无法正常运行，解压安装包后尝试双击运行，程序栏出现Waterdrop图标但立即消失，不能成功运行。再次点击后无任何响应，排查解决思路如下。

示例环境

Waterdrop 1.2.0

MacOS Ventura 13.4

【解决步骤】

安装JDK环境 出现该错误，一般与JDK环境有关系。Waterdrop需要依赖于JDK8才能正常工作。若您的机器上尚未安装JDK8，请先安装，安装详情请查看《Mac OS系统如何安装JAVA： https://community.transwarp.cn/article/357 》文章。
尝试运行后报错 若您的 MacOS 环境上已经安装了JDK8，但 Waterdrop 依然不能成功运行，打开Waterdrop仍出现弹窗请，参照如下步骤操作。
查询Java路径

使用 Finder 或终端工具浏览到 /Library/Java/JavaVirtualMachines 并检查那里的 JDK 包名称，记录这边实际看到的 JDK 版本。例如下图中的JDK版本为1.8.0
右键点击Waterdrop图标，选择“显示包内容”
进入Contents目录，编辑info.plist文件。

进入文档后，向下滚动到文档底部，可以看到下图内容。
编辑内容

此时，需要将上图中红色框中文本移至上方，并修改图中黄色框中内容，修改为步骤3中查询到的实际版本参照如下：
尝试启动

双击Waterdrop图标，确认可以正常使用。
其他信息

如果打开waterdrop出现弹窗：“已损坏，无法打开，你应该将它移到废纸篓。”

可以先打开系统偏好设置 → 安全与隐私 → 通用选项卡，选择仍然打开；

或在终端中执行以下命令，开启允许任何来源: sudo spctl --master-disable

Error encountered near token ‘LICENSE’

【用户问题】: 这个工具是需要申请license吗？
【问题答复】: 是下载的版本不对哦，社区版Waterdrop这里做了判断。因此只能够对接社区版的Inceptor，不能连企业版inceptor。企业版Inceptor需要下载对应的商业版Waterdrop，可以参考下方手册链接了解如何申请商业版Waterdrop的许可证。 https://docs.transwarp.cn/#/documents-support/docs-detail/document/TDH-DEV_SUITE/7.0/060WaterdropManual?docType=docs%3Fcategory%3DTDH%26index%3D0&docName=Waterdrop%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C

Waterdrop如何获取Keytab文件？

【产品情况】

【获取方法】

Keytab文件可以在Guardian中对应租户的详情页获取，具体操作步骤如下：

步骤一：查看Guardian 详情页中的角色链接
步骤二：进入Guardian页面，查看租户列表
步骤三：进入对应的租户详情页，点击下载keytab按钮即可获取keytab文件
步骤四：找到对应文件的本地位置，双击选中即可。但是需要注意的是放置后如果移动该文件位置则需要重新调整链接配置tab文件。

waterdrop 突然变卡顿是为什么

【用户问题】: waterdrop 在以前用的时候是不卡顿的，但是这段时间特别卡
【问题答复】: 可能是内存占满了，可以查一下CPU 内存之类的

waterdrop可以设置行号吗?

【问题答复】: 可以，参考下图

waterdrop-inceptor：filter表如何恢复

【用户问题】: 我用waterdrop链接了inceptor，在界面左侧数据表目录中，对一个表右键点击了”filter表“，还没执行完就点了取消。结果发现左侧目录中这张表隐藏了，sql窗口中可以正常查询这张表。请问要如何恢复这张表的显示？
【问题答复】: 参考下图

Waterdrop如何把数据库中表的数据导出到本地？

【用户问题】

使用waterdrop如何把数据库中表的数据导出到本地？导出压缩或为Excel文件

【问题答复】

Waterdrop允许将表中的数据导出至指定文件或者任意连接的表中。方法如下：

在数据库导航栏中选中源表，右键点击，选择导出数据。
选择数据存储格式
设置数据提取方式
设置export属性
选择存放目标数据的地址
确认信息

具体详细信息可参考Waterdrop使用手册，第8.2章节

基于Waterdrop进行数据开发时，SQL Script如何存储以及导入新的SQL脚本？

【用户问题】: 请问我在 Waterdrop 中新建的 SQL script，在windows哪个文件夹中能找到？

另外我从别的地方拖进来的 SQL scipt："temp.sql"，不能直接执行，请问这应该怎样与数据库建立关联？
【问题答复】: 您好，在保存已编辑完成的SQL script时，为自定义保存路径，由您自行选择。连接数据库后，通过SQL编辑器—导入SQL脚本，选择您想导入的目标脚本文件。