JDBC 驱动 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 9.1.2 Java API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 简介 . . . . . . . 算法配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 9.1.3 特殊 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 数据分片 . . . . . 强制分片路由 对于分片字段并非由 SQL 而是其他外置条件决定的场景，可使用 SQL Hint 注入分片值。例：按照员工登 录主键分库，而数据库中并无此字段。SQL Hint 支持通过 Java API 和 SQL 注释两种方式使用。详情请参 见强制分片路由。 行表达式 行表达式是为了解决配置的简化与一体化这两个主要问题。在繁琐的数据分片规则配置中，随着数据节 点的增多，大量的重复配置使得

JDBC 驱动 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 9.1.2 Java API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 简介 . . . . . . . 算法配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 9.1.3 特殊 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 数据分片 . . . . . 强制分片路由 对于分片字段并非由 SQL 而是其他外置条件决定的场景，可使用 SQL Hint 注入分片值。例：按照员工登 录主键分库，而数据库中并无此字段。SQL Hint 支持通过 Java API 和 SQL 注释两种方式使用。详情请参 见强制分片路由。 行表达式 行表达式是为了解决配置的简化与一体化这两个主要问题。在繁琐的数据分片规则配置中，随着数据节 点的增多，大量的重复配置使得

JDBC 驱动 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 4.1.2 Java API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 简介 . . . . . . . 算法配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 4.1.5 特殊 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 数据分片 . . . . . 强制分片路由 对于分片字段并非由 SQL 而是其他外置条件决定的场景，可使用 SQL Hint 注入分片值。例：按照员工登 录主键分库，而数据库中并无此字段。SQL Hint 支持通过 Java API 和 SQL 注释两种方式使用。详情请参 见强制分片路由。 行表达式 行表达式是为了解决配置的简化与一体化这两个主要问题。在繁琐的数据分片规则配置中，随着数据节 点的增多，大量的重复配置使得

4.1.4 配置手册 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 Java API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 YAML 配置 . . . 对于分片字段非 SQL 决定，而由其他外置条件决定的场景，可使用 SQL Hint 灵活的注入分片字段。例： 内部系统，按照员工登录主键分库，而数据库中并无此字段。SQL Hint 支持通过 Java API 和 SQL 注释 （待实现）两种方式使用。详情请参见强制分片路由。 配置 分片规则 分片规则配置的总入口。包含数据源配置、表配置、绑定表配置以及读写分离配置等。 数据源配置 真实数据源列表。 • 表分片策略 对应于 TableShardingStrategy。用于配置数据被分配的目标表，该目标表存在于该数据的目标数据源内。 故表分片策略是依赖于数据源分片策略的结果的。 两种策略的 API 完全相同。 自增主键生成策略 通过在客户端生成自增主键替换以数据库原生自增主键的方式，做到分布式主键无重复。 行表达式 实现动机 配置的简化与一体化是行表达式所希望解决的两个主要问题。

JDBC 驱动 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 9.1.2 Java API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 简介 . . . . . . . 算法配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 9.1.3 特殊 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 数据分片 . . . . . 强制分片路由 对于分片字段并非由 SQL 而是其他外置条件决定的场景，可使用 SQL Hint 注入分片值。例：按照员工登 录主键分库，而数据库中并无此字段。SQL Hint 支持通过 Java API 和 SQL 注释两种方式使用。详情请参 见强制分片路由。 行表达式 行表达式是为了解决配置的简化与一体化这两个主要问题。在繁琐的数据分片规则配置中，随着数据节 点的增多，大量的重复配置使得

5.1.4 配置手册 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Java API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 YAML 配置 . . . 同级目录下生成代码，容易误提交，如何避免？ . . 295 7.7.26 26. [其他] 使用 Proxool 时分库结果不正确？ . . . . . . . . . . . . . . . . . . . 296 7.8 API 变更历史 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 7.8.1 ShardingSphere‐JDBC 297 YAML 配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 Java API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 Spring 命名空间配置

ShardingSphere‐JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 5.1.1 Java API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 简介 . . . . . . . 影子算法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 5.1.7 特殊 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 数据分片 . . . . . 时，配置文件中的属性设置不 生效？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 7.9 API 变更历史 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311 7.9.1 ShardingSphere‐JDBC

ShardingSphere‐JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 5.1.1 Java API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 简介 . . . . . . . 影子算法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 5.1.7 特殊 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 数据分片 . . . . . 时，配置文件中的属性设置不 生效？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314 7.9 API 变更历史 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 7.9.1 ShardingSphere‐JDBC

ShardingSphere‐JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 5.1.1 Java API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 简介 . . . . . . . 影子算法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 5.1.8 特殊 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 数据分片 . . . . . metadata 元数 据时结果不正确？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 7.9 API 变更历史 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 7.9.1 ShardingSphere‐JDBC

· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 242 7.2 TiDB 集群监控 API· · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · · 使用以下任一工具将集群 A 的数据全局一致地导出到指定路径下： • 使用BR 全量备份 • 使用Dumpling 全量导出 2. 获取全局一致的时间戳 COMMIT_TS： • 使用 BR validate 指令获取备份的时间戳，示例如下： COMMIT_TS=`br validate decode --field="end-version" -s local:///home/tidb/backupdata 节点的下线。 手动在 PD 中清除同步规则的步骤如下： 1. 查询当前 PD 实例中所有与 TiFlash 相关的的数据同步规则。 curl http://:/pd/api/v1/config/rules/group/tiflash [ { "group_id": "tiflash", "id": "table-45-r", "override": true