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

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 注释两种方式使用。详情请参 见强制分片路由。 行表达式 行表达式是为了解决配置的简化与一体化这两个主要问题。在繁琐的数据分片规则配置中，随着数据节 点的增多，大量的重复配置使得

分为词法解析和语法解析。 先通过词法解析器将SQL拆分为一个个不可再分的单词。再使用语 法解析器对SQL进行理解，并最终提炼出解析上下文。 解析上下文包括表、选择项、排序项、 分组项、聚合函数、分页信息、查询条件以及可能需要修改的占位符的标记。 执行器优化 合并和优化分片条件，如OR等。 SQL路由 根据解析上下文匹配用户配置的分片策略，并生成路由路径。目前支持分片路由和广播路由。