如何通過開源數(shù)據(jù)庫管理工具 DBeaver 連接 TDengine

Zhengmao Zhu

2022-07-25 / 技術文章 - 時序數(shù)據(jù)庫, Chinese, Time Series DataBase

DBeaver 是一款流行、開源的數(shù)據(jù)庫管理工具以及 SQL 客戶端，其功能強大，并且支持任何擁有 JDBC-Driver 的數(shù)據(jù)庫（這意味著支持幾乎所有數(shù)據(jù)庫）。
其官網(wǎng)的介紹是這樣的：
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 的用戶，經(jīng)常問到如何使用 DBeaver 來連接、管理 TDengine。本文將通過 22.1.2 版本的 DBeaver 詳細進行說明。

前置條件

DBeaver 依賴 Java (JDK) 11 ，不過其安裝包中已包含?？蛇x安裝 Maven、Git。
已安裝并啟動了 TDengine。
若使用 TSDBDriver 驅(qū)動類連接 TDengine，請在本地安裝 TDengine 客戶端。
若使用 RestfulDriver 驅(qū)動類連接 TDengine，請確保 taosAdapter 已經(jīng)正常運行。

配置

可以克隆 DBeaver 在 GitHub 上的源碼，執(zhí)行 mvn package，也可以直接下載打包好的安裝包。此處選擇直接下載安裝包。
在 GitHub DBeaver 倉庫的 Releases 處下載對應版本的 DBeaver，比如系統(tǒng)為 macOS，處理器芯片是 M1 ，此處下載 dbeaver-ce-22.1.2-macos-aarch64.dmg 進行安裝。
點擊數(shù)據(jù)庫標簽，選擇驅(qū)動管理器：

新建驅(qū)動，選擇編譯好的 dist-jar 驅(qū)動包，驅(qū)動包可以下載或者自行編譯、打包，可參考 IDEA 博客：

添加后點擊找到類，此處使用 RESTful 驅(qū)動類演示（注意：若使用 com.taosdata.jdbc.TSDBDriver 驅(qū)動類，則需要安裝 TDengine 客戶端）：

填寫一下驅(qū)動名稱，簡單填下配置（需要在 hosts 文件上添加連接串內(nèi)域名的解析）：

點擊新建連接，搜索配置好的驅(qū)動名稱，點擊后進入下一步：

輸入密碼后，點擊“測試連接”：

驗證

連接成功后，界面左側(cè)能看到刷新出來的數(shù)據(jù)庫（database），點擊特定的表可以查看表的結(jié)構(gòu)及數(shù)據(jù)：

點擊界面左上方的新建 SQL 編輯器，默認，輸入 SQL 進行驗證。需要注意的是，RESTful 請求是無狀態(tài)的，查詢、寫入需要在表名前帶上數(shù)據(jù)庫名。
2.X 版本中默認帶 log 庫，我們可以使用 SHOW log.stables;查看包含哪些超級表后對特定表進行查詢、調(diào)試:

可以看到有個超級表叫做 dnodes_info，執(zhí)行 describe log.dnodes_info;查看表結(jié)構(gòu):

再執(zhí)行 select last_row(*) from log.dnodes_info group by dnode_id;通過 dnode_id 能分組查詢各 dnode_id 下的最新一條數(shù)據(jù):

還有其他操作也可以測試，比如寫入一條數(shù)據(jù)后進行查詢：

好了，到這里我們就大功告成了。DBeaver 功能強大，其他常用功能還包括導入導出 SQL 腳本、配置表過濾器、建立數(shù)據(jù)庫任務等，大家可以慢慢體驗。

結(jié)尾語
感謝您閱讀本篇博客，希望以上內(nèi)容對您有幫助。您在使用 TDengine 這款 TIme Series Database 的過程中，若遇到棘手的問題或?qū)?TDengine 有改進意見，歡迎在 GitHub 上給我們提 Issue ，內(nèi)容越詳細越好，也可微信掃下方二維碼加入社區(qū)，與大家進行交流 ~ 最后，感謝使用 TDengine！