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

Zhengmao Zhu

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

DBeaver 是一款流行、開源的數(shù)據(jù)庫管理工具以及 SQL 客戶端，其功能強(qiáng)大，并且支持任何擁有 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 詳細(xì)進(jìn)行說明。

前置條件

DBeaver 依賴 Java (JDK) 11 ，不過其安裝包中已包含?？蛇x安裝 Maven、Git。
已安裝并啟動(dòng)了 TDengine。
若使用 TSDBDriver 驅(qū)動(dòng)類連接 TDengine，請(qǐng)?jiān)诒镜匕惭b TDengine 客戶端。
若使用 RestfulDriver 驅(qū)動(dòng)類連接 TDengine，請(qǐng)確保 taosAdapter 已經(jīng)正常運(yùn)行。

配置

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

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

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

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

點(diǎn)擊新建連接，搜索配置好的驅(qū)動(dòng)名稱，點(diǎn)擊后進(jìn)入下一步：

輸入密碼后，點(diǎn)擊“測(cè)試連接”：

驗(yàn)證

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

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

可以看到有個(gè)超級(jí)表叫做 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ù):

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

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

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