通过系统变量 `tidb_read_staleness` 读取历史数据

系统变量 tidb_read_staleness 用于设置当前会话允许读取的历史数据范围，其数据类型为 int，作用域为 SESSION。设置该变量后，TiDB 会从参数允许的范围内选出一个尽可能新的时间戳，并影响后继的所有读操作。比如，如果该变量的值设置为 -5，TiDB 会在 5 秒时间范围内，保证 TiKV 拥有对应历史版本数据的情况下，选择尽可能新的一个时间戳。

开启 tidb_read_staleness 后，你仍可以进行以下操作：

在当前会话中插入、修改、删除数据或进行 DML 操作。这些语句不会受到 tidb_read_staleness 的影响。
在当前会话开启交互式事务。在该事务内的查询依旧是读取最新版本的数据。

完成对历史版本数据的读取后，你可以通过以下两种方式来读取最新版本的数据。

结束当前会话。
使用 SET 语句，把 tidb_read_staleness 变量的值设为 ""。

示例

本节通过具体操作示例介绍系统变量 tidb_read_staleness的使用方法。

 Query OK, 0 rows affected (0.01 sec)

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

 Query OK, 3 rows affected (0.00 sec)

查看表中的数据：

 select * from t;

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

更新某一行数据：
```
 Query OK, 1 row affected (0.00 sec)
```

确认数据已经被更新：

 select * from t;

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

设置一个特殊的环境变量 tidb_read_staleness。

以下设置表示 TiDB 会从 5 秒前至现在的时间范围内选择一个尽可能新的时间戳，将其用作为历史数据读取的时间戳：
```
 set @@tidb_read_staleness="-5";
```
```
 Query OK, 0 rows affected (0.00 sec)
```
这里读取到的内容即为更新前的数据，也就是历史版本的数据：
```
 | c    |
 +------+
 |    1 |
 |    2 |
 |    3 |
 +------+
 3 rows in set (0.00 sec)
```

 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)

使用系统变量 tidb_read_staleness 读取历史数据

通过系统变量 tidb_read_staleness 读取历史数据

示例

通过系统变量 `tidb_read_staleness` 读取历史数据