Skip to content

Commit

Permalink
modify customcontent for tidb cloud
Browse files Browse the repository at this point in the history
Signed-off-by: Yang Keao <yangkeao@chunibyo.icu>
  • Loading branch information
YangKeao committed Jul 31, 2024
1 parent a1e13a8 commit e6b3fc7
Showing 1 changed file with 22 additions and 0 deletions.
22 changes: 22 additions & 0 deletions system-variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -1932,6 +1932,8 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1;
>
> 该变量控制的功能为实验特性,不建议在生产环境中使用。该功能可能会在未事先通知的情况下发生变化或删除。如果发现 bug,请在 GitHub 上提 [issue](https://github.com/pingcap/tidb/issues) 反馈。

<CustomContent platform="tidb">

- 作用域:GLOBAL
- 是否持久化到集群:是
- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制:否
Expand All @@ -1946,6 +1948,26 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1;
- 对于使用 Lazy Cursor Fetch 的语句,执行信息将不会出现在 [statements summary](/statement-summary-tables.md) 和[慢查询日志](/identify-slow-queries.md)中。
- 对于暂不支持的场景,其行为与将变量设置为 `OFF` 时一致。

</CustomContent>

<CustomContent platform="tidb-cloud">

- 作用域:GLOBAL
- 是否持久化到集群:是
- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制:否
- 类型:布尔型
- 默认值:`OFF`
- 这个变量用于控制 [Cursor Fetch](/develop/dev-guide-connection-parameters.md#使用-streamingresult-流式获取执行结果) 功能的行为。
- 当开启 Cursor Fetch 且该变量设置为 `OFF` 时,TiDB 会在语句开始执行时将所有数据读取完成并保存至 TiDB 内存,在后续客户端读取的过程中会依据客户端指定的 `FetchSize` 返回给客户端。如果结果集过大,可能会触发落盘临时将结果写入硬盘。
- 当开启 Cursor Fetch 且该变量设置为 `ON` 时,TiDB 不会一次把所有数据读取到 TiDB 节点,而是会随着客户端的读取不断将数据读到 TiDB 节点。
- 该变量控制的功能存在以下限制:
- 不支持处于显式事务中的语句。
- 当前仅支持包含且仅包含 `TableReader``IndexReader``IndexLookUp``Projection``Selection` 算子的执行计划。
- 对于使用 Lazy Cursor Fetch 的语句,执行信息将不会出现在 [statements summary](/statement-summary-tables.md) 和[慢查询日志](https://docs.pingcap.com/zh/tidb/stable/identify-slow-queries)中。
- 对于暂不支持的场景,其行为与将变量设置为 `OFF` 时一致。

</CustomContent>

### `tidb_enable_non_prepared_plan_cache`

- 作用域:SESSION | GLOBAL
Expand Down

0 comments on commit e6b3fc7

Please sign in to comment.