益、基本概念介绍

1.1 Apache IoTDB

Apache IoTDB是一款专为工业物联网设计的时序数据库管理系统，集数据收集、存储、管理与分析于一体，满足海量数据存储、高速读取及复杂数据分析需求。其架构包括时序文件（TsFile）、数据库引擎和分析引擎三部分。TsFile是IoTDB自研的时序数据文件格式，支持高效压缩与查询。

1.2 SeaTunnel

SeaTunnel是一个分布式、高性能、易扩展的数据集成平台，用于海量数据的离线与实时同步和转化。它通过抽象API从多种数据源读取数据并写入多种目标数据源，依赖Connector连接器（由Source和Sink构成）实现数据的读取与写入。

二、IoTDB Connector功能特性

2.1 Source功能特性

• ‌批量读取‌：支持通过group by device等SQL语法批量读取设备数据。
• ‌字段投影‌：默认投影time或device列，支持自定义投影列。
• ‌数据类型映射‌：支持IoTDB数据类型到SeaTunnel数据类型的映射。
• ‌并行读取‌：利用时间戳划分范围实现并行读取。
• ‌状态恢复‌：根据split位置信息恢复读取状态。

2.2 Sink功能特性

• ‌元数据提取‌：支持从SeaTunnelRow中提取metadata、device等元数据。
• ‌批量提交‌：支持配置批量提交的条数与间隔。
• ‌异常重试‌：支持配置重试次数与等待间隔。

三、IoTDB Connector数据读取解析

3.1 数据类型映射

IoTDB数据类型需转换为SeaTunnel数据类型，包括BOOLEAN、INT32、INT64等类型的映射。

3.2 字段投影

读取IoTDB数据时，可自动映射Time字段，并支持部分数据映射到SeaTunnel。通过SQL提取列码，只提取所需列，并在SeaTunnel上指定列映射后的名字和类型。

3.3 批量读取device

支持align by device语法，批量读取相同结构的数据。

3.4 并行读取

通过time列范围划分，设置lower_bound、upper_bound和num_partitions参数实现并行读取。根据split ID向reader取模分配读取任务。

3.5 状态恢复

通过reader将未读取的split信息存入state，引擎定期做快照保留，恢复时从最后一次快照继续读取。

四、IoTDB Connector数据写入解析

4.1 数据类型映射

与读取相反，需将SeaTunnel数据类型转换为IoTDB类型，涉及TINYINT和SMALLINT的数据类型提升。

4.2 元数据动态注入

支持从每行数据中提取device、measurement、time等元数据，并配置storage group。

4.3 批量提交与异常重试

支持配置批量提交的条数与间隔，以及重试次数与等待间隔。

五、典型使用场景

5.1 从IoTDB导出数据

示例：从IoTDB并行读取数据并导出到Console，设置并行度、批次数和时间范围。

5.2 导入数据到IoTDB

示例：将外部数据库表数据导入IoTDB，配置批量写入频次、元数据提取等。

5.3 IoTDB之间同步数据

示例：在IoTDB之间同步数据，变更存储组和数据列指标名称。

通过以上解析与示例，读者可深入了解如何使用IoTDB Connector在SeaTunnel中实现数据同步，并应用于实际生产环境。