How to connect DBeaver TDengine?

DBeaver is a popular, open source database management tool and SQL client that is powerful and supports any database with a JDBC-Driver (which means almost any database).

The introduction of its official website is as follows:

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.

Many TDengine users often ask how to use DBeaver to connect and manage TDengine.This article will be explained in detail with DBeaver version 22.1.2.

Preconditions

1. DBeaver depends on Java (JDK) 11, but it is included in the installation package.Optionally install Maven, Git.
2. TDengine is installed and started.
3. If you use the TSDBDriver driver class to connect to TDengine, please install the TDengine client locally.
4. If you use RestfulDriver to connect to TDengine, please make sure that taosAdapter is running normally.

Configuration

• You can clone the source code of DBeaver on GitHub, execute mvn package, or directly download the packaged installation package.Here, choose to download the installation package directly.
• Releases to download the corresponding version of DBeaver. For example, the system is macOS and the processor chip is M1. Download dbeaver-ce-22.1.2-macos-aarch64.dmg here for installation.
• Click on the Database tab and select the driver manager:

Create a new driver and select the compiled dist-jar driver package, the driver package can be downloaded or compiled and packaged by yourself, please refer to IDEA Blog:

After adding, click to find the class, use the RESTful driver class demo here (Note: If you use the com.taosdata.jdbc.TSDBDriver driver class, you need to install the TDengine client):

Fill in the driver name and simply fill in the configuration (you need to add the resolution of the domain name in the connection string to the hosts file):

Click New Connection, search for the configured driver name, click to go to the next step:

After entering the password, click "Test Connection":

Authentication

After the connection is successful, you can see the refreshed database on the left side of the interface. Click on a specific table to view the structure and data of the table:

Click the new SQL editor at the top left of the interface, by default, enter SQL for verification.It should be noted that RESTful requests are stateless, and queries and writes require the database name before the table name.
2.X version comes with log library by default, we can use SHOW log.stables; query and debug specific tables after checking which super tables are included:

You can see that there is a super table called dnodes_info, execute describe log.dnodes_info; view table structure:

Then execute select last_row(*) from log.dnodes_info group by dnode_id; the latest data under each dnode_id can be grouped by dnode_id:

There are other operations that can also be tested, such as writing a piece of data and querying:

Well, here we are done.DBeaver has powerful functions. Other common functions include importing and exporting SQL scripts, configuring table filters, creating database tasks, etc. You can experience it slowly.
Thank you for reading this blog, I hope the above is helpful.You are using TDengine In the process of this Time Series Database, if you encounter difficult problems or have suggestions for improvement of TDengine, welcome to GitHub to give us an Issue. The more detailed the content, the better. You can also add a small T (tdengine) to vx.) Join the community for friends and communicate with everyone~ Finally, thank you for using TDengine!