时序数据库 IoTDB 集成 SpringBoot Starter，实现时序数据库“零配置”接入

面对工业物联网场景中高频产生的设备状态、环境指标等海量时序数据，如何在其产生后迅速完成采集、存储并服务于上层应用，是构建实时数据驱动型业务的核心挑战。

国产时序数据库 IoTDB 与快速开发框架 SpringBoot Starter 的深度集成，正是为了应对这一挑战，通过标准化的自动配置模式，将时序数据库的接入流程简化为引入单一依赖，使开发者能一键构建起高性能的数据管道。

• 简化配置，快速集成：借助 SpringBoot Starter，开发者仅需在配置文件中添加简单参数，即可自动完成数据源配置与模板 Bean 的初始化，大幅降低了项目集成的复杂度。

• 提升开发效率：集成后开发者可直接使用 Spring 风格的操作模板进行时序数据的读写，避免了繁琐的底层 JDBC 连接管理，让开发者能专注于业务逻辑，显著提升代码质量和开发效率。

• 无缝融入技术体系：作为 Spring 生态的自然延伸，该集成使得 IoTDB 能够与项目中已有的 Spring 组件协同工作，便于实现统一的资源管理、依赖注入和监控指标。

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

01 功能简介

SpringBoot Starter 是 SpringBoot 生态中的核心模块化组件，通过预定义依赖集合与自动化配置机制，简化第三方技术栈（如数据库、消息队列、安全框架）与 SpringBoot 应用的集成流程。每个 Starter 封装了特定功能所需的核心库、默认配置及条件化初始化逻辑，开发者仅需引入依赖即可实现“零配置”集成，遵循“约定优于配置”原则。

IoTDB 官方提供的 iotdb-spring-boot-starter 是专为 SpringBoot 生态设计的标准化集成组件，帮助开发者快速实现时序数据库的高效接入。开发者仅需引入依赖，即可使用 IoTDB 功能或模块，显著降低时序数据场景下的技术集成复杂度，适用于物联网、工业互联网等高频时序数据存储与分析场景。

02 使用步骤

(1) 版本要求

• IoTDB：>= 2.0.3

• iotdb-spring-boot-starter：>= 2.0.3

(2) 操作流程

1. 安装并启动 IoTDB，可参考官网快速上手页面：https://www.timecho.com/docs/zh/UserGuide/latest-Table/QuickStart/QuickStart_timecho.html

2. 在项目中添加 Maven 依赖：

<dependency>
    <groupId>org.apache.iotdb</groupId>
    <artifactId>iotdb-spring-boot-starter</artifactId>
    <version>2.0.3</version>
</dependency>

3. 在 application.properties 文件中进行自定义配置：

# IoTDB 服务地址（格式：IP:Port）
iotdb.session.url=127.0.0.1:6667
# IoTDB 用户名
iotdb.session.username=root
# IoTDB 用户密码
iotdb.session.password=root
# 指定连接的默认模式
iotdb.session.sql-dialect=table
# 指定连接的默认数据库
iotdb.session.database=wind 
# 连接池最大连接数
iotdb.session.max-size=10

4. 通过 @Autowired 使用目标 Bean，例如：

@Autowired
private ITableSessionPool ioTDBSessionPool;

publicvoidqueryTableSessionPool()throws IoTDBConnectionException, StatementExecutionException {
    ITableSession tableSession = ioTDBSessionPool.getSession();
    final SessionDataSet sessionDataSet = tableSession.executeQueryStatement("select * from table1 limit 10");
    while (sessionDataSet.hasNext()) {
        final RowRecord rowRecord = sessionDataSet.next();
        final List<Field> fields = rowRecord.getFields();
        for (Field field : fields) {
            System.out.print(field.getStringValue());
        }
        System.out.println();
    }
}

03 使用示例

详细的使用示例可参考 GitHub 源码：https://github.com/apache/iotdb-extras/tree/master/examples/iotdb-spring-boot-start