[バックアップ|復元]を表示
これらのステートメントは、TiDB インスタンス上で実行された、キューに入れられ、実行中、および最近終了したすべてのタスクBACKUP
およびRESTORE
リストを表示します。
どちらのステートメントも実行するにはSUPER
権限が必要です。
BACKUP
タスクをクエリするにはSHOW BACKUPS
使用し、 RESTORE
タスクをクエリするにはSHOW RESTORES
使用します。
注記:
この機能はTiDB サーバーレスクラスターでは使用できません。
br
コマンドライン ツールで開始されたバックアップと復元は表示されません。
あらすじ
- ShowBRIEStmt
- ShowLikeOrWhere
ShowBRIEStmt ::=
"SHOW" ("BACKUPS" | "RESTORES") ShowLikeOrWhere?
ShowLikeOrWhere ::=
"LIKE" SimpleExpr
| "WHERE" Expression
例
1 つの接続で、次のステートメントを実行します。
BACKUP DATABASE `test` TO 's3://example-bucket/backup-01';
バックアップが完了する前に、新しい接続でSHOW BACKUPS
を実行します。
SHOW BACKUPS;
+--------------------------------+---------+----------+---------------------+---------------------+-------------+------------+---------+
| Destination | State | Progress | Queue_time | Execution_time | Finish_time | Connection | Message |
+--------------------------------+---------+----------+---------------------+---------------------+-------------+------------+---------+
| s3://example-bucket/backup-01/ | Backup | 98.38 | 2020-04-12 23:09:03 | 2020-04-12 23:09:25 | NULL | 4 | NULL |
+--------------------------------+---------+----------+---------------------+---------------------+-------------+------------+---------+
1 row in set (0.00 sec)
上記の結果の最初の行は次のように説明されます。
カラム | 説明 |
---|---|
Destination | 宛先 URL (秘密キーの漏洩を避けるためにすべてのパラメータが削除されています) |
State | タスクの状態 |
Progress | 現在の状態の推定進捗状況 (パーセンテージ) |
Queue_time | タスクがキューに入れられたとき |
Execution_time | タスクが開始されたとき。タスクをキューに入れる場合、値は0000-00-00 00:00:00 です。 |
Finish_time | タスクが終了したときのタイムスタンプ。タスクをキューに入れて実行する場合、値は0000-00-00 00:00:00 です。 |
Connection | このタスクを実行する接続 ID |
Message | 詳細を含むメッセージ |
考えられる状態は次のとおりです。
州 | 説明 |
---|---|
バックアップ | バックアップの作成 |
待って | 実行を待っています |
チェックサム | チェックサム操作の実行 |
接続 ID を使用して、 KILL TIDB QUERY
ステートメント経由でバックアップ/復元タスクをキャンセルできます。
KILL TIDB QUERY 4;
Query OK, 0 rows affected (0.00 sec)
フィルタリング
LIKE
句を使用して、宛先 URL をワイルドカード式と照合してタスクを除外します。
SHOW BACKUPS LIKE 's3://%';
列でフィルターするにはWHERE
句を使用します。
SHOW BACKUPS WHERE `Progress` < 25.0;
MySQLの互換性
このステートメントは、MySQL 構文に対する TiDB 拡張機能です。