首页
>
资源
>
产品发布

时序数据库 TimechoDB V2.0.9 发布 | 新增修改序列全名、Object 类型导入导出等功能

2026-05-20
  • #产品发布

TimechoDB V2.0.9 版本正式发布！

TimechoDB 是由 IoTDB 原厂团队开发的企业级时序数据库产品。V2.0.9 版本树模型支持修改序列全名功能、支持修改数据类型；表模型支持自定义 Time 列列名、支持修改数据类型、支持 Python 读写 Object 类型数据，新增 Object 类型导入导出功能、新增 tsfile-backup 脚本。同时，新增 schema 级/表级存储空间统计功能、新增 ODBC Driver，AINode 新增协变量分类推理能力等功能，并对数据库监控、性能、稳定性进行了全方位提升。

更多关于 V2.0.9 版本信息，欢迎联系我们获得企业版安装包！

主要发布内容

  • 查询模块：支持 schema 级/表级存储空间统计

  • 查询模块：支持通过 SQL 语句查看集群配置信息

  • 查询模块：表模型支持 UNION、INTERSECT、EXCEPT 集合操作

  • 查询模块：表模型支持 CTE 表达式

  • 查询模块：表模型新增 IF 标量函数、二进制函数、APPROX_PERCENTILE 聚合函数

  • 查询模块：支持 DEBUG SQL 查询调试能力

  • 查询模块：优化 Explain Analyze 结果集

  • 存储模块：树模型新增修改序列全名功能

  • 存储模块：树、表双模型支持修改数据类型功能

  • 存储模块：表模型支持自定义 Time 列列名

  • 存储模块：表模型支持 Python 接口读写 Object 类型数据

  • 存储模块：表模型支持 Object 类型导入导出功能

  • 流处理模块：树模型支持 pipe 鉴权

  • 流处理模块：树模型数据同步 pipe 语句中支持填写多个精确路径的 path

  • 流处理模块：表模型 PIPE 支持 Object 类型数据本地导出和远程传输

  • 系统模块：审计日志的参数支持热加载

  • 系统模块：支持统计写入、查询慢请求个数

  • 接口模块：支持 ODBC Driver

  • 接口模块：MQTT、REST 服务外置并新增系统表 Services 提供服务查询

  • AINode：支持配置开机自启

  • AINode：表模型协变量推理实现输入输出长度自适应适配

  • AINode：表模型支持时序数据分类推理

  • AINode：支持同一套模型代码搭配不同模型权重分别注册为模型

  • 脚本与工具：数据/元数据导入导出工具支持 SSL 协议

  • 脚本与工具：命令行工具新增访问历史查看功能

  • 脚本与工具：表模型新增 tsfile-backup 脚本

  • 其他：修复安全漏洞 CVE-2026-28564

  •  ...

本版本详细发布内容请查看天谋科技官网-发布历史页面：https://timecho.com/docs/zh/UserGuide/latest/IoTDB-Introduction/Release-history_timecho.html

功能详解：修改序列全名功能

功能介绍

系统支持通过 SQL 语句修改时间序列的全路径名称，操作执行后立即生效。序列重命名完成后，原序列名称正式作废，但其元数据信息仍保留存储。

  • 作废的原序列绑定的标签、属性及别名将自动迁移至新序列。

  • 作废的原序列不再支持写入、查询、删除等操作，且系统保留原序列名称，不可新建同名序列。

  • 修改新序列的编码压缩、序列类型、标签、属性、别名等配置时，不会同步修改到作废的原序列中。

  • 删除新序列的同时，会同步删除对应作废的原序列。

  • 序列支持反向重命名，可将已更名序列再次改回原有名称。

TimechoDB 2.0.9 版本发布图1-20260520.png

语法：

ALTER TIMESERIES <oldPath> RENAME TO <newPath>

示例：

ALTER TIMESERIES root.database.device.measurement RENAME TO root.db.dev.measure

功能详解：Object 类型支持导入导出（表模型）

功能介绍

Object 类型支持通过 Import-data 脚本对 Object 数据类型的 TsFile 文件进行数据导入。

Object 类型支持两种方式进行数据导出：

  • 支持通过创建 PIPE 的方式导出数据为 TsFile 格式。

  • 支持通过 tsfile-backup 脚本导出数据为 TsFile 格式。

运行命令

1. 数据导入

tools/import-data.sh -ft <format> [-sql_dialect<sql_dialect>] -db<database> -table<table>
         [-h <host>] [-p <port>] [-u <username>] [-pw <password>]  -s <source>
         [-o <object_file_paths>] -os <on_success> [-sd <success_dir>] -of <on_fail>
         [-fd <fail_dir>] [-tn <thread_num> ] [-tz <timezone>] [-tp <timestamp precision (ms/us/ns)>]

参数说明：

新增 TsFile 私有参数：-o

  • 全称：--object-file-paths

  • 含义：Object 文件存储路径

  • 默认模式：若不指定此参数，脚本将自动识别并导入位于 <TSFileName> / 同名子目录下的 Object 文件。

  • 绝对路径模式：显式指定 Object 文件的外部存储根目录，工具将基于此路径建立数据的关联索引。

示例：

示例一：基础导入（自动识别 TsFile 同名目录下的 Object 文件）

./import-data.sh -sql_dialect table -ft tsfile -s /data/import/sensor_v1.tsfile -db database1 -os none -of none

示例二：批量导入目录（指定并发线程数与成功后的处理动作）

./import-data.sh -sql_dialect table -ft tsfile -s /data/raw_data/ -tn 16 -os mv -sd /data/archive/

示例三：表模型关联导入（指定外部 Object 存储路径与目标数据库）

./import-data.sh -sql_dialect table -ft tsfile -s /data/import/ -db factory_db -o /mnt/object_storage/ -of mv -fd /data/error_log/

2.数据导出

方式一：

支持创建 PIPE 时，通过配置 sink 参数导出 Object 类型数据，支持如下两种模式：

  • Local 模式（本地导出）：将数据导出到 IoTDB 服务器所在的本地文件系统。

  • SCP 模式（远程传输）：通过 SSH/SCP 协议将数据发送到远程服务器。

示例：

示例一：本地导出

CREATE PIPE tsfile_export_local
WITH SOURCE (
    'source'='iotdb-source',
    'table-name'='test_table'
)
WITH PROCESSOR (
    'processor'='do-nothing-processor'
)
WITH SINK (
    'sink'='tsfile-local-sink',                               -- 必填，指定 Sink 类型
    'sink.local.target-path'='/data/backup/export_2024'-- 导出目标路径
    'sink.rate-limit-bytes-per-second'='10485760'      -- 限速 10MB/s
);

示例二：远程传输

CREATE PIPE tsfile_export_scp
WITH SOURCE (
    'source'='iotdb-source',
    'table-name'='test_table'
)
WITH PROCESSOR (
    'processor'='do-nothing-processor'
)
WITH SINK (
    'sink'='tsfile_remote_sink',
    'sink.file-mode'='scp',                          -- 指定为 SCP 模式
    'sink.scp.host'='192.168.1.100',                 -- 远程主机 IP
    'sink.scp.port'='22',                            -- SSH 端口
    'sink.scp.user'='backup_user',                   -- SSH 用户名
    'sink.scp.password'='ComplexPass123!',           -- SSH 密码
    'sink.scp.remote-path'='/remote/archive/',       -- 远程存放路径
    'sink.rate-limit-bytes-per-second'='10485760'    -- 限速 10MB/s
);

方式二：

支持通过 tsfile-backup 脚本将指定的数据文件导出为 TsFile 格式：

tools/tsfile-backup.sh [-sql_dialect <sql_dialect>] [-h <host>] [-p <port>]
         [-u <username>] [-pw <password>] [-db <db>] [-table <table>]
         [-s <start_time>] [-e <end_time>] [-t <target_directory>]
         [-th <target_host>] [-tu <target_host_user>] [-tp <target_host_port>]
         [--rate_limit] [--plugin_jar] [-help]

参数说明：

TimechoDB 2.0.9 版本发布图2-20260520.png

示例：

示例一：SCP 远程导出（将数据发送到另一台服务器）

./tsfile-backup.sh -sql_dialect table -db test_db -t /remote/archive/ -th 192.168.1.100 -tu backup_user -tpw ComplexPass123!

示例二：带限速的远程 Object 数据导出

./tsfile-backup.sh -sql_dialect table -t /mnt/backup/ -th 10.0.0.5 -tu iot_admin -tpw Admin@2026 --rate_limit 5242880

示例三：指定 Pipe jar 目录

./tsfile-backup.sh -sql_dialect table -db test  -table .* -tu luoluoyuyu -tpw  -t /tmp/backup --plugin_jar /local/lib/tsfile-remote-sink-2.0.8-SNAPSHOT-jar-with-dependencies.jar

更多内容推荐：

• 下载时序数据库 IoTDB 开源版

• 了解如何使用 时序数据库 IoTDB 企业版