RESTORE

description

  1. 1. RESTORE
  2. 该语句用于将之前通过 BACKUP 命令备份的数据,恢复到指定数据库下。该命令为异步操作。提交成功后,需通过 SHOW RESTORE 命令查看进度。仅支持恢复 OLAP 类型的表。
  3. 语法:
  4. RESTORE SNAPSHOT [db_name].{snapshot_name}
  5. FROM `repository_name`
  6. ON (
  7. `table_name` [PARTITION (`p1`, ...)] [AS `tbl_alias`],
  8. ...
  9. )
  10. PROPERTIES ("key"="value", ...);
  11. 说明:
  12. 1. 同一数据库下只能有一个正在执行的 BACKUP RESTORE 任务。
  13. 2. ON 子句中标识需要恢复的表和分区。如果不指定分区,则默认恢复该表的所有分区。所指定的表和分区必须已存在于仓库备份中。
  14. 3. 可以通过 AS 语句将仓库中备份的表名恢复为新的表。但新表名不能已存在于数据库中。分区名称不能修改。
  15. 4. 可以将仓库中备份的表恢复替换数据库中已有的同名表,但须保证两张表的表结构完全一致。表结构包括:表名、列、分区、Rollup等等。
  16. 5. 可以指定恢复表的部分分区,系统会检查分区 Range 是否能够匹配。
  17. 6. PROPERTIES 目前支持以下属性:
  18. "backup_timestamp" = "2018-05-04-16-45-08":指定了恢复对应备份的哪个时间版本,必填。该信息可以通过 `SHOW SNAPSHOT ON repo;` 语句获得。
  19. "replication_num" = "3":指定恢复的表或分区的副本数。默认为3。若恢复已存在的表或分区,则副本数必须和已存在表或分区的副本数相同。同时,必须有足够的 host 容纳多个副本。
  20. "timeout" = "3600":任务超时时间,默认为一天。单位秒。
  21. "meta_version" = 40:使用指定的 meta_version 来读取之前备份的元数据。注意,该参数作为临时方案,仅用于恢复老版本 Doris 备份的数据。最新版本的备份数据中已经包含 meta version,无需再指定。

example

  1. 1. example_repo 中恢复备份 snapshot_1 中的表 backup_tbl 到数据库 example_db1,时间版本为 "2018-05-04-16-45-08"。恢复为 1 个副本:
  2. RESTORE SNAPSHOT example_db1.`snapshot_1`
  3. FROM `example_repo`
  4. ON ( `backup_tbl` )
  5. PROPERTIES
  6. (
  7. "backup_timestamp"="2018-05-04-16-45-08",
  8. "replication_num" = "1"
  9. );
  10. 2. example_repo 中恢复备份 snapshot_2 中的表 backup_tbl 的分区 p1,p2,以及表 backup_tbl2 到数据库 example_db1,并重命名为 new_tbl,时间版本为 "2018-05-04-17-11-01"。默认恢复为 3 个副本:
  11. RESTORE SNAPSHOT example_db1.`snapshot_2`
  12. FROM `example_repo`
  13. ON
  14. (
  15. `backup_tbl` PARTITION (`p1`, `p2`),
  16. `backup_tbl2` AS `new_tbl`
  17. )
  18. PROPERTIES
  19. (
  20. "backup_timestamp"="2018-05-04-17-11-01"
  21. );

keyword

  1. RESTORE