66 lines
2.2 KiB
Markdown
66 lines
2.2 KiB
Markdown
---
|
|
{
|
|
"title": "BACKUP",
|
|
"language": "zh-CN"
|
|
}
|
|
---
|
|
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one
|
|
or more contributor license agreements. See the NOTICE file
|
|
distributed with this work for additional information
|
|
regarding copyright ownership. The ASF licenses this file
|
|
to you under the Apache License, Version 2.0 (the
|
|
"License"); you may not use this file except in compliance
|
|
with the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing,
|
|
software distributed under the License is distributed on an
|
|
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
KIND, either express or implied. See the License for the
|
|
specific language governing permissions and limitations
|
|
under the License.
|
|
-->
|
|
|
|
# BACKUP
|
|
## description
|
|
该语句用于备份指定数据库下的数据。该命令为异步操作。提交成功后，需通过 SHOW BACKUP 命令查看进度。仅支持备份 OLAP 类型的表。
|
|
语法：
|
|
BACKUP SNAPSHOT [db_name].{snapshot_name}
|
|
TO `repository_name`
|
|
ON (
|
|
`table_name` [PARTITION (`p1`, ...)],
|
|
...
|
|
)
|
|
PROPERTIES ("key"="value", ...);
|
|
|
|
说明：
|
|
1. 同一数据库下只能有一个正在执行的 BACKUP 或 RESTORE 任务。
|
|
2. ON 子句中标识需要备份的表和分区。如果不指定分区，则默认备份该表的所有分区。
|
|
3. PROPERTIES 目前支持以下属性：
|
|
"type" = "full"：表示这是一次全量更新（默认）。
|
|
"timeout" = "3600"：任务超时时间，默认为一天。单位秒。
|
|
|
|
## example
|
|
|
|
1. 全量备份 example_db 下的表 example_tbl 到仓库 example_repo 中：
|
|
BACKUP SNAPSHOT example_db.snapshot_label1
|
|
TO example_repo
|
|
ON (example_tbl)
|
|
PROPERTIES ("type" = "full");
|
|
|
|
2. 全量备份 example_db 下，表 example_tbl 的 p1, p2 分区，以及表 example_tbl2 到仓库 example_repo 中：
|
|
BACKUP SNAPSHOT example_db.snapshot_label2
|
|
TO example_repo
|
|
ON
|
|
(
|
|
example_tbl PARTITION (p1,p2),
|
|
example_tbl2
|
|
);
|
|
|
|
## keyword
|
|
BACKUP
|
|
|