default_hostgroup：用户使用的默认 hostgroup，除非特定的查询规则覆盖了 hostgroup，否则 SQL 将会默认路由到 default_hostgroup。 • transaction_persistent：值为 1 表示使用持久性事务。即当用户在一个连接中启动 一个事务时，所有的查询语句都被路由到同一个 hostgroup，直到事务被提交或回 滚。 选项 2: 使用配置文件配置 ProxySQL 515 4.14.3.6.1 查询规则 数据库可能会因为高流量、错误代码或恶意攻击而过载。因此，审核 SQL 是必要的。使用 ProxySQL 的查询规 则，你可以有效地应对这些问题，例如通过重路由、改写 SQL 或者拒绝查询等方式。 图 35: proxysql-client-side-rules 注意： 以下步骤使用 TiDB 和 ProxySQL 的容器镜像配置查询规则。如果你还没有拉取这些镜像，请参 �→ 分别配置为两条 rule，以示例如何避免实例 1 的 my_db2 被同步。 bw-rule-2: do-dbs: ["my_db2"] 648 routes: # 上游和下游表之间的路由 table routing 规则集 route-rule-1: # 配置名称。将 my_db1 中的 table1 和 table2 合并导入下游 my �→ _db.table5 schema-pattern:

default_hostgroup：用户使用的默认 hostgroup，除非特定的查询规则覆盖了 hostgroup，否则 SQL 将会默认路由到 default_hostgroup。 • transaction_persistent：值为 1 表示使用持久性事务。即当用户在一个连接中启动 一个事务时，所有的查询语句都被路由到同一个 hostgroup，直到事务被提交或回 滚。 选项 2: 使用配置文件配置 ProxySQL 448 4.13.3.6.1 查询规则 数据库可能会因为高流量、错误代码或恶意攻击而过载。因此，审核 SQL 是必要的。使用 ProxySQL 的查询规 则，你可以有效地应对这些问题，例如通过重路由、改写 SQL 或者拒绝查询等方式。 图 34: proxysql-client-side-rules 注意： 以下步骤使用 TiDB 和 ProxySQL 的容器镜像配置查询规则。如果你还没有拉取这些镜像，请参 �→ 分别配置为两条 rule，以示例如何避免实例 1 的 my_db2 被同步。 bw-rule-2: do-dbs: ["my_db2"] 590 routes: # 上游和下游表之间的路由 table routing 规则集 route-rule-1: # 配置名称。将 my_db1 中的 table1 和 table2 合并导入下游 my �→ _db.table5 schema-pattern:

default_hostgroup：用户使用的默认 hostgroup，除非特定的查询规则覆盖了 hostgroup，否则 SQL 将会默认路由到 default_hostgroup。 • transaction_persistent：值为 1 表示使用持久性事务。即当用户在一个连接中启动 一个事务时，所有的查询语句都被路由到同一个 hostgroup，直到事务被提交或回 滚。 选项 2: 使用配置文件配置 ProxySQL 519 4.14.3.6.1 查询规则 数据库可能会因为高流量、错误代码或恶意攻击而过载。因此，审核 SQL 是必要的。使用 ProxySQL 的查询规 则，你可以有效地应对这些问题，例如通过重路由、改写 SQL 或者拒绝查询等方式。 图 35: proxysql-client-side-rules 注意： 以下步骤使用 TiDB 和 ProxySQL 的容器镜像配置查询规则。如果你还没有拉取这些镜像，请参 �→ 分别配置为两条 rule，以示例如何避免实例 1 的 my_db2 被同步。 bw-rule-2: do-dbs: ["my_db2"] 653 routes: # 上游和下游表之间的路由 table routing 规则集 route-rule-1: # 配置名称。将 my_db1 中的 table1 和 table2 合并导入下游 my �→ _db.table5 schema-pattern:

default_hostgroup：用户使用的默认 hostgroup，除非特定的查询规则覆盖了 hostgroup，否则 SQL 将会默认路由到 default_hostgroup。 • transaction_persistent：值为 1 表示使用持久性事务。即当用户在一个连接中启动 一个事务时，所有的查询语句都被路由到同一个 hostgroup，直到事务被提交或回 滚。 选项 2: 使用配置文件配置 ProxySQL 459 4.13.3.6.1 查询规则 数据库可能会因为高流量、错误代码或恶意攻击而过载。因此，审核 SQL 是必要的。使用 ProxySQL 的查询规 则，你可以有效地应对这些问题，例如通过重路由、改写 SQL 或者拒绝查询等方式。 图 34: proxysql-client-side-rules 注意： 以下步骤使用 TiDB 和 ProxySQL 的容器镜像配置查询规则。如果你还没有拉取这些镜像，请参 �→ 分别配置为两条 rule，以示例如何避免实例 1 的 my_db2 被同步。 bw-rule-2: do-dbs: ["my_db2"] 600 routes: # 上游和下游表之间的路由 table routing 规则集 route-rule-1: # 配置名称。将 my_db1 中的 table1 和 table2 合并导入下游 my �→ _db.table5 schema-pattern:

default_hostgroup：用户使用的默认 hostgroup，除非特定的查询规则覆盖了 hostgroup，否则 SQL 将会默认路由到 default_hostgroup。 • transaction_persistent：值为 1 表示使用持久性事务。即当用户在一个连接中启动 一个事务时，所有的查询语句都被路由到同一个 hostgroup，直到事务被提交或回 滚。 选项 2: 使用配置文件配置 ProxySQL 444 4.13.3.6.1 查询规则 数据库可能会因为高流量、错误代码或恶意攻击而过载。因此，审核 SQL 是必要的。使用 ProxySQL 的查询规 则，你可以有效地应对这些问题，例如通过重路由、改写 SQL 或者拒绝查询等方式。 图 34: proxysql-client-side-rules 注意： 以下步骤使用 TiDB 和 ProxySQL 的容器镜像配置查询规则。如果你还没有拉取这些镜像，请参 �→ 分别配置为两条 rule，以示例如何避免实例 1 的 my_db2 被同步。 bw-rule-2: do-dbs: ["my_db2"] 584 routes: # 上游和下游表之间的路由 table routing 规则集 route-rule-1: # 配置名称。将 my_db1 中的 table1 和 table2 合并导入下游 my �→ _db.table5 schema-pattern:

default_hostgroup：用户使用的默认 hostgroup，除非特定的查询规则覆盖了 hostgroup，否则 SQL 将会默认路由到 default_hostgroup。 • transaction_persistent：值为 1 表示使用持久性事务。即当用户在一个连接中启动 一个事务时，所有的查询语句都被路由到同一个 hostgroup，直到事务被提交或回 滚。 选项 2: 使用配置文件配置 ProxySQL 455 4.13.3.6.1 查询规则 数据库可能会因为高流量、错误代码或恶意攻击而过载。因此，审核 SQL 是必要的。使用 ProxySQL 的查询规 则，你可以有效地应对这些问题，例如通过重路由、改写 SQL 或者拒绝查询等方式。 图 34: proxysql-client-side-rules 注意： 以下步骤使用 TiDB 和 ProxySQL 的容器镜像配置查询规则。如果你还没有拉取这些镜像，请参 �→ 分别配置为两条 rule，以示例如何避免实例 1 的 my_db2 被同步。 bw-rule-2: do-dbs: ["my_db2"] 595 routes: # 上游和下游表之间的路由 table routing 规则集 route-rule-1: # 配置名称。将 my_db1 中的 table1 和 table2 合并导入下游 my �→ _db.table5 schema-pattern:

default_hostgroup：用户使用的默认 hostgroup，除非特定的查询规则覆盖了 hostgroup，否则 SQL 将会默认路由到 default_hostgroup。 • transaction_persistent：值为 1 表示使用持久性事务。即当用户在一个连接中启动 一个事务时，所有的查询语句都被路由到同一个 hostgroup，直到事务被提交或回 滚。 选项 2: 使用配置文件配置 ProxySQL 445 4.13.3.6.1 查询规则 数据库可能会因为高流量、错误代码或恶意攻击而过载。因此，审核 SQL 是必要的。使用 ProxySQL 的查询规 则，你可以有效地应对这些问题，例如通过重路由、改写 SQL 或者拒绝查询等方式。 图 34: proxysql-client-side-rules 注意： 以下步骤使用 TiDB 和 ProxySQL 的容器镜像配置查询规则。如果你还没有拉取这些镜像，请参 �→ 分别配置为两条 rule，以示例如何避免实例 1 的 my_db2 被同步。 bw-rule-2: do-dbs: ["my_db2"] 583 routes: # 上游和下游表之间的路由 table routing 规则集 route-rule-1: # 配置名称。将 my_db1 中的 table1 和 table2 合并导入下游 my �→ _db.table5 schema-pattern:

项目设计 阶段 分库分表设计 数据库中间件路由配置 数据库主从备份设计 月级别 类似单机数据库，不需要做任 何设计、修改 0 项目开发 阶段 事务处理机制 - 由应用保证 跨库、跨表查询 - 由应用保证 月级别 类似单机数据库，事务由底层 数据库提供，支持透明分布式 事务 0 扩容、缩 容、维护 制作分库数据镜像 暂停业务 检验所有数据和原有数据的一致性 切换路由配置 上线后测试验证 开始业务 （中间有问题都需要进行相应的重试

修复空配置可能导致 dm-master panic 的问题 #3732 – TiDB Lightning * 修复前置检查中没有检查本地磁盘空间以及集群是否可用的问题 #34213 * 修复 schema 路由错误的问题 #33381 * 修复 TiDB Lightning panic 时 PD 配置未正确恢复的问题 #31733 * 修复由 auto_increment 列的数据越界导致 local 自动生成的用于管理项目的脚本。 • example_project 包含项目级别的代码： – settings.py 声明了项目的配置，如数据库地址、密码、使用的数据库方言等。 – urls.py 配置了项目的根路由。 • player 是项目中提供对 Player 数据模型管理、数据查询的包，这在 Django 中被称为应用。你可以使用 python manage.py startapp player 来创建一个空白的 是一组数据模型迁移脚本。你可以使用 python manage.py makemigrations player 命 令自动分析 models.py 文件中定义的数据对象，并生成迁移脚本。 – urls.py 定义了应用的路由。 – views.py 提供了应用的逻辑代码。 注意： 由于 Django 的设计采用了可插拔模式，因此，你需要在创建应用后，在项目中进行注册。在 本示例中，注册过程就是在 example_project/settings

my_db2 分别配置为两条 �→ rule。以示例如何避免实例1的 my_db2 被同步。 bw-rule-2: do-dbs: ["my_db2"] routes: # 上游和下游表之间的路由 table routing 规则集 route-rule-1: # 配置名称。将 my_db1 中的 table1 和 table2 合并导入下游 my �→ _db.table5 schema-pattern: stale_epoch 请求的 epoch 太旧了，TiDB 会更新路由之后再重新发送请求，业务无感知。epoch 在 Region 发生 split/merge 以及迁移副本的时候会变化。 412 • 7.2.6 peer is not leader 请求发到了非 Leader 的副本上，TiDB 会根据该错误更新本地路由（如果错误 response 里携带了最新 Leader 是哪个副本这一信息），并且重新发送请求到最新 断关联性。不能再手动配置其亲和性。目前已知的有使用 be2iscsi 驱动的设备，以及 NVMe 设置； – 对于其他设备，可查询其芯片手册，是否支持分发中断。 * 若不支持，则该设备的所有中断会路由到同一个 CPU 上，无法对其进行修改。 * 若支持，则计算 smp_affinity 掩码并设置对应的配置文件，具体请参考内核 IRQ-affinity 文档。 9.1.1.2.3 NUMA 绑核