文章目录
- 一、前文
- 二、准备
-
- [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.469s2.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六、参考
觉得好，就一键三连呗（点赞+收藏+关注）