tidb_read_stalenessシステム変数を使用して履歴データを読み取る

履歴データの読み取りをサポートするために、TiDB v5.4 では新しいシステム変数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前には@ではなく@@使用します。7 @@システム変数、 @ユーザー変数を意味します。
   • 履歴時間範囲（値tidb_read_staleness ）は、手順 3 と手順 4 に費やした合計時間に応じて設定する必要があります。そうしないと、クエリ結果には履歴データではなく最新のデータが表示されてしまいます。したがって、操作に費やした時間に応じてこの時間範囲を調整する必要があります。例えば、この例では設定時間範囲が 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)