益、基本概念介绍
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中实现数据同步，并应用于实际生产环境。