隔离，互无感知，多 组件可通过叠加的方式相互配合使用。主要包括数据分片、读写分离、数据库高可用、数据加密、影子库 等。用户自定义功能可完全面向 Apache ShardingSphere 定义的顶层接口进行定制化扩展，而无需改动 内核代码。 L3 生态层 用于对接和融入现有数据库生态，包括数据库协议、SQL 解析器和存储适配器，分别对应于 Apache Shard‐ ingSphere tbl_name WHERE col3 = ? SELECT 子句不支持 * 和内置分 布式主键生成器 无 SELECT MAX(tbl_name.col1) FROM tbl_name 查询列是函数表达式时，查询列 前不能使用表名 使用表 别名 分页 完全支持 MySQL、PostgreSQL 和 Oracle 的分页查询，SQLServer 由于分页查询较为复杂，仅部分支持。 分页性能 相关操作 5.1. ShardingSphere-JDBC 157 Apache ShardingSphere document, v5.0.0 Connection 接口 • 不支持存储过程，函数，游标的操作 • 不支持执行 native SQL • 不支持 savepoint 相关操作 • 不支持 Schema/Catalog 的操作 • 不支持自定义类型映射 Statement

隔离，互无感知，多 组件可通过叠加的方式相互配合使用。主要包括数据分片、读写分离、数据库高可用、数据加密、影子库 等。用户自定义功能可完全面向 Apache ShardingSphere 定义的顶层接口进行定制化扩展，而无需改动 内核代码。 L3 生态层 用于对接和融入现有数据库生态，包括数据库协议、SQL 解析器和存储适配器，分别对应于 Apache Shard‐ ingSphere tbl_name WHERE col3 = ? SELECT 子句不支持 * 和内置分 布式主键生成器 无 SELECT MAX(tbl_name.col1) FROM tbl_name 查询列是函数表达式时，查询列 前不能使用表名 使用表 别名 分页 完全支持 MySQL、PostgreSQL 和 Oracle 的分页查询，SQLServer 由于分页查询较为复杂，仅部分支持。 4 uteSQL/: 表示执行 SQL 异常的日志。 5.1.8 不支持项 DataSource 接口 • 不支持 timeout 相关操作。 Connection 接口 • 不支持存储过程，函数，游标的操作； • 不支持执行 native SQL； • 不支持 savepoint 相关操作； • 不支持 Schema/Catalog 的操作； • 不支持自定义类型映射。 5.1.

隔离，互无感知，多 组件可通过叠加的方式相互配合使用。主要包括数据分片、读写分离、数据库高可用、数据加密、影子库 等。用户自定义功能可完全面向 Apache ShardingSphere 定义的顶层接口进行定制化扩展，而无需改动 内核代码。 L3 生态层 用于对接和融入现有数据库生态，包括数据库协议、SQL 解析器和存储适配器，分别对应于 Apache Shard‐ ingSphere tbl_name WHERE col3 = ? SELECT 子句不支持 * 和内置分 布式主键生成器 无 SELECT MAX(tbl_name.col1) FROM tbl_name 查询列是函数表达式时，查询列 前不能使用表名 使用表 别名 分页 完全支持 MySQL、PostgreSQL 和 Oracle 的分页查询，SQLServer 由于分页查询较为复杂，仅部分支持。 4 cuteSQL/: 表示执行 SQL 异常的日志。 5.1.8 不支持项 DataSource 接口 • 不支持 timeout 相关操作 Connection 接口 • 不支持存储过程，函数，游标的操作 • 不支持执行 native SQL • 不支持 savepoint 相关操作 • 不支持 Schema/Catalog 的操作 • 不支持自定义类型映射 5.1. ShardingSphere-JDBC

。组件之间完全隔离，互无感知，多 组件可通过叠加的方式相互配合使用。主要包括数据分片、读写分离、数据加密、影子库等。用户自定义 功能可完全面向 Apache ShardingSphere 定义的顶层接口进行定制化扩展，而无需改动内核代码。 2.3.3 L3 生态层 用于对接和融入现有数据库生态，包括数据库协议、SQL 解析器和存储适配器，分别对应于 Apache Shard‐ ingSphere tbl_name WHERE col3 = ?（SELECT 子 句不支持 * 和内置分布式主键生成器） • SELECT MAX(tbl_name.col1) FROM tbl_name（查询列是函数表达式时，查询列前不能使用表名， 可以使用表别名） 其他： • 分片规则中配置的真实表、分片列和分布式序列需要和数据库中的列保持大小写一致。 8.2 分布式事务 8.2.1 背景 数据库事务需要满足 commit() 和 rollback() 方法，这是被允许的。 2. 在函数上使用 Jakarta EE 8 的 javax.transaction.Transactional 注解，这是被允许的。 9.1. ShardingSphere-JDBC 130 Apache ShardingSphere document 3. 在函数上使用 Jakarta EE 9/10 的 jakarta.transaction

隔离，互无感知，多 组件可通过叠加的方式相互配合使用。主要包括数据分片、读写分离、数据库高可用、数据加密、影子库 等。用户自定义功能可完全面向 Apache ShardingSphere 定义的顶层接口进行定制化扩展，而无需改动 内核代码。 1.2. 设计哲学 5 Apache ShardingSphere document, v5.2.0 L3 生态层 用于对接和融入现有数据库生态，包括数据库协议、SQL tbl_name WHERE col3 = ?（SELECT 子 句不支持 * 和内置分布式主键生成器） • SELECT MAX(tbl_name.col1) FROM tbl_name（查询列是函数表达式时，查询列前不能使用表名， 可以使用表别名） 3.2 分布式事务 3.2.1 背景 数据库事务需要满足 ACID（原子性、一致性、隔离性、持久性）四个特性。 • 原子性（Atomic conf 和 registry.conf 文件。 4.1.6 不支持项 DataSource 接口 • 不支持 timeout 相关操作。 Connection 接口 • 不支持存储过程，函数，游标的操作； • 不支持执行 native SQL； • 不支持 savepoint 相关操作； • 不支持 Schema/Catalog 的操作； • 不支持自定义类型映射。 Statement

。组件之间完全隔离，互无感知，多 组件可通过叠加的方式相互配合使用。主要包括数据分片、读写分离、数据加密、影子库等。用户自定义 功能可完全面向 Apache ShardingSphere 定义的顶层接口进行定制化扩展，而无需改动内核代码。 2.3.3 L3 生态层 用于对接和融入现有数据库生态，包括数据库协议、SQL 解析器和存储适配器，分别对应于 Apache Shard‐ ingSphere tbl_name WHERE col3 = ?（SELECT 子 句不支持 * 和内置分布式主键生成器） • SELECT MAX(tbl_name.col1) FROM tbl_name（查询列是函数表达式时，查询列前不能使用表名， 可以使用表别名） 其他： • 分片规则中配置的真实表、分片列和分布式序列需要和数据库中的列保持大小写一致。 8.2 分布式事务 8.2.1 背景 数据库事务需要满足 进行检索，并安装到 ShardingSphere 中。 9.1.5 不支持项 DataSource 接口 • 不支持 timeout 相关操作。 Connection 接口 • 不支持存储过程，函数，游标的操作； • 不支持执行 native SQL； • 不支持 savepoint 相关操作； • 不支持 Schema/Catalog 的操作； • 不支持自定义类型映射。 Statement

。组件之间完全隔离，互无感知，多 组件可通过叠加的方式相互配合使用。主要包括数据分片、读写分离、数据加密、影子库等。用户自定义 功能可完全面向 Apache ShardingSphere 定义的顶层接口进行定制化扩展，而无需改动内核代码。 2.3.3 L3 生态层 用于对接和融入现有数据库生态，包括数据库协议、SQL 解析器和存储适配器，分别对应于 Apache Shard‐ ingSphere tbl_name WHERE col3 = ?（SELECT 子 句不支持 * 和内置分布式主键生成器） • SELECT MAX(tbl_name.col1) FROM tbl_name（查询列是函数表达式时，查询列前不能使用表名， 可以使用表别名） 其他： • 分片规则中配置的真实表、分片列和分布式序列需要和数据库中的列保持大小写一致。 8.2 分布式事务 8.2.1 背景 数据库事务需要满足 ider， 使用 JooQ 的 SQL 翻译器 9.1.5 不支持项 DataSource 接口 • 不支持 timeout 相关操作。 Connection 接口 • 不支持存储过程，函数，游标的操作； • 不支持执行 native SQL； • 不支持 savepoint 相关操作； • 不支持 Schema/Catalog 的操作； • 不支持自定义类型映射。 Statement

隔离，互无感知，多 组件可通过叠加的方式相互配合使用。主要包括数据分片、读写分离、数据库高可用、数据加密、影子库 等。用户自定义功能可完全面向 Apache ShardingSphere 定义的顶层接口进行定制化扩展，而无需改动 内核代码。 L3 生态层 用于对接和融入现有数据库生态，包括数据库协议、SQL 解析器和存储适配器，分别对应于 Apache Shard‐ ingSphere tbl_name WHERE col3 = ? SELECT 子句不支持 * 和内置分 布式主键生成器 无 SELECT MAX(tbl_name.col1) FROM tbl_name 查询列是函数表达式时，查询列 前不能使用表名 使用表 别名 分页 完全支持 MySQL、PostgreSQL 和 Oracle 的分页查询，SQLServer 由于分页查询较为复杂，仅部分支持。 4 uteSQL/: 表示执行 SQL 异常的日志。 5.1.9 不支持项 DataSource 接口 • 不支持 timeout 相关操作。 Connection 接口 • 不支持存储过程，函数，游标的操作； • 不支持执行 native SQL； • 不支持 savepoint 相关操作； • 不支持 Schema/Catalog 的操作； • 不支持自定义类型映射。 5.1.

（数据加密）、流量鉴权（SQL 审 计、权限）、流量治理（熔断、限 流）以及流量分析（可观察性、服 务质量分析）等。 可插拔 可插拔是 ShardingSphere 的设计 理念，架构内核是完全面向顶层接 口设计的，内核模块完全不感知具 体功能的存在。它为分库分表、读 写分离等每一个功能插件赋予单独 部署和协同配合的能力。 整 体 架 构 内 核 架 构 l ShardingSphere

SQL语句构建器 日志 日志 XML 映射配置文件 映射配置文件 MyBatis 的配置文件包含了影响 MyBatis 行为甚深的设置（settings）和属性（properties）信息。文档的顶层结构如下： configuration 配置 properties 属性 settings 设置 typeAliases 类型命名 typeHandlers 类型处理器 objectFactory