SqlSessionFactory 的实例。 从 XML 文件中构建 SqlSessionFactory 的实例非常简单，建议使用类路径下的资源文件进行配置。但是也可以使用任意的输入流 (InputStream)实例，包括字符串形式的文件路径或者 file:// 的 URL 形式的文件路径来配置。MyBatis 包含一个名叫 Resources 的 工具类，它包含一些实用方法，可使从 classpath 或其他位置加载资源文件更加容易。 的用户来说也比较熟悉，不过现在有了一种更直白的方式。使用对于给定 语句能够合理描述参数和返回值的接口（比如说BlogMapper.class），你现在不但可以执行更清晰和类型安全的代码，而且还不用担 心易错的字符串字面值以及强制类型转换。 例如： SqlSession session = sqlSessionFactory.openSession(); try { BlogMapper mapper 语句中的名字、参数和返回类型匹配成方法。这样你就可以向上面那样很容易地调用这个对 应 Mapper 接口的方法。不过让我们再看一遍下面的例子： BlogMapper mapper = session.getMapper(BlogMapper.class); Blog blog = mapper.selectBlog(101); 第二种方法有很多优势，首先它不是基于字符串常量的，就会更安全；其次，如果你的

尽量多的兼容各种数据库，让用户零使用成本，是 Apache ShardingSphere 数据库兼容度希望达成的主 要目标。 4.1.4 SQL 解析 SQL 是使用者与数据库交流的标准语言。SQL 解析引擎负责将 SQL 字符串解析为抽象语法树，供 Apache ShardingSphere 理解并实现其增量功能。 目前支持 MySQL, PostgreSQL, SQLServer, Oracle, openGauss 置。 影子算法 影子算法和业务实现紧密相关，目前提供 2 种类型影子算法。 • 基于列的影子算法 通过识别 SQL 中的数据，匹配路由至影子库的场景。适用于由压测数据名单驱动的压测场景。 • 基于 Hint 的影子算法 通过识别 SQL 中的注释，匹配路由至影子库的场景。适用于由上游系统透传标识驱动的压测场景。 4.9.5 使用规范 支持项 • 基于 Hint 的影子算法支持全部 定义每秒采集数量，boundary: 0.0001 ‐ 1.0 1（const 类 型） otel.reso urce.attributes open‐ teleme‐ try 资源 属性 字符串键值对（, 分割） servi ce.name=shardi ngsphere‐ agent otel. traces.exporter Tracing expoter zipkin、jaeger

尽量多的兼容各种数据库，让用户零使用成本，是 Apache ShardingSphere 数据库兼容度希望达成的主 要目标。 4.1.4 SQL 解析 SQL 是使用者与数据库交流的标准语言。SQL 解析引擎负责将 SQL 字符串解析为抽象语法树，供 Apache ShardingSphere 理解并实现其增量功能。 目前支持 MySQL, PostgreSQL, SQLServer, Oracle, openGauss 置。 影子算法 影子算法和业务实现紧密相关，目前提供 2 种类型影子算法。 • 基于列的影子算法 通过识别 SQL 中的数据，匹配路由至影子库的场景。适用于由压测数据名单驱动的压测场景。 • 基于 Hint 的影子算法 通过识别 SQL 中的注释，匹配路由至影子库的场景。适用于由上游系统透传标识驱动的压测场景。 4.9. 影子库压测 57 Apache ShardingSphere 定义每秒采集数量，boundary: 0.0001 ‐ 1.0 1（const 类 型） otel.reso urce.attributes open‐ teleme‐ try 资源 属性 字符串键值对（, 分割） servi ce.name=shardi ngsphere‐ agent otel. traces.exporter Tracing expoter zipkin、jaeger

尽量多的兼容各种数据库，让用户零使用成本，是 Apache ShardingSphere 数据库兼容度希望达成的主 要目标。 4.1.4 SQL 解析 SQL 是使用者与数据库交流的标准语言。SQL 解析引擎负责将 SQL 字符串解析为抽象语法树，供 Apache ShardingSphere 理解并实现其增量功能。 目前支持 MySQL, PostgreSQL, SQLServer, Oracle, openGauss 生成器的接口， 方便用户自行实现自定义的自增主键生成器。 内置的主键生成器 UUID 采用 UUID.randomUUID() 的方式产生分布式主键。 NanoID 生成长度为 21 的字符串分布式主键。 SNOWFLAKE 在分片规则配置模块可配置每个表的主键生成策略，默认使用雪花算法（snowflake）生成 64bit 的长整 型数据。 雪花算法是由 Twitter 公布 置。 影子算法 影子算法和业务实现紧密相关，目前提供 2 种类型影子算法。 • 基于列的影子算法 通过识别 SQL 中的数据，匹配路由至影子库的场景。适用于由压测数据名单驱动的压测场景。 • 基于 Hint 的影子算法 通过识别 SQL 中的注释，匹配路由至影子库的场景。适用于由上游系统透传标识驱动的压测场景。 4.9.5 使用规范 支持项 • 基于 Hint 的影子算法支持全部

value="1234" /> 2) 然而 properties 的作用并不单单是这样，你可以创建一个资源文件，名为 jdbc.properties 的文件,将四个连接字符串的数据在资源文件中通过键值 对 (key=value)的方式放置，不要任何符号，一条占一行 jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mys 解析数据库厂 商标识。也可以实现 DatabaseIdProvider 接口来自定义. 会通过 DatabaseMetaData#getDatabaseProductName() 返回的字符串进行设置。由于 通常情况下这个字符串都非常长而且相同产品的不同版本会返回不同的值，所以最好通 过设置属性别名来使其变短. Property-name：数据库厂商标识 Property-value：为标识起一个别名，方便 tbl_employee where id = #{id} 4) MyBatis 匹配规则如下: 1 如果没有配置 databaseIdProvider 标签，那么 databaseId=null 2 如果配置了 databaseIdProvider 标签，使用标签配置的 name 去匹配数据库信息， 匹配上设置 databaseId=配置指定的值，否则依旧为 null 3 如果 databaseId

以有效地将规则配置一同存放，更加易于浏览与存储。 行表达式作为字符串由两部分组成，分别是字符串开头的对应 SPI 实现的 Type Name 部分和表达式部 分。以 t_order_${1..3} 为例，字符串 部分的子字符串 GROOVY 为此行表达式 使用的对应 SPI 实现的 Type Name，其被 <> 符号包裹来识别。而字符串 t_order_${1..3} 为此行表 服务宕机后，在其它机器上恢复提交/回滚中的数据； • MySQL 事务块内，SQL 执行出现异常，执行 Commit，数据保持一致； • 配置 XA 事务后，存储单元名称最大长度不超过 45 个字符。 BASE 事务 不支持项 • 不支持隔离级别。 8.2.9 附录 不支持的 SQL： • 事务中使用 DistSQL 里的 RAL、RDL 操作； • XA 事务中使用 DDL 语句。 支持项 • 将外围数据迁移至 Apache ShardingSphere 所管理的数据库； • 目标端 proxy 不配置规则或配置任意规则； • 迁移单字段主键或唯一键的表，首字段类型：整型、字符型、部分二进制类型（比如 MySQL VARBINARY）； • 迁移复合主键或复合唯一键的表。 8.6. 数据迁移 41 Apache ShardingSphere document 不支持项

增量数据 在数据迁移作业执行过程中，业务系统所产生的新数据。 3.7.7 使用限制 支持项 • 将外围数据迁移至 Apache ShardingSphere 所管理的数据库； • 整型或字符串主键表迁移。 3.7. 数据迁移 39 Apache ShardingSphere document, v5.2.0 不支持项 • 无主键表迁移； • 复合主键表迁移； • 不支持在当 的配置。 影子算法 影子算法和业务实现紧密相关，目前提供 2 种类型影子算法。 • 基于列的影子算法通过识别 SQL 中的数据，匹配路由至影子库的场景。适用于由压测数据名单驱动 的压测场景。 • 基于 Hint 的影子算法通过识别 SQL 中的注释，匹配路由至影子库的场景。适用于由上游系统透传 标识驱动的压测场景。 3.9. 影子库 43 Apache ShardingSphere ShardingSphere document, v5.2.0 相关参考 影子库的特性描述 SQL 解析 背景信息 SQL 是使用者与数据库交流的标准语言。SQL 解析引擎负责将 SQL 字符串解析为抽象语法树，供 Apache ShardingSphere 理解并实现其增量功能。目前支持 MySQL, PostgreSQL, SQLServer, Oracle, openGauss

服务宕机后，在其它机器上恢复提交/回滚中的数据； • MySQL 事务块内，SQL 执行出现异常，执行 Commit，数据保持一致； • 配置 XA 事务后，存储单元名称最大长度不超过 45 个字符。 BASE 事务 不支持项 • 不支持隔离级别。 8.2.9 附录 不支持的 SQL： • 事务中使用 DistSQL 里的 RAL、RDL 操作； • XA 事务中使用 DDL 语句。 支持项 • 将外围数据迁移至 Apache ShardingSphere 所管理的数据库； • 目标端 proxy 不配置规则或配置任意规则； • 迁移单字段主键或唯一键的表，首字段类型：整型、字符型、部分二进制类型（比如 MySQL VARBINARY）； • 迁移复合主键或复合唯一键的表。 8.6. 数据迁移 41 Apache ShardingSphere document 不支持项 • 配置：数据脱敏 • 开发者指南：数据脱敏 8.8.6 核心概念 逻辑列 用于计算脱敏列的逻辑名称，它是 SQL 中列的逻辑标识。 8.8.7 使用限制 • 脱敏列只支持字符串类型，不支持其他非字符串类型。 8.9 影子库 8.9.1 背景 在基于微服务的分布式应用架构下，业务需要多个服务是通过一系列的服务、中间件的调用来完成，所 以单个服务的压力测试已无法代表真实场景。在

以有效地将规则配置一同存放，更加易于浏览与存储。 行表达式作为字符串由两部分组成，分别是字符串开头的对应 SPI 实现的 Type Name 部分和表达式部 分。以 t_order_${1..3} 为例，字符串 部分的子字符串 GROOVY 为此行表达式 使用的对应 SPI 实现的 Type Name，其被 <> 符号包裹来识别。而字符串 t_order_${1..3} 为此行表 服务宕机后，在其它机器上恢复提交/回滚中的数据； • MySQL 事务块内，SQL 执行出现异常，执行 Commit，数据保持一致； • 配置 XA 事务后，存储单元名称最大长度不超过 45 个字符。 BASE 事务 不支持项 • 不支持隔离级别。 8.2.9 附录 不支持的 SQL： • 事务中使用 DistSQL 里的 RAL、RDL 操作； • XA 事务中使用 DDL 语句。 支持项 • 将外围数据迁移至 Apache ShardingSphere 所管理的数据库； • 目标端 proxy 不配置规则或配置任意规则； • 迁移单字段主键或唯一键的表，首字段类型：整型、字符型、部分二进制类型（比如 MySQL VARBINARY）； • 迁移复合主键或复合唯一键的表。 8.6. 数据迁移 41 Apache ShardingSphere document 不支持项

尽量多的兼容各种数据库，让用户零使用成本，是 Apache ShardingSphere 数据库兼容度希望达成的主 要目标。 4.1.4 SQL 解析 SQL 是使用者与数据库交流的标准语言。SQL 解析引擎负责将 SQL 字符串解析为抽象语法树，供 Apache ShardingSphere 理解并实现其增量功能。 目前支持 MySQL, PostgreSQL, SQLServer, Oracle, openGauss 种类型影子算法。由于影子算法和业务实现紧密相关，因此并未提供默认的影子算法。 • 列影子算法 对应 ColumnShadowAlgorithm，适用于用户压测过程中，对压测执行链路上执行的 SQL 涉及的某个字 段的值满足一定匹配条件的场景。 优点：用户只需要控制流量数据不需要修改代码和 SQL 就可以完成测试。 不足：仅支持 DML 语句 • 注解影子算法 对应 NoteShadowAlgorithm，适用于用户压测过程中，对压测执行链路上执行的 的值的场景。 优点：用户可以不确定链路上执行 SQL 细节，只要知道那个 SQL 执行即可。 不足：用户需要改代码或者 SQL 默认影子算法 默认影子算法，选配项。对于没有配置影子算法表的默认匹配算法。 注意：默认影子算法仅支持注解影子算法。 4.8.5 使用规范 影子数据库 支持项 • 后端数据库为 MySQL、Oracle、PostgreSQL、SQLServer； 4.8.