时序数据库 IoTDB 集成 DBeaver,简易操作实现时序数据清晰管理

随着物联网场景对时序数据处理需求激增,时序数据库与数据库管理工具的集成尤为关键。作为数据资产的 “智能管家”,借助数据库管理工具的可视化操作界面和自动化功能,可以清晰看到时序数据库存储的数据结构,让数据管理以更便捷的方式落地。

国产原生时序数据库 IoTDB 专注时序数据存储,使用 JDBC 与数据库管理工具 DBeaver 的集成适用于树/表双模型,不仅提高了数据管理的效率,还降低了数据管理的技术门槛。

  • 层级路径树形导航:DBeaver 界面支持直接展开 IoTDB 的数据库、设备、测点,像操作文件夹一样管理时序数据。

  • 数据导入/导出自动化:DBeaver 可实现 IoTDB 数据导入导出全程图形化操作,降低操作门槛。

  • 多维数据透视:DBeaver 的多标签页操作可同时连接 IoTDB 与业务数据库(如 MySQL、Oracle),实现跨库关联分析。

欢迎查看用户手册了解更多内容!

01 功能简介

DBeaver 是一款开源的通用数据库管理工具,支持数据查询与可视化、元数据管理、数据导入导出、驱动扩展等核心特性,为多种数据库(如 MySQL、PostgreSQL、Oracle等)提供跨平台的图形化操作界面。

DBeaver JDBC集成图1-20250528.png

02 前置条件

安装好 DBeaver、IoTDB:

  • DBeaver 下载地址:https://dbeaver.io/download/

03 配置方式

(1) 下载驱动

选择对应版本的 jar 包,下载后缀 jar-with-dependencies.jar 的包:

  • 链接 1:https://repo1.maven.org/maven2/com/timecho/iotdb/iotdb-jdbc/2.0.3.3/iotdb-jdbc-2.0.3.3-jar-with-dependencies.jar

  • 链接 2:https://repo1.maven.org/maven2/com/timecho/iotdb/iotdb-jdbc/2.0.3.3/

DBeaver JDBC集成图2-20250528.png

(2) 配置驱动

步骤一:打开驱动管理器并新建驱动

1. 打开数据库工具导航到数据库 -> 驱动管理器。

2. 点击新建按钮,开始创建新的驱动配置。

DBeaver JDBC集成图3-20250528.jpg

DBeaver JDBC集成图4-20250528.jpg

步骤二:配置驱动信息

1. 配置【库】信息,在创建新驱动窗口中,点击添加文件按钮。

2. 选择下载好的 IoTDB JDBC 驱动文件(如 iotdb-jdbc-2.0.3-jar-with-dependencies.jar)。

3. 点击找到类按钮,自动识别驱动类。

4. 填写以下驱动设置信息:

  • 驱动名称:IoTDB

  • 类名:org.apache.iotdb.jdbc.IoTDBDriver

  • URL 模版:jdbc:iotdb://{host}:{port}/

  • 默认端口:6667

  • 默认用户:root

DBeaver JDBC集成图5-20250528.png

DBeaver JDBC集成图6-20250528.jpg

步骤三:创建并测试连接

1. 点击创建连接图标。

2. 在搜索框中输入 IoTDB,并选择。点击下一步,选择 URL 的连接方式。

3. 完善 JDBC URL(表模型需在 URL 中补充参数 ?sql_dialect=table),并填写 IoTDB 数据库的密码。

4. 点击测试连接按钮,如果连接成功,会提示已连接,并显示服务器版本和驱动版本。

DBeaver JDBC集成图7-20250528.jpg

DBeaver JDBC集成图8-20250528.jpg

注意:树模型创建连接时,可以选择主机的连接方式。

DBeaver JDBC集成图9-20250528.jpg

DBeaver JDBC集成图10-20250528.png

DBeaver JDBC集成图11-20250528.jpg

04 使用-表模型

(1) 数据库概览

在界面左侧的数据库导航中,可以查看数据库相关信息,包括数据库名称、表名称、列名称,列的类型以及列的备注。

DBeaver JDBC集成图12-20250528.jpg

(2) 表结构

在数据库列表中双击某张表,可在界面右侧展示的属性页签查看具体的表结构,包括表的基本属性和列的详细信息等。

DBeaver JDBC集成图13-20250528.jpg

在唯一键处可以查看表内的主键(time+tag 列)。

DBeaver JDBC集成图14-20250528.jpg

(3) 数据

在右侧界面切换到数据页签,即可查看该表存储的全部数据。

DBeaver JDBC集成图15-20250528.jpg

(4) 函数与数据类型

在数据库导航下的存储过程页签中,可以查看数据库支持的所有函数;

在数据类型页签中,可以查看数据库当前支持的所有数据类型。

DBeaver JDBC集成图16-20250528.jpg

DBeaver JDBC集成图17-20250528.jpg

05 使用-树模型

(1) 数据库概览

在界面左侧的数据库导航中,可以查看数据库相关信息,包括数据库名称、设备名称、测点名称以及测点类型。

DBeaver JDBC集成图18-20250528.jpg

(2) 设备及测点

在左侧数据库列表中,双击选中某个设备,界面右侧将展示该设备的基本属性信息,在列标签中可查看测点的详细信息。

DBeaver JDBC集成图19-20250528.jpg

(3) 数据

在右侧界面切换到数据页签,即可查看该测点存储的全部数据。

DBeaver JDBC集成图20-20250528.png

(4) 函数与数据类型

在数据库导航下的存储过程页签中,可以查看数据库支持的所有函数;

在数据类型页签中,可以查看数据库当前支持的所有数据类型。

DBeaver JDBC集成图21-20250528.png

DBeaver JDBC集成图22-20250528.png

更多内容推荐:

• 下载时序数据库 IoTDB 开源版

• 了解如何使用 DataEase-IoTDB 集成