阿里云 InfluxDB® 版退市倒计时:开源工具influxdb2tsfile助您迁出数据
产品发布-DB 产品教程-DB

阿里云 InfluxDB® 版退市倒计时:开源工具influxdb2tsfile助您迁出数据

天谋科技 ·
2026 年 10 月 23 日,阿里云 InfluxDB® 版将正式退市。如何把已经积累多年的 InfluxDB 历史数据,完整、可控地迁出来? 为此,Timecho 开源了 influxdb2tsfile,一个面向 InfluxDB 数据迁出的命令行工具,可将 InfluxDB 1.x / 2.x 中的时序数据转换为 Apache TsFile。

2026 年 10 月 23 日,阿里云 InfluxDB® 版将正式退市。

对于仍在使用相关实例的团队来说,数据迁移已成为迫在眉睫的任务。对很多用户来说,眼下最重要的问题未必是“下一套数据库选什么”,而是先解决一个更现实的问题:
如何把已经积累多年的 InfluxDB 历史数据,完整、可控地迁出来?
为此,Timecho 开源了 influxdb2tsfile,一个面向 InfluxDB 数据迁出的命令行工具,可将 InfluxDB 1.x / 2.x 中的时序数据转换为 Apache TsFile。
对于正在处理 InfluxDB 退市迁移的用户来说,这意味着可以先用一条命令把历史数据从原有实例中导出,再根据后续需求安排存储和使用。

真正的迁移难点,不只是一条"导出命令"

时序数据的迁移看起来像"把数据从 A 复制到 B",实则复杂。以下是迁移过程中可能遇到的几个关键难点:

1结构映射

如何确保 measurement、tag、field 等数据结构与目标数据库的表、列相对应,且字段类型不会丢失?

2大数据量处理

如何高效迁移大量数据,避免一次性查询导致的超时或内存溢出,以及迁移中断后的恢复问题?

3结果确认

如何确认迁移产物完整、行数一致,并保留可追溯的迁移记录?

4源实例不可用

若源实例已下线,只剩一份 line protocol 备份,是否还有离线迁移的解决方案?

5后续使用

迁出的数据如何以标准化文件长期保存,并方便后续重新加载和分析?

influxdb2tsfile:面向 influxDB 历史数据导出的开源工具

influxdb2tsfile 可以从 InfluxDB 1.x / 2.x 中读取时序数据,并转换为 Apache TsFile;整个在线迁移过程仅执行只读查询,不修改源库,可根据需要重复执行。
迁移后的 TsFile 可以独立保存,也可以继续加载到 Apache IoTDB、TimechoDB,或通过 TsFile SDK 进行后续处理。
◎ 项目地址:https://github.com/TimechoLab/influxdb2tsfile

 

◆ 兼容 InfluxDB 1.x 与 2.x

无论是旧版本的 InfluxDB 1.x 还是新版本的 InfluxDB 2.x,influxdb2tsfile 都能提供支持。1.x 可使用用户名/密码认证,2.x 可使用 API Token;两种版本共用同一套命令和参数。工具只以只读方式查询源库,不会修改源端数据。

◆ Schema 自动识别和映射

自动识别 InfluxDB 中的 measurement、tag、field 及其类型,并将其转换为 TsFile 表模型。迁移前可先运行 discover 看清结构,用 --dry-run 打印迁移计划,不读取、不写入任何数据。

InfluxDB
Apache TsFile
measurement
表(Table)
tag key / value
TAG 列
field key
FIELD 列
float / integer / boolean / string
DOUBLE / INT64 / BOOLEAN / STRING
timestamp
时间列(纳秒精度)
缺失 field
null(bitmap 标记)

◆ 大数据量可切片、并行、断点续跑

将迁移任务拆分为多个小单元,支持并行执行和断点续传。以"measurement × 时间切片"为一个工作单元,靠 --time-slice 与 --parallel 切片并行,内存占用更可控。相同参数重复执行是幂等的;--resume 只补做缺失、失败或失效的单元。

◆ 每批数据都有记录,迁完还能校验

迁移过程中生成 manifest.json,逐单元记录文件、行数、设备数、时间范围和列映射。结束后 --verify 回读比对;也可事后运行 inspect --manifest 独立校验。行数不一致时退出码为 1,便于脚本和 CI 自动判断。

◆ 实例下线了,也能离线转换

对于已经无法连接的实例,可以使用 lp2tsfile,把 influxd export / influx export 产生的 line protocol 文件或标准输入转换成 TsFile。在线迁移和离线迁移两条路,覆盖退市过程中的不同时间窗口。

使用前需要了解的几个边界

· 工具只迁移时序数据;用户、看板、连续查询、订阅、任务等元数据不在范围内。

· 默认只读取 InfluxDB 1.x 的默认保留策略,其他 RP 需通过 --rp 单独迁移。

· 多个 database / bucket 写入同一目录时,应使用 --table-prefix 区分表名。

· 同一字段存在多种类型时,可使用 --type-conflict text 转为字符串,或在源端先修复。

· --verify 校验的是回读行数与 manifest 是否一致,属于迁移完整性校验,不等同于逐值比对。

· 工具提供命令行,不提供 Web 界面;运行环境需要 JDK 17 及以上。

· 生成的 TsFile 是开放列式时序文件,可通过 TsFile SDK 直接读取,也可后续加载到 TimechoDB、Apache IoTDB 等系统中继续存储和分析。

迁移步骤

整个迁移过程可以概括为三个阶段:先探查、再迁移、最后校验。首次使用前只需完成工具下载和环境准备。
  1. 1. 下载并解压 下载并解压 influxdb2tsfile 的发行包,确保 Java 环境符合要求。

    2. 探查 schema 使用 discover 命令探查 InfluxDB 中的数据结构。

    3. 正式迁移 使用 migrate 命令执行迁移,可根据需要调整时间切片和并发数。

    4. 校验结果 使用 inspect 命令校验迁移结果,确认行数与 manifest 一致。

     

  2. 迁移命令 · Shell

    # 1. 下载并解压发行包(需要 JDK 17+)

    tar xzf influxdb2tsfile-1.0.0-bin.tar.gz

    cd influxdb2tsfile-1.0.0

    export JAVA_HOME=/path/to/jdk-17



    # 2. 探查 schema 与 TsFile 映射

    bin/influxdb2tsfile discover \

      --url http://127.0.0.1:8086 --database telegraf \

      --username admin --password secret --counts



    # 3. 正式迁移;执行前可额外加 --dry-run 查看计划

    bin/influxdb2tsfile migrate \

      --url http://127.0.0.1:8086 --database telegraf \

      --username admin --password secret \

      --time-slice 1d --parallel 4 \

      -o ./tsfile-out --resume --verify



    # 4. 回读产物,并与 manifest 校验

    bin/influxdb2tsfile inspect \

      ./tsfile-out --manifest ./tsfile-out/manifest.json

    InfluxDB 2.x 只需将用户名/密码替换为 --token <api-token>。对于仍在线、数据量较大的实例,建议先做 --dry-run,再根据查询压力和存储空间逐步调整时间切片与并发数。

完整跑通一次迁移:23,520 个数据点,0 个失败单元

在项目演示环境中,我们使用 InfluxDB 1.8.10 对完整迁移流程进行了功能验证。测试数据包括 4 个 measurement、23,520 个数据点,迁移采用 6 小时时间切片、4 路并行:

● 16 个工作单元全部完成,失败数为 0;

● 生成 16 个 TsFile 分片,合计约 210.35 KB;

● --verify 回读校验通过,4 张表的行数与 manifest 一致;

● 同时保留 manifest.json,可追溯每个分片的行数、设备数和时间范围。

这是一组小规模功能验证数据,不代表生产环境的性能上限,但它完整跑通了"探查—迁移—续跑—校验"的关键路径。

退市不是终点,数据应当继续可用

阿里云 InfluxDB® 版的退市,意味着托管服务即将结束,但已经积累的历史数据仍然需要被保存和使用。
influxdb2tsfile 希望解决的,就是其中最直接的一步:先把 InfluxDB 中的数据迁出来。
仍在线的实例可以直接迁移;已经下线的场景,也可以将已有的 Line Protocol 数据转换为 TsFile。迁出后,数据可以独立保存,也可以继续加载到 Apache IoTDB、TimechoDB 或通过 TsFile SDK 进行后续处理。
退市的是服务,不应该是数据。
如果你正在制定阿里云 InfluxDB 退市迁移方案,现在就可以从一次 discover 开始。

▸ 项目地址:https://github.com/TimechoLab/influxdb2tsfile

▸ 下载 v1.0.0:https://github.com/TimechoLab/influxdb2tsfile/releases/tag/v1.0.0

▸ 中文用户手册:https://github.com/TimechoLab/influxdb2tsfile/blob/main/docs/%E7%94%A8%E6%88%B7%E6%89%8B%E5%86%8C.md

▸ 开源协议:Apache License 2.0