当前位置：物联沃-IOTWORD物联网 > 技术教程 > IoTDB入门教程-基础篇⑨：TsFile导入导出工具详解
代码收藏家代码收藏家 技术教程

IoTDB入门教程-基础篇⑨：TsFile导入导出工具详解

文章目录

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

    • 一、前文

    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

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

    作者：小康师兄

    您可能感兴趣的内容:

    物联沃分享整理
    物联沃-IOTWORD物联网 » IoTDB入门教程-基础篇⑨：TsFile导入导出工具详解

    代码收藏家 普通

    分享到：

    相关推荐

    发表评论