フラッシュバッククラスター

TiDB v6.4.0 では、 FLASHBACK CLUSTER TO TIMESTAMP構文が導入されました。これを使用して、クラスターを特定の時点に復元できます。タイムスタンプを指定する場合、datetime 値を設定するか、time 関数を使用できます。datetime の形式は '2016-10-08 16:45:26.999' のようで、最小時間単位はミリ秒です。ただし、ほとんどの場合、'2016-10-08 16:45:26' のように、時間単位として秒を使用してタイムスタンプを指定するだけで十分です。

v6.5.6、v7.1.3、v7.5.1、v7.6.0 以降、TiDB ではFLASHBACK CLUSTER TO TSO構文が導入されています。この構文を使用すると、 TSO使用してより正確なリカバリポイントを指定できるため、データリカバリの柔軟性が向上します。

警告

FLASHBACK CLUSTER TO [TIMESTAMP|TSO]構文はTiDB Cloudサーバーレスクラスターには適用されません。予期しない結果を回避するには、 TiDB Cloud Serverless クラスターでこのステートメントを実行しないでください。

警告

リカバリポイントを指定するときは、ターゲットタイムスタンプまたは TSO の有効性を確認し、PD によって現在割り当てられている最大 TSO を超える将来の時間を指定しないようにしてください (Grafana PD パネルのCurrent TSO参照)。そうしないと、同時処理の線形一貫性とトランザクション分離レベルに違反し、重大なデータ正確性の問題が発生する可能性があります。
FLASHBACK CLUSTER実行中、データクリーンアッププロセスではトランザクションの一貫性が保証されません。 FLASHBACK CLUSTERが完了した後、TiDB の履歴バージョン読み取り機能 ( ステイル読み取りやtidb_snapshotなど) を使用する場合は、指定した履歴タイムスタンプがFLASHBACK CLUSTER実行期間外であることを確認してください。 FLASHBACK によって完全に復元されていないデータを含む履歴バージョンを読み取ると、同時処理の線形一貫性とトランザクション分離レベルに違反し、データの正確性に関する重大な問題が発生する可能性があります。

警告

TiDB v7.1.0 でこの機能を使用すると、FLASHBACK 操作が完了した後も一部のリージョンが FLASHBACK プロセスのままになることがあります。v7.1.0 ではこの機能を使用しないことをお勧めします。詳細については、問題＃44292を参照してください。

この問題が発生した場合は、 TiDB スナップショットのバックアップと復元機能を使用してデータを復元できます。

注記：
FLASHBACK CLUSTER TO [TIMESTAMP|TSO]の動作原理は、特定の時点の古いデータを最新のタイムスタンプで書き込み、現在のデータを削除しないことです。したがって、この機能を使用する前に、古いデータと現在のデータに十分なstorageスペースがあることを確認する必要があります。

構文

FLASHBACK CLUSTER TO TIMESTAMP '2022-09-21 16:02:50';
FLASHBACK CLUSTER TO TSO 445494839813079041;

概要

FlashbackToTimestampStmt

FlashbackToTimestampStmt
         ::= 'FLASHBACK' 'CLUSTER' 'TO' ('TIMESTAMP' stringLit | 'TSO' LengthNum)

注記

FLASHBACKステートメントで指定する時間は、ガベージコレクション (GC) の有効期間内である必要があります。システム変数tidb_gc_life_time (デフォルト: 10m0s ) は、行の以前のバージョンの保持時間を定義します。ガベージコレクションが実行された現在のsafePoint 、次のクエリで取得できます。
```
SELECT * FROM mysql.tidb WHERE variable_name = 'tikv_gc_safe_point';
```

SUPER権限を持つユーザーのみがFLASHBACK CLUSTER SQL ステートメントを実行できます。
FLASHBACK CLUSTER 、 ALTER TABLE ATTRIBUTE 、 ALTER TABLE REPLICA 、 CREATE PLACEMENT POLICYなどの PD 関連情報を変更する DDL ステートメントのロールバックをサポートしていません。
FLASHBACK文で指定した時点では、完全に実行されていない DDL 文は存在できません。そのような DDL が存在する場合、TiDB はそれを拒否します。
FLASHBACK CLUSTER実行する前に、TiDB は関連するすべての接続を切断し、 FLASHBACK CLUSTERステートメントが完了するまでこれらのテーブルに対する読み取りおよび書き込み操作を禁止します。
FLASHBACK CLUSTERステートメントは実行後にキャンセルできません。TiDB は成功するまで再試行を続けます。
FLASHBACK CLUSTERの実行中にデータをバックアップする必要がある場合は、バックアップと復元使用して、 FLASHBACK CLUSTERの開始時刻よりも前のBackupTS指定できます。また、 FLASHBACK CLUSTERの実行中にログバックアップ有効にすると失敗します。そのため、 FLASHBACK CLUSTER完了した後にログバックアップを有効にするようにしてください。
FLASHBACK CLUSTERステートメントによってメタデータ (テーブル構造、データベース構造) がロールバックされた場合、関連する変更は TiCDC によって複製されません。したがって、タスクを手動で一時停止し、 FLASHBACK CLUSTERの完了を待ってから、上流と下流のスキーマ定義を手動で複製して、一貫性があることを確認する必要があります。その後、TiCDC の変更フィードを再作成する必要があります。

例

次の例は、クラスターを特定のタイムスタンプにフラッシュバックして、新しく挿入されたデータを復元する方法を示しています。

mysql> CREATE TABLE t(a INT);
Query OK, 0 rows affected (0.09 sec)

mysql> SELECT * FROM t;
Empty set (0.01 sec)

mysql> SELECT now();
+---------------------+
| now()               |
+---------------------+
| 2022-09-28 17:24:16 |
+---------------------+
1 row in set (0.02 sec)

mysql> INSERT INTO t VALUES (1);
Query OK, 1 row affected (0.02 sec)

mysql> SELECT * FROM t;
+------+
| a    |
+------+
|    1 |
+------+
1 row in set (0.01 sec)

mysql> FLASHBACK CLUSTER TO TIMESTAMP '2022-09-28 17:24:16';
Query OK, 0 rows affected (0.20 sec)

mysql> SELECT * FROM t;
Empty set (0.00 sec)

次の例は、クラスターを特定の TSO にフラッシュバックして、誤って削除されたデータを正確に復元する方法を示しています。

mysql> INSERT INTO t VALUES (1);
Query OK, 1 row affected (0.02 sec)

mysql> SELECT * FROM t;
+------+
| a    |
+------+
|    1 |
+------+
1 row in set (0.01 sec)


mysql> BEGIN;
Query OK, 0 rows affected (0.00 sec)

mysql> SELECT @@tidb_current_ts;  -- Get the current TSO
+--------------------+
| @@tidb_current_ts  |
+--------------------+
| 446113975683252225 |
+--------------------+
1 row in set (0.00 sec)

mysql> ROLLBACK;
Query OK, 0 rows affected (0.00 sec)


mysql> DELETE FROM t;
Query OK, 1 rows affected (0.00 sec)


mysql> FLASHBACK CLUSTER TO TSO 446113975683252225;
Query OK, 0 rows affected (0.20 sec)

mysql> SELECT * FROM t;
+------+
| a    |
+------+
|    1 |
+------+
1 row in set (0.01 sec)

FLASHBACKのステートメントで指定された時間に完全に実行されていない DDL ステートメントがある場合、 FLASHBACKステートメントは失敗します。

mysql> ALTER TABLE t ADD INDEX k(a);
Query OK, 0 rows affected (0.56 sec)

mysql> ADMIN SHOW DDL JOBS 1;
+--------+---------+-----------------------+------------------------+--------------+-----------+----------+-----------+---------------------+---------------------+---------------------+--------+
| JOB_ID | DB_NAME | TABLE_NAME            | JOB_TYPE               | SCHEMA_STATE | SCHEMA_ID | TABLE_ID | ROW_COUNT | CREATE_TIME         | START_TIME          | END_TIME            | STATE  |
+--------+---------+-----------------------+------------------------+--------------+-----------+----------+-----------+---------------------+---------------------+---------------------+--------+
|     84 | test    | t                     | add index /* ingest */ | public       |         2 |       82 |         0 | 2023-01-29 14:33:11 | 2023-01-29 14:33:11 | 2023-01-29 14:33:12 | synced |
+--------+---------+-----------------------+------------------------+--------------+-----------+----------+-----------+---------------------+---------------------+---------------------+--------+
1 rows in set (0.01 sec)

mysql> FLASHBACK CLUSTER TO TIMESTAMP '2023-01-29 14:33:12';
ERROR 1105 (HY000): Detected another DDL job at 2023-01-29 14:33:12 +0800 CST, can't do flashback

ログを通じて、 FLASHBACKの実行進行状況を取得できます。次に例を示します。

[2022/10/09 17:25:59.316 +08:00] [INFO] [cluster.go:463] ["flashback cluster stats"] ["complete regions"=9] ["total regions"=10] []

MySQL 互換性

このステートメントは、MySQL 構文に対する TiDB 拡張です。

フラッシュバッククラスター

構文

概要

注記

例

MySQL 互換性

このページは役に立ちましたか？