tidb_read_stalenessシステム変数を使用した履歴データの読み取り

履歴データの読み取りをサポートするために、v5.4 では、TiDB に新しいシステム変数tidb_read_stalenessが導入されています。このドキュメントでは、詳細な操作手順を含め、このシステム変数を使用して履歴データを読み取る方法について説明します。

機能の説明

tidb_read_stalenessシステム変数は、TiDB が現在のセッションで読み取ることができる履歴データの時間範囲を設定するために使用されます。この変数のデータ型は int 型で、スコープはSESSIONです。値を設定した後、TiDB はこの変数で許可される範囲からできるだけ新しいタイムスタンプを選択し、後続のすべての読み取り操作はこのタイムスタンプに対して実行されます。たとえば、この変数の値が-5に設定されている場合、TiKV に対応する履歴バージョンのデータがあるという条件で、TiDB は 5 秒の時間範囲内で可能な限り新しいタイムスタンプを選択します。

tidb_read_stalenessを有効にした後も、次の操作を実行できます。

• 現在のセッションでデータを挿入、変更、削除するか、DML 操作を実行します。これらのステートメントはtidb_read_stalenessの影響を受けません。
• 現在のセッションで対話型トランザクションを開始します。このトランザクション内のクエリは引き続き最新のデータを読み取ります。

過去のデータを読み取った後、次の 2 つの方法で最新のデータを読み取ることができます。

• 新しいセッションを開始します。
• SETステートメントを使用して、変数tidb_read_stalenessの値を""に設定します。

注記：

レイテンシーを短縮し、 ステイル読み取りデータの適時性を向上させるために、TiKV advance-ts-interval構成項目を変更できます。詳細はステイル読み取りレイテンシーを削減する参照してください。

使用例

このセクションでは、 tidb_read_staleness使用方法を例とともに説明します。

1. テーブルを作成し、そのテーブルに数行のデータを挿入します。

   create table t (c int);
   

   Query OK, 0 rows affected (0.01 sec)
   

   insert into t values (1), (2), (3);
   

   Query OK, 3 rows affected (0.00 sec)
   

2. 表内のデータを確認してください。

   select * from t;
   

   +------+
   | c    |
   +------+
   |    1 |
   |    2 |
   |    3 |
   +------+
   3 rows in set (0.00 sec)
   

3. データを連続して更新します。

   update t set c=22 where c=2;
   

   Query OK, 1 row affected (0.00 sec)
   

4. データが更新されたことを確認します。

   select * from t;
   

   +------+
   | c    |
   +------+
   |    1 |
   |   22 |
   |    3 |
   +------+
   3 rows in set (0.00 sec)
   

5. tidb_read_stalenessシステム変数を設定します。

   この変数のスコープはSESSIONです。値を設定した後、TiDB は値で設定された時間より前に最新バージョンのデータを読み取ります。

   次の設定は、TiDB が 5 秒前から現在までの時間範囲内で可能な限り新しいタイムスタンプを選択し、それを履歴データを読み取るためのタイムスタンプとして使用することを示します。

   set @@tidb_read_staleness="-5";
   

   Query OK, 0 rows affected (0.00 sec)
   

   注記：

   • tidb_read_stalenessの前に@の代わりに@@使用します。 @@システム変数を意味し、 @ユーザー変数を意味します。
   • 手順 3 と手順 4 で費やした合計時間に従って、履歴時間範囲 (値tidb_read_staleness ) を設定する必要があります。そうしないと、履歴データではなく、最新のデータがクエリ結果に表示されます。したがって、操作に費やした時間に応じて、この時間範囲を調整する必要があります。たとえば、この例では、設定時間範囲が 5 秒であるため、手順 3 と手順 4 を 5 秒以内に完了する必要があります。

   ここで読み込まれるデータは更新前のデータ、つまり履歴データです。

   select * from t;
   

   +------+
   | c    |
   +------+
   |    1 |
   |    2 |
   |    3 |
   +------+
   3 rows in set (0.00 sec)
   

6. 次のようにこの変数の設定を解除すると、TiDB は最新のデータを読み取ることができます。

   set @@tidb_read_staleness="";
   

   Query OK, 0 rows affected (0.00 sec)
   

   select * from t;
   

   +------+
   | c    |
   +------+
   |    1 |
   |   22 |
   |    3 |
   +------+
   3 rows in set (0.00 sec)