时序数据库 IoTDB 集成 MyBatisPlus，告别复杂编码，简化时序数据 ORM 开发

代码简洁、高效开发，让你的时序数据应用构建更“丝滑”！

在物联网后台与服务模块的开发过程中，复杂编码与重复操作始终是开发团队难以绕开的挑战，不仅增加额外工作量，也抬高了系统的长期维护成本。

为有效缓解这一痛点，国产原生时序数据库 IoTDB 实现了与代码生成工具 MyBatisPlus 的深度集成，使开发者能够借助其强大的通用数据操作能力，以更简洁、更符合工程习惯的方式，高效管理时序数据。

• 开箱即用，告别繁琐：借助 MyBatisPlus 的通用 Mapper，无需编写基础 CRUD 代码，即可快速完成企业级增删改查操作。

• 高度兼容，无缝融入：集成设计充分尊重原有开发习惯，现有 MyBatisPlus 项目可平滑引入 IoTDB，时序数据与业务数据可用同一套架构统一处理。

• 条件构造，灵活查询：支持通过 Lambda 表达式构建复杂查询条件，让时序数据的筛选与统计像操作传统数据库一样直观方便。

欢迎查看用户手册（可点击下方阅读原文直接进入）了解更多内容！

01	功能简介
02	使用步骤
03	使用示例

01

功能简介

MyBatis-Plus Generator 是 MyBatis-Plus 框架内置的代码生成工具，基于数据库表结构自动生成标准化的实体类、Mapper 接口、Service 层及 Controller 层代码，集成 MyBatis-Plus 的通用 CRUD 方法（如 BaseMapper 内置增删改查）和条件构造器（QueryWrapper），支持 Lombok、Swagger 等扩展注解，通过简单配置即可快速构建符合企业级规范的持久层代码，大幅减少单表操作的重复开发工作，适用于快速搭建后台管理系统或标准化数据服务模块。

下文将介绍如何使用 Mybatis-Plus Generator 连接 IoTDB，并生成数据库表对应的实体类、Mapper 接口、Service 层及 Controller 层代码文件。

02

使用步骤

(1) 版本要求

• IoTDB：>= 2.0.2-SNAPSHOT

• mybatisPlus：>= 3.5.10

• iotdb-jdbc：>= 2.0.4-SNAPSHOT

(2) 操作流程

IoTDB 环境搭建

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

2. 创建数据库 database1 及表 table1 / table2，相关 SQL 语句可参考官网示例数据：https://www.timecho.com/docs/zh/UserGuide/latest-Table/Reference/Sample-Data.html

创建 Maven 项目

1. 创建 Maven 项目。

2. 在 pom 中增加如下依赖配置：

<properties>    <maven.compiler.source>17</maven.compiler.source>    <maven.compiler.target>17</maven.compiler.target>    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties>
<dependencies>    <dependency>        <groupId>com.baomidou</groupId>        <artifactId>mybatis-plus-spring-boot3-starter</artifactId>        <version>3.5.10</version>    </dependency>    <dependency>        <groupId>com.baomidou</groupId>        <artifactId>mybatis-plus-generator</artifactId>        <version>3.5.10</version>    </dependency>    <dependency>        <groupId>com.github.jeffreyning</groupId>        <artifactId>mybatisplus-plus</artifactId>        <version>1.7.5-RELEASE</version>    </dependency>    <dependency>        <groupId>org.apache.velocity</groupId>        <artifactId>velocity-engine-core</artifactId>        <version>2.0</version>    </dependency>    <dependency>        <groupId>org.apache.iotdb</groupId>        <artifactId>iotdb-jdbc</artifactId>        <version>2.0.4-SNAPSHOT</version>    </dependency>    <dependency>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter</artifactId>        <version>3.4.3</version>        <exclusions>            <exclusion>                <groupId>org.slf4j</groupId>                <artifactId>slf4j-api</artifactId>            </exclusion>            <exclusion>                <groupId>commons-logging</groupId>                <artifactId>commons-logging</artifactId>            </exclusion>        </exclusions>    </dependency>    <dependency>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-bo