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

一、前文

IoTDB入门教程——导读

数据库备份与迁移是数据库运维中的核心任务，其重要性不言而喻。
确保备份过程既简单快捷又稳定可靠，对于保障数据安全与业务连续性至关重要。

鉴于IoTDB底层数据文件采用TsFile格式，IoTDB特别提供了TsFile导入导出工具。
这一工具极大地简化了数据库备份、迁移以及同步的流程，为用户带来了极大的便利。

二、准备

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

2.1 准备导出服务器

• 有7条数据

[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

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 准备导入服务器

• 没有数据

[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

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 执行命令

[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 执行命令

• 先连接服务器

[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文件

IoTDB> load '/home/iot-db/dump0.tsfile'
Msg: The statement is executed successfully.

五、查询

• 查询数据是否成功导入

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

觉得好，就一键三连呗（点赞+收藏+关注）