RESTORE

RESTORE（リストア）

説明

指定されたデータベース、テーブル、またはパーティションにデータをリストアします。現在、StarRocksはOLAPテーブルへのデータのリストアのみをサポートしています。詳細については、データのバックアップとリストアを参照してください。

RESTOREは非同期操作です。SHOW RESTOREを使用してRESTOREジョブのステータスを確認したり、CANCEL RESTOREを使用してRESTOREジョブをキャンセルしたりできます。

注意

• 管理者権限を持つユーザーのみがデータのリストアを実行できます。
• 各データベースにつき、実行中のBACKUPまたはRESTOREジョブは同時に1つだけ許可されます。そうでない場合、StarRocksはエラーを返します。

構文

RESTORE SNAPSHOT <db_name>.<snapshot_name>
FROM <repository_name>
[ ON ( <table_name> [ PARTITION ( <partition_name> [, ...] ) ]
    [ AS <table_alias>] [, ...] ) ]
PROPERTIES ("key"="value", ...)

パラメータ

パラメーター	説明
db_name	データをリストアするデータベースの名前。
snapshot_name	データスナップショットの名前。
repository_name	リポジトリ名。
ON	リストアするテーブルの名前。このパラメーターが指定されていない場合、データベース全体がリストアされます。
PARTITION	リストアするパーティションの名前。このパラメーターが指定されていない場合、テーブル全体がリストアされます。 SHOW PARTITIONS を使用してパーティションの名前を表示できます。
PROPERTIES	RESTORE操作のプロパティ。有効なキー: backup_timestamp: バックアップのタイムスタンプ。必須です。SHOW SNAPSHOTを使用してバックアップのタイムスタンプを表示できます。 replication_num: リストアするレプリカの数を指定します。デフォルト: 3。 meta_version: このパラメーターは、以前のバージョンのStarRocksでバックアップされたデータをリストアするための一時的な解決策としてのみ使用されます。最新バージョンのバックアップされたデータにはすでにmeta versionが含まれており、指定する必要はありません。 timeout: タスクのタイムアウト。単位: 秒。デフォルト: 86400。

例

例1: example_repoリポジトリのsnapshot_label1スナップショットのbackup_tblテーブルをデータベースexample_dbにリストアし、バックアップのタイムスタンプは2018-05-04-16-45-08です。レプリカは1つリストアします。

RESTORE SNAPSHOT example_db.snapshot_label1
FROM example_repo
ON ( backup_tbl )
PROPERTIES
(
    "backup_timestamp"="2018-05-04-16-45-08",
    "replication_num" = "1"
);

例2: example_repoからテーブルbackup_tblのパーティションp1とp2、snapshot_label2とテーブルbackup_tbl2をデータベースexample_dbにリストアし、backup_tbl2をnew_tblにリネームします。バックアップのタイムスタンプは2018-05-04-17-11-01です。デフォルトで3つのレプリカがリストアされます。

RESTORE SNAPSHOT example_db.snapshot_label2
FROM example_repo
ON(
    backup_tbl PARTITION (p1, p2),
    backup_tbl2 AS new_tbl
)
PROPERTIES
(
    "backup_timestamp"="2018-05-04-17-11-01"
);