Bit-value Literals Boolean Literals Date 和 Time 字面值 十六进制的字面值 NULL Values 数值字面值 字符串字面值 TiDB 用户文档 高级功能 历史数据回溯 垃圾回收 (GC) TiDB Ansible 常见运维操作 TiDB 运维文档 Try TiDB - 3 - 本文档使用 书栈(BookStack.CN) 构建 TiDB 运维文档 软硬件环境需求 实用工具语句 TiDB SQL 语法图 JSON 支持 Connectors 和 API TiDB 事务隔离级别 错误码与故障诊断 与 MySQL 兼容性对比 TiDB 内存控制 高级功能 历史数据回溯 垃圾回收 (GC) TiDB 运维文档 软硬件环境需求 部署集群 Ansible 部署方案（强烈推荐） 离线 Ansible 部署方案 Docker 部署方案 Docker Compose 部署方案 可以包括 . 作为小数点分隔，数字前可以有 - 或者 + 来表示正数或者负数。 精确数值字面值可以表示为如下格式： 1, .2, 3.4, -5, -6.78, +9.10 . 科学记数法也是被允许的，表示为如下格式： 1.2E3, 1.2E-3, -1.2E3, -1.2E-3 。 更多细节。 NULL 代表数据为空，它是大小写不敏感的，与 \N (大小写敏感) 同义。 需要注意的是

提供了更加强大和精确的闪回功能 FLASHBACK CLUSTER，不仅支持回溯到过去指定的时间点， 还可以通过 FLASHBACK CLUSTER TO TSO 精确地指定要恢复的TSO 时间戳，实现更加灵活的数据恢复。例 如，与 TiCDC 结合使用时，该功能允许下游 TiDB 集群在暂停数据同步、开启预上线读写测试后，快速且 优雅地回溯到暂停同步时的 TSO 时间戳，并继续通过 TiCDC 同步数据，从而简化了预上线验证流程和数 +----+--------------+---------+ 4.8.1.2.1 开启事务 要显式地开启一个新事务，既可以使用 BEGIN 语句，也可以使用 START TRANSACTION 语句，两者效果相同。语 法： BEGIN; START TRANSACTION; TiDB 的默认事务模式是悲观事务，你也可以明确指定开启乐观事务： BEGIN OPTIMISTIC; 开启悲观事务： BEGIN PESSIMISTIC; 都是开源项目，你可以享受到零供应商锁定的好处。 4.13.3.3 部署架构 将 ProxySQL 与 TiDB 集成的最直接方式是在应用层和 TiDB 之间添加 ProxySQL 作为独立中介。但是，这种方式无 法保证可扩展性和容错性，而且可能因为网络跳转而增加延迟。为避免这些问题，一种替代部署架构是将 ProxySQL 作为附属容器部署，如下图所示： 444 图 31: proxysql-client-side-tidb-cloud

Performance Overview 面板，提供系统级别的总体性能诊断入口。 Performance Overview 是 TiDB 监控 Grafana 可视化组件中的一个新增面板，基于数据库时间分析法和颜色 优化法，按照自上而下的性能分析方法论对 TiDB 的性能指标做了重新梳理，为 TiDB 用户提供一个系统 级别的总体性能诊断入口。通过 Performance Overview 面板，你可以直观地看到整个系统的性能瓶颈在哪 MySQL 协议兼容，因此，需要初始化一个 MySQL 协议的数据源 db, err := sql.Open("mysql", dsn)，以此连接到 TiDB。并在其后，调用 dao.go 中的一系列方 法，用来管理数据对象，进行增删改查等操作。 package main import ( "database/sql" "fmt" _ "github.com/go-sql-driver/mysql" +----+--------------+---------+ 4.8.1.2.1 开启事务 要显式地开启一个新事务，既可以使用 BEGIN 语句，也可以使用 START TRANSACTION 语句，两者效果相同。语 法： BEGIN; START TRANSACTION; TiDB 的默认事务模式是悲观事务，你也可以明确指定开启乐观事务： BEGIN OPTIMISTIC; 开启悲观事务： BEGIN PESSIMISTIC;

MARKER 选项， 支持标 记日志 信息。 44 变量名 修改类型 描述 div_ �→ precision �→ _ �→ increment �→ 新增 用于指 定使用 运算符 / 执行除 法操作 时，结 果增加 的小数 位数。 该功能 与 MySQL 保持一 致。 tidb_dml_ �→ type 新增 设置 DML 语 句的执 行方式， 可选值 为 " �→ standard �→ 没有监听对应端口的问题 #51473 @hawkingrei – 修复在 determinate 模式下 (tidb_opt_objective='determinate')，如果查询不包含谓词，可能无 法加载统计信息的问题 #48257 @time-and-fate – 修复 init-stats 流程可能导致 TiDB panic 以及 load stats 流程直接退出的问题 #51581 @hawkingrei +----+--------------+---------+ 4.8.1.2.1 开启事务 要显式地开启一个新事务，既可以使用 BEGIN 语句，也可以使用 START TRANSACTION 语句，两者效果相同。语 法： BEGIN; START TRANSACTION; TiDB 的默认事务模式是悲观事务，你也可以明确指定开启乐观事务： BEGIN OPTIMISTIC; 开启悲观事务： BEGIN PESSIMISTIC;

+----+--------------+---------+ 4.8.1.2.1 开启事务 要显式地开启一个新事务，既可以使用 BEGIN 语句，也可以使用 START TRANSACTION 语句，两者效果相同。语 法： BEGIN; START TRANSACTION; TiDB 的默认事务模式是悲观事务，你也可以明确指定开启乐观事务： BEGIN OPTIMISTIC; 开启悲观事务： BEGIN PESSIMISTIC; 都是开源项目，你可以享受到零供应商锁定的好处。 4.13.3.3 部署架构 将 ProxySQL 与 TiDB 集成的最直接方式是在应用层和 TiDB 之间添加 ProxySQL 作为独立中介。但是，这种方式无 法保证可扩展性和容错性，而且可能因为网络跳转而增加延迟。为避免这些问题，一种替代部署架构是将 ProxySQL 作为附属容器部署，如下图所示： 433 图 31: proxysql-client-side-tidb-cloud 部分，保证后缀为同样 长度。 594 6.4.7.3 第 2 步：创建目标表结构 CSV 文件自身未包含表结构信息。要将 CSV 数据导入 TiDB，就必须为数据提供表结构。可以通过以下任一方法 创建表结构： • 方法一：使用 TiDB Lightning 创建表结构。 编写包含 DDL 语句的 SQL 文件如下： – 文件名格式为 ${db_name}-schema-create.sql，其内容需包含

crypter �→ .key 不 需要配置。 56 配置文件 或组件 配置项 修改类型 描述 BR --log. �→ crypter �→ . �→ method 新增 设置日志 备份数据 的加密算 法，支持 aes128- �→ ctr、 aes192- �→ ctr 和 aes256- �→ ctr 三 种算法， 缺省值为 plaintext， 表示不加 密。 BR --master- +----+--------------+---------+ 4.9.1.2.1 开启事务 要显式地开启一个新事务，既可以使用 BEGIN 语句，也可以使用 START TRANSACTION 语句，两者效果相同。语 法： BEGIN; START TRANSACTION; TiDB 的默认事务模式是悲观事务，你也可以明确指定开启乐观事务： BEGIN OPTIMISTIC; 开启悲观事务： BEGIN PESSIMISTIC; 都是开源项目，你可以享受到零供应商锁定的好处。 4.14.3.3 部署架构 将 ProxySQL 与 TiDB 集成的最直接方式是在应用层和 TiDB 之间添加 ProxySQL 作为独立中介。但是，这种方式无 法保证可扩展性和容错性，而且可能因为网络跳转而增加延迟。为避免这些问题，一种替代部署架构是将 ProxySQL 作为附属容器部署，如下图所示： 504 图 32: proxysql-client-side-tidb-cloud

crypter �→ .key 不 需要配置。 61 配置文件 或组件 配置项 修改类型 描述 BR --log. �→ crypter �→ . �→ method 新增 设置日志 备份数据 的加密算 法，支持 aes128- �→ ctr、 aes192- �→ ctr 和 aes256- �→ ctr 三 种算法， 缺省值为 plaintext， 表示不加 密。 BR --master- +----+--------------+---------+ 4.9.1.2.1 开启事务 要显式地开启一个新事务，既可以使用 BEGIN 语句，也可以使用 START TRANSACTION 语句，两者效果相同。语 法： BEGIN; START TRANSACTION; TiDB 的默认事务模式是悲观事务，你也可以明确指定开启乐观事务： BEGIN OPTIMISTIC; 开启悲观事务： BEGIN PESSIMISTIC; 都是开源项目，你可以享受到零供应商锁定的好处。 4.14.3.3 部署架构 将 ProxySQL 与 TiDB 集成的最直接方式是在应用层和 TiDB 之间添加 ProxySQL 作为独立中介。但是，这种方式无 法保证可扩展性和容错性，而且可能因为网络跳转而增加延迟。为避免这些问题，一种替代部署架构是将 ProxySQL 作为附属容器部署，如下图所示： 508 图 32: proxysql-client-side-tidb-cloud

+----+--------------+---------+ 4.8.1.2.1 开启事务 要显式地开启一个新事务，既可以使用 BEGIN 语句，也可以使用 START TRANSACTION 语句，两者效果相同。语 法： BEGIN; START TRANSACTION; TiDB 的默认事务模式是悲观事务，你也可以明确指定开启乐观事务： BEGIN OPTIMISTIC; 开启悲观事务： BEGIN PESSIMISTIC; 都是开源项目，你可以享受到零供应商锁定的好处。 4.13.3.3 部署架构 将 ProxySQL 与 TiDB 集成的最直接方式是在应用层和 TiDB 之间添加 ProxySQL 作为独立中介。但是，这种方式无 法保证可扩展性和容错性，而且可能因为网络跳转而增加延迟。为避免这些问题，一种替代部署架构是将 ProxySQL 作为附属容器部署，如下图所示： 437 图 31: proxysql-client-side-tidb-cloud 将递归地寻找该目录下及其子目录内的所有 .csv 文件。 600 6.4.7.3 第 2 步：创建目标表结构 CSV 文件自身未包含表结构信息。要将 CSV 数据导入 TiDB，就必须为数据提供表结构。可以通过以下任一方法 创建表结构： • 方法一：使用 TiDB Lightning 创建表结构。 编写包含 DDL 语句的 SQL 文件如下： – 文件名格式为 ${db_name}-schema-create.sql，其内容需包含

的指 定表； 支持 断点 续传； 支持 数据 过滤。 如果 使用 Local- backend 进行 数据 导入， TiDB Light- ning 运行 后， TiDB 集群 将无 法正 常对 外提 供服 务。 如果 你不 希望 TiDB 集群 的对 外服 务受 到影 响， 可以 参考 TiDB Light- ning TiDB- backend 中的 硬件 需求 与部 数字部分不需要连续但必须递增，并用零填充。 文件扩展名必须为 *.csv，即使文件的内容并非逗号分隔。 136 5.4.1.2 表结构 CSV 文件是没有表结构的。要导入 TiDB，就必须为其提供表结构。可以通过以下任一方法实现： • 创建包含 DDL 语句 CREATE TABLE 的文件 db_name.table_name-schema.sql 以及包含 CREATE DATABASE DDL 语句的文件 db_name-schema-create 请在测试环境下对所有修改做好充分测试后，再应用到生产环境中。 9.1.1.1 性能分析工具 系统调优需要根据系统性能分析的结果做指导，因此本文先列出常用的性能分析方法。 9.1.1.1.1 60 秒分析法 此分析法由《性能之巅》的作者 Brendan Gregg 及其所在的 Netflix 性能工程团队公布。所用到的工具均可从发 行版的官方源获取，通过分析以下清单中的输出，可定位大部分常见的性能问题。 •

的指 定表； 支持 断点 续传； 支持 数据 过滤。 如果 使用 Local- backend 进行 数据 导入， TiDB Light- ning 运行 后， TiDB 集群 将无 法正 常对 外提 供服 务。 如果 你不 希望 TiDB 集群 的对 外服 务受 到影 响， 可以 参考 TiDB Light- ning TiDB- backend 中的 硬件 需求 与部 数字部分不需要连续但必须递增，并用零填充。 文件扩展名必须为 *.csv，即使文件的内容并非逗号分隔。 130 5.4.1.2 表结构 CSV 文件是没有表结构的。要导入 TiDB，就必须为其提供表结构。可以通过以下任一方法实现： • 创建包含 DDL 语句 CREATE TABLE 的文件 db_name.table_name-schema.sql 以及包含 CREATE DATABASE DDL 语句的文件 db_name-schema-create 请在测试环境下对所有修改做好充分测试后，再应用到生产环境中。 9.1.1.1 性能分析工具 系统调优需要根据系统性能分析的结果做指导，因此本文先列出常用的性能分析方法。 9.1.1.1.1 60 秒分析法 此分析法由《性能之巅》的作者 Brendan Gregg 及其所在的 Netflix 性能工程团队公布。所用到的工具均可从发 行版的官方源获取，通过分析以下清单中的输出，可定位大部分常见的性能问题。 •