. . 44 使用 Spring 命名空间 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 6.1.3 事件追踪 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 使用 Java API . . . 56 ii 分布式监听器配置项 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 6.2.4 事件追踪配置项 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 可配置属性 . . . . . . . . . . 59 作业配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 事件追踪配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 作业信息导出配置 . . . .

未进行过多的封装，而是直接将分片键值组合以及分片操作符透传至分片算法，完全由应用开发者实现， 提供最大的灵活度。 • Hint 分片策略 对应 HintShardingStrategy。通过 Hint 指定分片值而非从 SQL 中提取分片值的方式进行分片的策略。 • 不分片策略 对应 NoneShardingStrategy。不分片的策略。 3.1. 数据分片 13 Apache ShardingSphere document 是 Groovy 的语法， Groovy 能够支持的所有操作，行表达式均能够支持。例如： ${begin..end} 表示范围区间 ${[unit1, unit2, unit_x]} 表示枚举值 3.1. 数据分片 15 Apache ShardingSphere document, v5.0.0-beta 行表达式中如果出现连续多个 ${ expression } 或 $->{ expression 的自增键，Oracle 的自增序列等。数据分片后，不同数据节点生成全局唯一主键是非常棘手 的问题。同一个逻辑表内的不同实际表之间的自增键由于无法互相感知而产生重复主键。虽然可通过约 束自增主键初始值和步长的方式避免碰撞，但需引入额外的运维规则，使解决方案缺乏完整性和可扩展 性。 目前有许多第三方解决方案可以完美解决这个问题，如 UUID 等依靠特定算法自生成不重复键，或者通过 引入主键生成

更改为实际的版本号。 3. 创建 YAML 配置文件 # JDBC 逻辑库名称。在集群模式中，使用该参数来联通 ShardingSphere-JDBC 与 ShardingSphere- Proxy。 # 默认值：logic_db databaseName (?): mode: dataSources: rules: - !FOO_XXX ... - !BAR_XXX ... props: 包含分片键和分片算法，由于分片算法的独立性，将其独立抽离。真正可用于分片操作的是分片键 + 分 片算法，也就是分片策略。 强制分片路由 对于分片字段并非由 SQL 而是其他外置条件决定的场景，可使用 SQL Hint 注入分片值。例：按照员工登 录主键分库，而数据库中并无此字段。SQL Hint 支持通过 Java API 和 SQL 注释两种方式使用。详情请参 见强制分片路由。 行表达式 行表达式是为了解决配置的简 的是 Groovy 的语法， Groovy 能够支持的所有操作，行表达式均能够支持。例如： ${begin..end} 表示范围区间 ${[unit1, unit2, unit_x]} 表示枚举值 行表达式中如果出现连续多个 ${ expression } 或 $->{ expression } 表达式，整个表达式最终 的结果将会根据每个子表达式的结果进行笛卡尔组合。 例如，以下行表达式：

更改为实际的版本号。 3. 创建 YAML 配置文件 # JDBC 逻辑库名称。在集群模式中，使用该参数来联通 ShardingSphere-JDBC 与 ShardingSphere- Proxy。 # 默认值：logic_db databaseName (?): mode: dataSources: rules: - !FOO_XXX ... - !BAR_XXX ... props: 包含分片键和分片算法，由于分片算法的独立性，将其独立抽离。真正可用于分片操作的是分片键 + 分 片算法，也就是分片策略。 强制分片路由 对于分片字段并非由 SQL 而是其他外置条件决定的场景，可使用 SQL Hint 注入分片值。例：按照员工登 录主键分库，而数据库中并无此字段。SQL Hint 支持通过 Java API 和 SQL 注释两种方式使用。详情请参 见强制分片路由。 行表达式 行表达式是为了解决配置的简 的是 Groovy 的语法， Groovy 能够支持的所有操作，行表达式均能够支持。例如： ${begin..end} 表示范围区间 ${[unit1, unit2, unit_x]} 表示枚举值 行表达式中如果出现连续多个 ${ expression } 或 $->{ expression } 表达式，整个表达式最终 的结果将会根据每个子表达式的结果进行笛卡尔组合。 例如，以下行表达式：

更改为实际的版本号。 3. 创建 YAML 配置文件 # JDBC 逻辑库名称。在集群模式中，使用该参数来联通 ShardingSphere-JDBC 与 ShardingSphere- Proxy。 # 默认值：logic_db databaseName (?): mode: dataSources: rules: - !FOO_XXX ... - !BAR_XXX ... props: 包含分片键和分片算法，由于分片算法的独立性，将其独立抽离。真正可用于分片操作的是分片键 + 分 片算法，也就是分片策略。 强制分片路由 对于分片字段并非由 SQL 而是其他外置条件决定的场景，可使用 SQL Hint 注入分片值。例：按照员工登 录主键分库，而数据库中并无此字段。SQL Hint 支持通过 Java API 和 SQL 注释两种方式使用。详情请参 见强制分片路由。 行表达式 行表达式是为了解决配置的简 的是 Groovy 的语法， Groovy 能够支持的所有操作，行表达式均能够支持。例如： ${begin..end} 表示范围区间 ${[unit1, unit2, unit_x]} 表示枚举值 行表达式中如果出现连续多个 ${ expression } 或 $->{ expression } 表达式，整个表达式最终 的结果将会根据每个子表达式的结果进行笛卡尔组合。 例如，以下行表达式：

session.close(); } 诚然这种方式能够正常工作，并且对于使用旧版本 MyBatis 的用户来说也比较熟悉，不过现在有了一种更直白的方式。使用对于给定 语句能够合理描述参数和返回值的接口（比如说BlogMapper.class），你现在不但可以执行更清晰和类型安全的代码，而且还不用担 心易错的字符串字面值以及强制类型转换。 例如： SqlSession session = sqlSessionFactory ，你 可以很轻松的在基于注解和 XML 的语句映射方式间自由移植和切换。 范围（ 范围（Scope）和生命周期 ）和生命周期 理解我们目前已经讨论过的不同范围和生命周期类是至关重要的，因为错误的使用会导致非常严重的并发问题。 提示 提示 提示 提示 对象生命周期和依赖注入框架 对象生命周期和依赖注入框架 依赖注入框架可以创建线程安全的、基于事务的 SqlSession 和映射器（mapper）并将它们直接注入到你的 和映射器（mapper）并将它们直接注入到你的 bean 中，因此可以直接 PDFmyURL - the best online web to pdf conversion service 忽略它们的生命周期。如果对如何通过依赖注入框架来使用 MyBatis 感兴趣可以研究一下 MyBatis-Spring 或 MyBatis-Guice 两个 子项目。 SqlSessionFactoryBuilder 这

已经取好的别名 3.5 typeHandlers 类型处理器 1) 无论是 MyBatis 在预处理语句（PreparedStatement）中设置一个参数时，还是从结果 集中取出一个值时， 都会用类型处理器将获取的值以合适的方式转换成 Java 类型 2) MyBatis 中提供的类型处理器: 3) 日期和时间的处理，JDK1.8 以前一直是个头疼的问题。我们通常使用 JSR310 规范领导 者 JDBC：使用了 JDBC 的提交和回滚设置，依赖于从数据源得到的连接来管理事务 范 围。 JdbcTransactionFactory MANAGED：不提交或回滚一个连接、让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。 ManagedTransactionFactory 自定义：实现 TransactionFactory 接口，type=全类名/别名 6) dataSource 接口来自定义. 会通过 DatabaseMetaData#getDatabaseProductName() 返回的字符串进行设置。由于 通常情况下这个字符串都非常长而且相同产品的不同版本会返回不同的值，所以最好通 过设置属性别名来使其变短. Property-name：数据库厂商标识 Property-value：为标识起一个别名，方便 SQL 语句使用 databaseId 属性引用 3) 配置了

包含分片键和分片算法，由于分片算法的独立性，将其独立抽离。真正可用于分片操作的是分片键 + 分 片算法，也就是分片策略。 强制分片路由 对于分片字段并非由 SQL 而是其他外置条件决定的场景，可使用 SQL Hint 注入分片值。例：按照员工登 录主键分库，而数据库中并无此字段。SQL Hint 支持通过 Java API 和 SQL 注释（待实现）两种方式使用。 详情请参见强制分片路由。 行表达式 实现动机 配置 是 Groovy 的语法， Groovy 能够支持的所有操作，行表达式均能够支持。例如： ${begin..end} 表示范围区间 ${[unit1, unit2, unit_x]} 表示枚举值 行表达式中如果出现连续多个 ${ expression } 或 $->{ expression } 表达式，整个表达式最终 的结果将会根据每个子表达式的结果进行笛卡尔组合。 例如，以下行表达式： 的自增键，Oracle 的自增序列等。数据分片后，不同数据节点生成全局唯一主键是非常棘手 的问题。同一个逻辑表内的不同实际表之间的自增键由于无法互相感知而产生重复主键。虽然可通过约 束自增主键初始值和步长的方式避免碰撞，但需引入额外的运维规则，使解决方案缺乏完整性和可扩展 性。 目前有许多第三方解决方案可以完美解决这个问题，如 UUID 等依靠特定算法自生成不重复键，或者通过 引入主键生成

数据分片 20 Apache ShardingSphere document, v5.2.0 强制分片路由 对于分片字段并非由 SQL 而是其他外置条件决定的场景，可使用 SQL Hint 注入分片值。例：按照员工登 录主键分库，而数据库中并无此字段。SQL Hint 支持通过 Java API 和 SQL 注释两种方式使用。详情请参 见强制分片路由。 行表达式 行表达式是为了解决配置的简 的是 Groovy 的语法， Groovy 能够支持的所有操作，行表达式均能够支持。例如： ${begin..end} 表示范围区间 ${[unit1, unit2, unit_x]} 表示枚举值 行表达式中如果出现连续多个 ${ expression } 或 $->{ expression } 表达式，整个表达式最终 的结果将会根据每个子表达式的结果进行笛卡尔组合。 例如，以下行表达式： 的自增键，Oracle 的自增序列等。数据分片后，不同数据节点生成全局唯一主键是非常棘手 的问题。同一个逻辑表内的不同实际表之间的自增键由于无法互相感知而产生重复主键。虽然可通过约 束自增主键初始值和步长的方式避免碰撞，但需引入额外的运维规则，使解决方案缺乏完整性和可扩展 性。 目前有许多第三方解决方案可以完美解决这个问题，如 UUID 等依靠特定算法自生成不重复键，或者通过 引入主键生成

包含分片键和分片算法，由于分片算法的独立性，将其独立抽离。真正可用于分片操作的是分片键 + 分 片算法，也就是分片策略。 强制分片路由 对于分片字段并非由 SQL 而是其他外置条件决定的场景，可使用 SQL Hint 注入分片值。例：按照员工登 录主键分库，而数据库中并无此字段。SQL Hint 支持通过 Java API 和 SQL 注释（待实现）两种方式使用。 详情请参见强制分片路由。 行表达式 实现动机 配置 是 Groovy 的语法， Groovy 能够支持的所有操作，行表达式均能够支持。例如： ${begin..end} 表示范围区间 ${[unit1, unit2, unit_x]} 表示枚举值 行表达式中如果出现连续多个 ${ expression } 或 $->{ expression } 表达式，整个表达式最终 的结果将会根据每个子表达式的结果进行笛卡尔组合。 例如，以下行表达式： 的自增键，Oracle 的自增序列等。数据分片后，不同数据节点生成全局唯一主键是非常棘手 的问题。同一个逻辑表内的不同实际表之间的自增键由于无法互相感知而产生重复主键。虽然可通过约 束自增主键初始值和步长的方式避免碰撞，但需引入额外的运维规则，使解决方案缺乏完整性和可扩展 性。 目前有许多第三方解决方案可以完美解决这个问题，如 UUID 等依靠特定算法自生成不重复键，或者通过 引入主键生成