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

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 语句修改时间序列的全路径名称,操作执行后立即生效。序列重命名完成后,原序列名称正式作废,但其元数据信息仍保留存储。

  • 作废的原序列绑定的标签、属性及别名将自动迁移至新序列。
  • 作废的原序列不再支持写入、查询、删除等操作,且系统保留原序列名称,不可新建同名序列。
  • 修改新序列的编码压缩、序列类型、标签、属性、别名等配置时,不会同步修改到作废的原序列中。
  • 删除新序列的同时,会同步删除对应作废的原序列。
  • 序列支持反向重命名,可将已更名序列再次改回原有名称。

9951ec4d850a9f1159a775827b14e895

语法:

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]

参数说明:

a24c6e10c52b98d3d3f15ae65a268516

示例:

示例一: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
posted @ 2026-05-21 11:09  ApacheIoTDB  阅读(5)  评论(0)    收藏  举报