表示 [バックアップ|復元]
これらのステートメントは、TiDB インスタンスで実行されたキューに入れられたタスク、実行中のタスク、最近完了したタスクBACKUPとRESTOREリストを表示します。
どちらのステートメントも、実行にはSUPER権限が必要です。
BACKUPタスクを照会するにはSHOW BACKUPS使用し、 RESTOREタスクを照会するにはSHOW RESTORES使用します。
注記:
この機能は、クラスターTiDB CloudスターターおよびTiDB Cloudエッセンシャルでは利用できません。
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 拡張です。