diff --git a/dashboard/dashboard-faq.md b/dashboard/dashboard-faq.md index 5345e3030682..64db8b5d2c74 100644 --- a/dashboard/dashboard-faq.md +++ b/dashboard/dashboard-faq.md @@ -52,4 +52,4 @@ QPS 及 Latency 监控依赖于集群中已正常部署 Prometheus 监控实例 ### 概况页面中 Top SQL 语句、最近慢查询显示 `invalid connection` 错误 -此错误可能与 TiDB 的 `prepared-plan-cache` 功能有关。可以通过修改 [TiDB 配置文件](/tidb-configuration-file.md#prepared-plan-cache)来关闭 `prepared-plan-cache` 功能。 +可能的原因是你开启了 TiDB 的 `prepared-plan-cache` 功能。`prepared-plan-cache` 是实验性功能,在某些版本的 TiDB 中可能无法正常运行,开启后可能会导致 TiDB Dashboard(及其他应用)出现该问题。可以通过修改 [TiDB 配置文件](/tidb-configuration-file.md#prepared-plan-cache)来关闭 `prepared-plan-cache` 功能。 diff --git a/optimizer-hints.md b/optimizer-hints.md index 3ca517156cef..1732c8d9c66d 100644 --- a/optimizer-hints.md +++ b/optimizer-hints.md @@ -304,7 +304,7 @@ SELECT /*+ READ_CONSISTENT_REPLICA() */ * FROM t; `IGNORE_PLAN_CACHE()` 提示优化器在处理当前 `prepare` 语句时不使用 plan cache。 -该 Hint 用于临时对某类查询禁用 plan cache。 +该 Hint 用于在 [prepare-plan-cache](/tidb-configuration-file.md#prepared-plan-cache) 开启的场景下临时对某类查询禁用 plan cache。 以下示例强制该 `prepare` 语句不使用 plan cache: diff --git a/sql-prepare-plan-cache.md b/sql-prepare-plan-cache.md index c968f61d4bf6..39155f99813a 100644 --- a/sql-prepare-plan-cache.md +++ b/sql-prepare-plan-cache.md @@ -5,7 +5,7 @@ aliases: ['/docs-cn/dev/sql-prepare-plan-cache/'] # 执行计划缓存 -在当前的 TiDB 开发版本中,默认会缓存预处理语句(Prepared Statements)的执行计划。其中包括以下两种形式的预处理语句: +TiDB 支持对 `Prepare` / `Execute` 请求的执行计划缓存。其中包括以下两种形式的预处理语句: - 使用 `COM_STMT_PREPARE` 和 `COM_STMT_EXECUTE` 的协议功能; - 执行 `Prepare` / `Execute` SQL 语句查询; @@ -44,7 +44,7 @@ key 中任何一项变动(如切换数据库,重命名 `Prepare` 语句, - 考虑到不同 `Execute` 的参数会不同,执行计划缓存为了保证适配性会禁止一些和具体参数值密切相关的激进查询优化手段,导致对特定的一些参数值,查询计划可能不是最优。比如查询的过滤条件为 `where a > ? and a < ?`,第一次 `Execute` 时参数分别为 2 和 1,考虑到这两个参数下次执行时可能会是 1 和 2,优化器不会生成对当前参数最优的 `TableDual` 执行计划。 - 如果不考虑缓存失效和淘汰,一份执行计划缓存会对应各种不同的参数取值,理论上也会导致某些取值下执行计划非最优。比如查询过滤条件为 `where a < ?`,假如第一次执行 `Execute` 时用的参数值为 1,此时优化器生成最优的 `IndexScan` 执行计划放入缓存,在后续执行 `Exeucte` 时参数变为 10000,此时 `TableScan` 可能才是更优执行计划,但由于执行计划缓存,执行时还是会使用先前生成的 `IndexScan`。因此执行计划缓存更适用于查询较为简单(查询编译耗时占比较高)且执行计划较为固定的业务场景。 -执行计划缓存的最大语句条数默认为 100,可以通过修改 TiDB 配置文件中的 [`prepare-plan-cache`](/tidb-configuration-file.md#prepared-plan-cache) 项来配置此功能。 +目前执行计划缓存功能默认关闭,可以通过打开配置文件中 [`prepare-plan-cache` 项](/tidb-configuration-file.md#prepared-plan-cache)启用这项功能。 > **注意:** > diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md index 3eb492fea48c..f39f41ce074a 100644 --- a/tidb-configuration-file.md +++ b/tidb-configuration-file.md @@ -420,10 +420,14 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/ prepare 语句的 plan cache 设置。 +> **警告:** +> +> 当前该功能仍为实验特性,不建议在生产环境中使用。 + ### `enabled` + 开启 prepare 语句的 plan cache。 -+ 默认值:true ++ 默认值:false ### `capacity`