From ad28bfb858cf47514eca0ab2797cb5a590cea169 Mon Sep 17 00:00:00 2001 From: Ti Chi Robot Date: Fri, 30 Jul 2021 19:33:05 +0800 Subject: [PATCH] update stale read doc for ga (#6715) (#6753) --- as-of-timestamp.md | 6 ++---- experimental-features.md | 1 - stale-read.md | 4 ++-- 3 files changed, 4 insertions(+), 7 deletions(-) diff --git a/as-of-timestamp.md b/as-of-timestamp.md index 9feea7f6bce9..146788943164 100644 --- a/as-of-timestamp.md +++ b/as-of-timestamp.md @@ -9,8 +9,6 @@ summary: 了解如何使用 AS OF TIMESTAMP 语法读取历史数据。 > **警告：** > -> Stale Read 目前为实验特性。不推荐在生产环境下使用该特性。 -> > 目前 Stale Read 特性无法和 TiFlash 一起使用。如果你的查询中带有 `AS OF TIMESTAMP` 并且 TiDB 可能从 TiFlash 副本读取数据，你可能会遇到 `ERROR 1105 (HY000): stale requests require tikv backend` 报错信息。 > > 要解决该问题，你需要为使用 Stale Read 特性的查询禁用 TiFlash 副本。要禁用 TiFlash 副本，你可以使用以下任一方法： @@ -47,9 +45,9 @@ TiDB 支持通过标准 SQL 接口，即通过 `AS OF TIMESTAMP` SQL 语法的 > > 除了指定时间戳，`AS OF TIMESTAMP` 语法最常用使用的方式是读几秒前的数据。如果采用这种方式，推荐读 5 秒以上的历史数据。 > -> 使用 Stale Read 时需要为 TiDB 和 PD 节点部署 NTP 服务，防止 TiDB 指定的时间戳超过当前最新的 TSO 分配进度（如几秒后的时间戳），或者落后于 GC safe point 的时间戳。当指定的时间戳超过服务范围，TiDB 会产生报错或者等待事务提交等行为。 +> 使用 Stale Read 时需要为 TiDB 和 PD 节点部署 NTP 服务，防止 TiDB 指定的时间戳超过当前最新的 TSO 分配进度（如几秒后的时间戳），或者落后于 GC safe point 的时间戳。当指定的时间戳超过服务范围，TiDB 会返回错误。 > -> `Prepare` 语句与 `AS OF TIMESTAMP` 语法的兼容支持尚不完善，不推荐同时使用。 +> v5.1.1 之前的版本，`Prepare` 语句与 `AS OF TIMESTAMP` 语法的兼容支持尚不完善，不推荐同时使用。自 v5.1.1 起，`Prepare` 语句已兼容 `AS OF TIMESTAMP` 语法，两者可以同时使用。 ## 示例 diff --git a/experimental-features.md b/experimental-features.md index 90bf50bdae15..4390c712a22b 100644 --- a/experimental-features.md +++ b/experimental-features.md @@ -29,7 +29,6 @@ summary: 了解 TiDB 各版本的实验特性。 + [自定义变量](/user-defined-variables.md#用户自定义变量)。 + [JSON 数据类型](/data-type-json.md) 及 [JSON 函数](/functions-and-operators/json-functions.md)。 + [View](/information-schema/information-schema-views.md)。 -+ [Stale Read](/stale-read.md)。 ## 配置管理 diff --git a/stale-read.md b/stale-read.md index fa22b65f175d..b90861b56d47 100644 --- a/stale-read.md +++ b/stale-read.md @@ -7,9 +7,9 @@ summary: 介绍 Stale Read 功能和使用场景。 本文档介绍 Stale Read 的使用场景。Stale Read 是一种读取历史数据版本的机制，读取 TiDB 中存储的历史数据版本。通过 Stale Read 功能，你能从指定时间点或时间范围内读取对应的历史数据，从而避免数据同步带来延迟。当使用 Stale Read 时，TiDB 默认会随机选择一个副本来读取数据，因此能利用所有副本。如果你的应用程序不能容忍读到非实时的数据，请勿使用 Stale Read，否则读到的数据可能不是最新成功写入的数据。 -> **警告：** +> **注意：** > -> Stale Read 目前为实验特性。不推荐在生产环境下使用该特性。 +> Stale Read 自 v5.1.1 起已成为正式功能 (General Availability)。 ## 场景描述