restore

语法

restore(backupDir, dbPath, tableName, partition, [force=false], [outputTable], [parallel=false], [snapshot=true])

参数

backupDir 字符串，表示存放备份数据的目录。

1.30.20 新版功能: 参数 dbPath

dbPath 字符串，表示已备份的分布式数据库的路径。

tableName 字符串，表示已备份的表的名称。

partition 字符串，表示要恢复的分区的相对路径。分区路径可以包含通配符("%"和"?"), "?"表示单个字符，"%"表示0，1或多个字符。

若仅备份某个分区，输入分区的相对路径或者"%/"+”分区名称”。举例：要恢复"dfs://compoDB"下的分区”20170810/50_100”,输入"/compoDB/20170807/0_50"或者"%/20170807/0_50"。

请注意：若使用 1.30.16 ~ 1.30.18 版本 server，对表级分区数据进行备份和恢复时，该参数必须指定路径到物理索引（可通过函数 listTables 获取），例如分区 "/compoDB/20170807/0_50" 下表的物理索引为8，则 partition 需指定为 "/compoDB/20170807/0_50/8"。
若需要备份所有分区，直接输入"%"。

force 布尔值，表示是否强制恢复。默认值为false，表示只有元数据与备份数据元数据不一致的分区，才会恢复。

outputTable 分布式表句柄，该表的结构必须与要恢复的表结构一致。如果没有指定outputTable，恢复后的数据会存放到原表；如果指定了outputTable，恢复后的数据会存放到该表中，而原数据表保持不变。

1.30.20 新版功能: 参数 parallel 和 snapshot

parallel 布尔值，表示是否对一个数据表下不同分区进行并行恢复。默认值为 false。

snapshot 仅在参数 partition = "%" 时有效。表示进行非首次恢复时，备份中若存在被删除的表/分区，是否同步将数据库中对应的表/分区删除。若设置为 true，则数据库将同步删除备份中不存在的分区或表；否则不会删除。

详情

恢复指定分区的数据。返回一个字符串向量，包含恢复的分区的路径。该函数必须要用户登录后才能执行。

注意事项

恢复通过 SQL 元代码（即 backup 指定 sqlObj 参数）备份的文件时，不能指定 snapshot，否则会报错。
指定 outputTable 时，恢复通过 SQL 元代码备份的文件，系统会在 outputTable 中直接追加（append）备份数据；而恢复通过拷贝方式（即 backup 指定 dbPath 参数）备份的文件时，系统只覆盖 outputTable 中数据不一致的分区。若不指定 outputTable，则数据恢复至原表，恢复方式相同。
恢复时需要确保备份数据与待恢复数据库的引擎类型（engine）一致，且 partitionScheme（VALUE 除外）也保持一致。当采用 VALUE 分区时，须保证备份数据中的分区方案是待恢复数据库的分区方案的子集。例如：备份文件的分区方案是 database("dfs://xxx", VALUE, 2017.08.07..2017.08.11)，则待恢复数据库的 VALUE 分区范围必须不小于 2017.08.07..2017.08.11。

例子

创建一个组合分区的数据库dfs://compoDB：

$ n=1000000
$ ID=rand(100, n)
$ dates=2017.08.07..2017.08.11
$ date=rand(dates, n)
$ x=rand(10.0, n)
$ t=table(ID, date, x);

$ dbDate = database(, VALUE, 2017.08.07..2017.08.11)
$ dbID=database(, RANGE, 0 50 100);
$ db = database("dfs://compoDB", COMPO, [dbDate, dbID]);
$ pt = db.createPartitionedTable(t, `pt, `date`ID)
$ pt.append!(t);

备份表 pt 的所有数据：

$ backup("/home/DolphinDB/backup",<select * from loadTable("dfs://compoDB","pt")>,true);
10

例1. 恢复所有数据到原表。

$ restore("/home/DolphinDB/backup","dfs://compoDB","pt","%",true);
["dfs://compoDB/20170807/0_50/6F","dfs://compoDB/20170807/50_100/6F","dfs://compoDB/20170808/0_50/6F","dfs://compoDB/20170808/50_100/6F","dfs://compoDB/20170809/0_50/6F","dfs://compoDB/20170809/50_100/6F","dfs://compoDB/20170810/0_50/6F","dfs://compoDB/20170810/50_100/6F","dfs://compoDB/20170811/0_50/6F","dfs://compoDB/20170811/50_100/6F"]

例2. 恢复日期为2017.08.10的数据。

$ restore("/home/DolphinDB/backup","dfs://compoDB","pt","%20170810%",true)
["dfs://compoDB/20170810/0_50/6F","dfs://compoDB/20170810/50_100/6F"]

例3. 在数据库 dfs://compoDB 中创建一个与表 pt 结构相同的表 temp，把 pt 的数据恢复到表 temp。

$ temp=db.createPartitionedTable(t, `pt, `date`ID);

$ restore("/home/DolphinDB/backup","dfs://compoDB","pt","%",true,temp);
["dfs://compoDB/20170807/0_50/6F","dfs://compoDB/20170807/50_100/6F","dfs://compoDB/20170808/0_50/6F","dfs://compoDB/20170808/50_100/6F","dfs://compoDB/20170809/0_50/6F","dfs://compoDB/20170809/50_100/6F","dfs://compoDB/20170810/0_50/6F","dfs://compoDB/20170810/50_100/6F","dfs://compoDB/20170811/0_50/6F","dfs://compoDB/20170811/50_100/6F"]

$ select count(*) from temp;

count
1000000

相关函数：restoreDB, restoreTable, migrate, backup