IoTDB 入门教程 基础篇⑨——TsFile导入导出工具

文章目录

  • 一、前文
  • 二、准备
    • [2.1 准备导出服务器](#2.1 准备导出服务器)
    • [2.2 准备导入服务器](#2.2 准备导入服务器)
  • 三、导出
    • [3.1 导出命令](#3.1 导出命令)
    • [3.2 执行命令](#3.2 执行命令)
    • [3.3 tsfile文件](#3.3 tsfile文件)
  • 四、导入
    • [4.1 上传tsfile文件](#4.1 上传tsfile文件)
    • [4.2 导入命令](#4.2 导入命令)
    • [4.3 执行命令](#4.3 执行命令)
  • 五、查询
  • 六、参考

一、前文

IoTDB入门教程------导读
数据库备份与迁移是数据库运维中的核心任务,其重要性不言而喻。

确保备份过程既简单快捷又稳定可靠,对于保障数据安全与业务连续性至关重要。
鉴于IoTDB底层数据文件采用TsFile格式,IoTDB特别提供了TsFile导入导出工具。

这一工具极大地简化了数据库备份、迁移以及同步的流程,为用户带来了极大的便利。

二、准备

准备两台服务器,一台导出,一台导入。

2.1 准备导出服务器

  • 有7条数据
sql 复制代码
[root@VM-0-3-centos apache-iotdb-1.3.1-all-bin]# bash sbin/start-cli.sh
---------------------
Starting IoTDB Cli
---------------------
 _____       _________  ______   ______    
|_   _|     |  _   _  ||_   _ `.|_   _ \   
  | |   .--.|_/ | | \_|  | | `. \ | |_) |  
  | | / .'`\ \  | |      | |  | | |  __'.  
 _| |_| \__. | _| |_    _| |_.' /_| |__) | 
|_____|'.__.' |_____|  |______.'|_______/  version 1.3.1 (Build: 214695d)
                                           

Successfully login at 127.0.0.1:6667
sql 复制代码
IoTDB> select status from root.test.test
+-----------------------------+---------------------+
|                         Time|root.test.test.status|
+-----------------------------+---------------------+
|1970-01-01T08:00:00.001+08:00|                  4.0|
|1970-01-01T08:00:00.002+08:00|                  5.0|
|1970-01-01T08:00:00.003+08:00|                  6.0|
|2024-05-04T01:35:38.608+08:00|                  1.0|
|2024-05-04T01:35:45.166+08:00|                  2.0|
|2024-05-04T01:35:47.096+08:00|                  3.0|
|2024-05-04T01:35:56.606+08:00|                  3.0|
+-----------------------------+---------------------+
Total line number = 7
It costs 0.469s

2.2 准备导入服务器

  • 没有数据
sql 复制代码
[root@iZ2ze30dygwd6yh7gu6lskZ iot-db]# bash sbin/start-cli.sh 
---------------------
Starting IoTDB Cli
---------------------
 _____       _________  ______   ______    
|_   _|     |  _   _  ||_   _ `.|_   _ \   
  | |   .--.|_/ | | \_|  | | `. \ | |_) |  
  | | / .'`\ \  | |      | |  | | |  __'.  
 _| |_| \__. | _| |_    _| |_.' /_| |__) | 
|_____|'.__.' |_____|  |______.'|_______/  version 1.3.1 (Build: 214695d)
                                           

Successfully login at 127.0.0.1:6667
sql 复制代码
IoTDB> select status from root.test.test
+----+
|Time|
+----+
+----+
Empty set.
It costs 0.221s

三、导出

3.1 导出命令

复制代码
tools/export-tsfile.sh  -h <ip> -p <port> -u <username> -pw <password> -td <directory> [-f <export filename> -q <query command> -s <sql file>]
  • -h :IoTDB服务的主机地址。
  • -p :IoTDB服务的端口号。
  • -u :IoTDB服务的用户名。
  • -pw :IoTDB服务的密码。
  • -td :为导出的TsFile文件指定输出路径。
  • -f :为导出的TsFile文件的文件名,只需写文件名称,不能包含文件路径和后缀。如果sql文件或控制台输入时包含多个sql,会按照sql顺序生成多个TsFile文件。
    • 例如:文件中或命令行共有3个SQL,-f 为"dump",那么会在目标路径下生成 dump0.tsfile、dump1.tsfile、dump2.tsfile三个TsFile文件。
  • -q :在命令中直接指定想要执行的查询语句。
    • 例如: select * from root.** limit 100
  • -s :指定一个SQL文件,里面包含一条或多条SQL语句。如果一个SQL文件中包含多条SQL语句,SQL语句之间应该用换行符进行分割。每一条SQL语句对应一个输出的TsFile文件。
  • -t :指定session查询时的超时时间,单位为ms

3.2 执行命令

sql 复制代码
[root@VM-0-3-centos apache-iotdb-1.3.1-all-bin]# bash tools/export-tsfile.sh -h 127.0.0.1 -p 6667 -u root -pw root -td ./
------------------------------------------
Starting IoTDB Client Export Script
------------------------------------------
ExportTsFile> please input query: select status from root.test.test
select status from root.test.test
12378 [main] WARN  o.a.i.t.c.conf.TSFileDescriptor - not found iotdb-common.properties, use the default configs. 
12476 [main] INFO  o.a.iotdb.tsfile.write.TsFileWriter - start close file 
Export completely!cost: 115 ms.

3.3 tsfile文件

dump0.tsfile就是本次导出的tsfile文件。

四、导入

4.1 上传tsfile文件

将步骤三获得的dump0.tsfile上传到导入服务器中

4.2 导入命令

复制代码
load '<path/dir>' [sglevel=int][verify=true/false][onSuccess=delete/none]
  • path/dir:指定文件路径(绝对路径)。
  • sglevel:当 tsfile 对应的 database 不存在时,用户可以通过 sglevel 参数的值来制定 database 的级别,默认为iotdb-datanode.properties中设置的级别。
  • verify:表示是否对载入的 tsfile 中的所有时间序列进行元数据检查,默认为 true。
  • onSuccess:表示对于成功载入的tsfile的处置方式,默认为delete,即tsfile成功加载后将被删除,如果是none表明tsfile成功加载之后依然被保留在源文件夹。

4.3 执行命令

  • 先连接服务器
sql 复制代码
[root@iZ2ze30dygwd6yh7gu6lskZ iot-db]# bash sbin/start-cli.sh 
---------------------
Starting IoTDB Cli
---------------------
 _____       _________  ______   ______    
|_   _|     |  _   _  ||_   _ `.|_   _ \   
  | |   .--.|_/ | | \_|  | | `. \ | |_) |  
  | | / .'`\ \  | |      | |  | | |  __'.  
 _| |_| \__. | _| |_    _| |_.' /_| |__) | 
|_____|'.__.' |_____|  |______.'|_______/  version 1.3.1 (Build: 214695d)
                                           

Successfully login at 127.0.0.1:6667
  • 加载tsfile文件
sql 复制代码
IoTDB> load '/home/iot-db/dump0.tsfile'
Msg: The statement is executed successfully.

五、查询

  • 查询数据是否成功导入
sql 复制代码
IoTDB> select status from root.test.test
+-----------------------------+---------------------+
|                         Time|root.test.test.status|
+-----------------------------+---------------------+
|1970-01-01T08:00:00.001+08:00|                  4.0|
|1970-01-01T08:00:00.002+08:00|                  5.0|
|1970-01-01T08:00:00.003+08:00|                  6.0|
|2024-05-04T01:35:38.608+08:00|                  1.0|
|2024-05-04T01:35:45.166+08:00|                  2.0|
|2024-05-04T01:35:47.096+08:00|                  3.0|
|2024-05-04T01:35:56.606+08:00|                  3.0|
+-----------------------------+---------------------+
Total line number = 7
It costs 0.245s

六、参考

导入导出工具 | IoTDB Website

觉得好,就一键三连呗(点赞+收藏+关注)

相关推荐
TDengine (老段)3 小时前
TDengine 中的关联查询
大数据·javascript·网络·物联网·时序数据库·tdengine·iotdb
TDengine (老段)1 天前
TDengine 中的命名与边界
大数据·数据库·物联网·oracle·时序数据库·tdengine·iotdb
Apache IoTDB9 天前
IoTDB 常见问题 Q&A 第六期
linux·运维·服务器·数据库·iotdb
TDengine (老段)11 天前
TDengine 中的 show 命令
大数据·数据库·物联网·oracle·时序数据库·tdengine·iotdb
TDengine (老段)16 天前
TDengine 支持的所有运算符
大数据·数据库·sql·物联网·时序数据库·tdengine·iotdb
TDengine (老段)18 天前
TDengine 特色查询
android·大数据·数据库·物联网·时序数据库·tdengine·iotdb
TDengine (老段)1 个月前
TDengine 中的标签索引
大数据·数据库·物联网·搜索引擎·时序数据库·tdengine·iotdb
Apache IoTDB1 个月前
Apache IoTDB 树表双模型直播回顾(上)
apache·iotdb
Apache IoTDB1 个月前
明晚见:快速上手 IoTDB 树表双模型,功能/场景直播详解!
iotdb
ITPUB-微风1 个月前
Apache IoTDB: 物联网时序数据库的分布式核心技术与实际应用
物联网·apache·iotdb