How to connect TDengine through DBeaver?

DBeaver 是一款流行、开源的数据库管理工具以及 SQL 客户端,其功能强大,并且支持任何拥有 JDBC-Driver 的数据库（这意味着支持几乎所有数据库）.

其官网的介绍是这样的：

Free multi-platform database tool for developers, database administrators, analysts and all people who need to work with databases. Supports all popular databases: MySQL, PostgreSQL, SQLite, Oracle, DB2, SQL Server, Sybase, MS Access, Teradata, Firebird, Apache Hive, Phoenix, Presto, etc.

很多 

TDengine

 的用户,经常问到如何使用 DBeaver 来连接、管理 TDengine.本文将通过 22.1.2 版本的 DBeaver 详细进行说明.

前置条件

• DBeaver 依赖 Java (JDK) 11 ,不过其安装包中已包含.可选安装 Maven、Git.

• 已安装并启动了 TDengine.

• 若使用 TSDBDriver 驱动类连接 TDengine,请在本地安装 TDengine 客户端.

• 若使用 RestfulDriver 驱动类连接 TDengine,请确保 taosAdapter 已经正常运行.

配置

• 可以克隆 DBeaver 在 GitHub 上的源码,执行 
  mvn package
  ,也可以直接下载打包好的安装包.此处选择直接下载安装包.

• 在 GitHub DBeaver 仓库的 
  Releases
   处下载对应版本的 DBeaver,比如系统为 macOS,处理器芯片是 M1 ,此处下载 
  dbeaver-ce-22.1.2-macos-aarch64.dmg
   进行安装.

• 点击数据库标签,选择驱动管理器：

• 新建驱动,选择编译好的 dist-jar 驱动包,驱动包可以下载或者自行编译、打包,
  可参考 IDEA 博客
  ：

• 添加后点击找到类,此处使用 RESTful 驱动类演示（注意：若使用 
  com.taosdata.jdbc.TSDBDriver
   驱动类,则需要安装 TDengine 客户端）：

• 填写一下驱动名称,简单填下配置（需要在 hosts 文件上添加连接串内域名的解析）：

• 点击新建连接,搜索配置好的驱动名称,点击后进入下一步：

• 输入密码后,点击“测试连接”：

验证

• 连接成功后,界面左侧能看到刷新出来的数据库（database）,点击特定的表可以查看表的结构及数据：

• 点击界面左上方的新建 SQL 编辑器,默认,输入 SQL 进行验证.需要注意的是,RESTful 请求是无状态的,查询、写入需要在表名前带上数据库名.

• 2.X 版本中默认带 log 库,我们可以使用 
  SHOW log.stables;
  查看包含哪些超级表后对特定表进行查询、调试:

• 可以看到有个超级表叫做 dnodes_info,执行 
  describe log.dnodes_info;
  查看表结构:

• 再执行 
  select last_row(*) from log.dnodes_info group by dnode_id;
  通过 
  dnode_id
   能分组查询各 
  dnode_id
   下的最新一条数据:

• 还有其他操作也可以测试,比如写入一条数据后进行查询：

好了,到这里我们就大功告成了.DBeaver 功能强大,其他常用功能还包括导入导出 SQL 脚本、配置表过滤器、建立数据库任务等,大家可以慢慢体验.

感谢您阅读本篇博客,希望以上内容对您有帮助.您在使用TDengine这款Time Series Database的过程中,若遇到棘手的问题或对

TDengine

有改进意见,欢迎在

GitHub

上给我们提Issue,内容越详细越好,也可vx添加小T（tdengine）为好友加入社区,与大家进行交流~最后,感谢使用TDengine！