· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 78 4.1.3 服务器建议配置 · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 说明， 请查看对应版本的Release Note。 2.2.1.1 系统变量 变量名 修改类型 描述 default_ �→ authentication �→ _plugin 新增 设置服务器对外 通告的默认身份 验证方式，默认 值为 mysql_native_ �→ password。 tidb_enable_ �→ auto_ �→ increment_ �→ in_ �→ generated ，配置此变量无实际效果 #23541。 • 从 TiDB 5.2 起，为了提高系统安全性，建议（但不要求）对来自客户端的连接进行传输层加密，TiDB 提 供 Auto TLS 功能在 TiDB 服务器端自动配置并开启加密。要使用 Auto TLS 功能，请在 TiDB 升级前将 TiDB 配 置文件中的security.auto-tls 设置为 true。 • 支持 caching_sha2_password

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 86 4.1.3 服务器建议配置 · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 。 defaults # 默认配置。 log global # 日志继承全局配置段的设置。 retries 2 # 向上游服务器尝试连接的最大次数， �→ 超过此值便认为后端服务器不可用。 timeout connect 2s # HAProxy 与后端服务器连接超时时间。 �→ 如果在同一个局域网内，可设置成较短的时间。 timeout client 30000s # 客户端与 HAProxy timeout server 30000s # 服务器端非活动连接的超时时间。 listen tidb-cluster # 配置 database 负载均衡。 bind 0.0.0.0:3390 # 浮动 IP 和 监听端口。 mode tcp # HAProxy 要使用第 4 层的传输层。 balance roundrobin # 连接数最少的服务器优先接收连接。`leastconn` �→

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 71 4.1.3 服务器建议配置 · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 到的统计信息。 默认值为 2，默 认作为实验特性 启用。 tidb_enable_ �→ enhanced_ �→ security 新增 表示所连接的 TiDB 服务器是否 启用了安全增强 模式（SEM），在 不重新启动 TiDB 服务器的情况下 不能改变该变 量。 tidb_enforce_ �→ mpp 新增 用于忽略优化器 代价估算，强制 使用 MPP 模式。 BOOL 类型，默认 值为 1，服务仅本地可访问。若需要使服务可被外部访问，可使 用 --host 参数指定监听网卡绑定外部可访问的 IP。 3.1.2 在单机上模拟部署生产环境集群 • 适用场景：希望用单台 Linux 服务器，体验 TiDB 最小的完整拓扑的集群，并模拟生产环境下的部署步骤。 本节介绍如何参照 TiUP 最小拓扑的一个 YAML 文件部署 TiDB 集群。 62 3.1.2.1 准备环境 准备一台部署主机，确保其软件满足需求：

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 92 4.1.3 服务器建议配置 · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 。 defaults # 默认配置。 log global # 日志继承全局配置段的设置。 retries 2 # 向上游服务器尝试连接的最大次数， �→ 超过此值便认为后端服务器不可用。 timeout connect 2s # HAProxy 与后端服务器连接超时时间。 �→ 如果在同一个局域网内，可设置成较短的时间。 timeout client 30000s # 客户端与 HAProxy timeout server 30000s # 服务器端非活动连接的超时时间。 listen tidb-cluster # 配置 database 负载均衡。 bind 0.0.0.0:3390 # 浮动 IP 和 监听端口。 mode tcp # HAProxy 要使用第 4 层的传输层。 balance roundrobin # 连接数最少的服务器优先接收连接。`leastconn` �→

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 445 5.1.3 服务器建议配置 · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 修复集群的 PD 节点被替换后一些 DDL 语句会卡住一段时间的问题 #33908 – 修复了查询 INFORMATION_SCHEMA.CLUSTER_SLOW_QUERY 表导致 TiDB 服务器 OOM 的问题，在 Grafana dashboard 中查看慢查询记录的时候可能会触发该问题 #33893 – 修复系统变量 max_allowed_packet 不生效的问题 #31422 。 defaults # 默认配置。 log global # 日志继承全局配置段的设置。 retries 2 # 向上游服务器尝试连接的最大次数， �→ 超过此值便认为后端服务器不可用。 timeout connect 2s # HAProxy 与后端服务器连接超时时间。 �→ 如果在同一个局域网内，可设置成较短的时间。 timeout client 30000s # 客户端与 HAProxy

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 451 5.1.3 服务器建议配置 · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · tidb_opt_use_invisible_indexes 从 v8.0.0 版本开始引入 · · · · · · · · · · · · · · · · · · · · · · · · · · 2624 14.6 服务器状态变量 · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · Lightning 导入数据时，因源文件存在不兼容的 SQL 语句而报 no database selected 的 问题 #51800 @lance6716 * 修复 TiDB Lightning 在服务器模式下可能会将敏感信息打印到日志中的问题 #36374 @kennytm * 修复 TiDB Lightning 导入数据时，kill PD Leader 会导致 invalid store ID

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 466 5.1.3 服务器建议配置 · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · tidb_opt_use_invisible_indexes 从 v8.0.0 版本开始引入 · · · · · · · · · · · · · · · · · · · · · · · · · · 2637 14.6 服务器状态变量 · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 配置文件 配置项 修改类型 描述 TiDB Lightning logical- �→ import �→ -batch �→ -size 新增 在逻辑导 入模式下， 用于设置 下游 TiDB 服务器上 执行的每 条 SQL 语 句的最大 值。默认 值为 "96KiB"， 单位可以 为 KB、KiB、 MB、MiB 等 存储单位。 Data Migration secret- �→ key-

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 462 5.1.3 服务器建议配置 · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 2473 14.6 服务器状态变量 · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 1，服务仅本地可访问。若需要使服务可被外部访问，可使 用 --host 参数指定监听网卡绑定外部可访问的 IP。 3.1.2 在单机上模拟部署生产环境集群 • 适用场景：希望用单台 Linux 服务器，体验 TiDB 最小的完整拓扑的集群，并模拟生产环境下的部署步骤。 本节介绍如何参照 TiUP 最小拓扑的一个 YAML 文件部署 TiDB 集群。 3.1.2.1 准备环境 开始部署 TiDB

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 466 5.1.3 服务器建议配置 · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 1，服务仅本地可访问。若需要使服务可被外部访问，可使 用 --host 参数指定监听网卡绑定外部可访问的 IP。 3.1.2 在单机上模拟部署生产环境集群 • 适用场景：希望用单台 Linux 服务器，体验 TiDB 最小的完整拓扑的集群，并模拟生产环境下的部署步骤。 本节介绍如何参照 TiUP 最小拓扑的一个 YAML 文件部署 TiDB 集群。 3.1.2.1 准备环境 开始部署 TiDB MySQL Session 部分，调整 DBMS connection read timeout interval (in seconds) 的设置。该字段控制 了 MySQL Workbench 在断开与服务器的连接之前查询可以执行的最长时间（以秒为单位）。 221 图 10: MySQL Workbench: adjust timeout option in SQL Editor settings

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 460 5.1.3 服务器建议配置 · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 1，服务仅本地可访问。若需要使服务可被外部访问，可使 用 --host 参数指定监听网卡绑定外部可访问的 IP。 3.1.2 在单机上模拟部署生产环境集群 • 适用场景：希望用单台 Linux 服务器，体验 TiDB 最小的完整拓扑的集群，并模拟生产环境下的部署步骤。 本节介绍如何参照 TiUP 最小拓扑的一个 YAML 文件部署 TiDB 集群。 3.1.2.1 准备环境 准备一台部署主机，确保其软件满足需求： MySQL Session 部分，调整 DBMS connection read timeout interval (in seconds) 的设置。该字段控制 了 MySQL Workbench 在断开与服务器的连接之前查询可以执行的最长时间（以秒为单位）。 224 图 10: MySQL Workbench: adjust timeout option in SQL Editor settings