tbl_name WHERE col3 = ?（SELECT 子 句不支持 * 和内置分布式主键生成器） • SELECT MAX(tbl_name.col1) FROM tbl_name（查询列是函数表达式时，查询列前不能使用表名， 可以使用表别名） 其他： • 分片规则中配置的真实表、分片列和分布式序列需要和数据库中的列保持大小写一致。 8.2 分布式事务 8.2.1 背景 数据库事务需要满足 埋点，以及日志输出功能。需要开启 Agent 的 插件功能后，才能将监控指标数据输出至第三方 APM 中展示。 APM APM 是应用性能监控的缩写。着眼于分布式系统的性能诊断，其主要功能包括调用链展示，应用拓扑分 析等。 Tracing 链路跟踪，通过探针收集调用链数据，并发送到第三方 APM 系统。 Metrics 系统统计指标，通过探针收集，供第三方应用展示。 Logging 日志，通过 Agent commit() 和 rollback() 方法，这是被允许的。 2. 在函数上使用 Jakarta EE 8 的 javax.transaction.Transactional 注解，这是被允许的。 9.1. ShardingSphere-JDBC 130 Apache ShardingSphere document 3. 在函数上使用 Jakarta EE 9/10 的 jakarta.transaction

tbl_name WHERE col3 = ?（SELECT 子 句不支持 * 和内置分布式主键生成器） • SELECT MAX(tbl_name.col1) FROM tbl_name（查询列是函数表达式时，查询列前不能使用表名， 可以使用表别名） 其他： • 分片规则中配置的真实表、分片列和分布式序列需要和数据库中的列保持大小写一致。 8.2 分布式事务 8.2.1 背景 数据库事务需要满足 埋点，以及日志输出功能。需要开启 Agent 的 插件功能后，才能将监控指标数据输出至第三方 APM 中展示。 APM APM 是应用性能监控的缩写。着眼于分布式系统的性能诊断，其主要功能包括调用链展示，应用拓扑分 析等。 8.10. 可观察性 49 Apache ShardingSphere document Tracing 链路跟踪，通过探针收集调用链数据，并发送到第三方 APM 系统。 Metrics 进行检索，并安装到 ShardingSphere 中。 9.1.5 不支持项 DataSource 接口 • 不支持 timeout 相关操作。 Connection 接口 • 不支持存储过程，函数，游标的操作； • 不支持执行 native SQL； • 不支持 savepoint 相关操作； • 不支持 Schema/Catalog 的操作； • 不支持自定义类型映射。 Statement

tbl_name WHERE col3 = ?（SELECT 子 句不支持 * 和内置分布式主键生成器） • SELECT MAX(tbl_name.col1) FROM tbl_name（查询列是函数表达式时，查询列前不能使用表名， 可以使用表别名） 3.2 分布式事务 3.2.1 背景 数据库事务需要满足 ACID（原子性、一致性、隔离性、持久性）四个特性。 • 原子性（Atomic 可观察性 47 Apache ShardingSphere document, v5.2.0 APM APM 是应用性能监控的缩写。着眼于分布式系统的性能诊断，其主要功能包括调用链展示，应用拓扑分 析等。 Tracing 链路跟踪，通过探针收集调用链数据，并发送到第三方 APM 系统。 Metrics 系统统计指标，通过探针收集，并且写入到时序数据库，供第三方应用展示。 Logging conf 和 registry.conf 文件。 4.1.6 不支持项 DataSource 接口 • 不支持 timeout 相关操作。 Connection 接口 • 不支持存储过程，函数，游标的操作； • 不支持执行 native SQL； • 不支持 savepoint 相关操作； • 不支持 Schema/Catalog 的操作； • 不支持自定义类型映射。 Statement

tbl_name WHERE col3 = ?（SELECT 子 句不支持 * 和内置分布式主键生成器） • SELECT MAX(tbl_name.col1) FROM tbl_name（查询列是函数表达式时，查询列前不能使用表名， 可以使用表别名） 其他： • 分片规则中配置的真实表、分片列和分布式序列需要和数据库中的列保持大小写一致。 8.2 分布式事务 8.2.1 背景 数据库事务需要满足 埋点，以及日志输出功能。需要开启 Agent 的 插件功能后，才能将监控指标数据输出至第三方 APM 中展示。 APM APM 是应用性能监控的缩写。着眼于分布式系统的性能诊断，其主要功能包括调用链展示，应用拓扑分 析等。 8.10. 可观察性 49 Apache ShardingSphere document Tracing 链路跟踪，通过探针收集调用链数据，并发送到第三方 APM 系统。 Metrics ider， 使用 JooQ 的 SQL 翻译器 9.1.5 不支持项 DataSource 接口 • 不支持 timeout 相关操作。 Connection 接口 • 不支持存储过程，函数，游标的操作； • 不支持执行 native SQL； • 不支持 savepoint 相关操作； • 不支持 Schema/Catalog 的操作； • 不支持自定义类型映射。 Statement

tbl_name WHERE col3 = ? SELECT 子句不支持 * 和内置分 布式主键生成器 无 SELECT MAX(tbl_name.col1) FROM tbl_name 查询列是函数表达式时，查询列 前不能使用表名 使用表 别名 分页 完全支持 MySQL、PostgreSQL 和 Oracle 的分页查询，SQLServer 由于分页查询较为复杂，仅部分支持。 4 可观察性 62 Apache ShardingSphere document, v5.1.2 APM APM 是应用性能监控的缩写。着眼于分布式系统的性能诊断，其主要功能包括调用链展示，应用拓扑分 析等。 Tracing 链路跟踪，通过探针收集调用链数据，并发送到第三方 APM 系统。 Metrics 系统统计指标，通过探针收集，并且写入到时序数据库，供第三方应用展示。 4.10.5 使用规范 uteSQL/: 表示执行 SQL 异常的日志。 5.1.9 不支持项 DataSource 接口 • 不支持 timeout 相关操作。 Connection 接口 • 不支持存储过程，函数，游标的操作； • 不支持执行 native SQL； • 不支持 savepoint 相关操作； • 不支持 Schema/Catalog 的操作； • 不支持自定义类型映射。 5.1.

tbl_name WHERE col3 = ? SELECT 子句不支持 * 和内置分 布式主键生成器 无 SELECT MAX(tbl_name.col1) FROM tbl_name 查询列是函数表达式时，查询列 前不能使用表名 使用表 别名 分页 完全支持 MySQL、PostgreSQL 和 Oracle 的分页查询，SQLServer 由于分页查询较为复杂，仅部分支持。 4 埋点，以及日志输出功能。需要开启代理的插 件功能后，才能将监控指标数据输出至第三方 APM 中展示。 APM APM 是应用性能监控的缩写。着眼于分布式系统的性能诊断，其主要功能包括调用链展示，应用拓扑分 析等。 Tracing 链路跟踪，通过探针收集调用链数据，并发送到第三方 APM 系统。 Metrics 系统统计指标，通过探针收集，并且写入到时序数据库，供第三方应用展示。 4.10.5 使用规范 uteSQL/: 表示执行 SQL 异常的日志。 5.1.8 不支持项 DataSource 接口 • 不支持 timeout 相关操作。 Connection 接口 • 不支持存储过程，函数，游标的操作； • 不支持执行 native SQL； • 不支持 savepoint 相关操作； • 不支持 Schema/Catalog 的操作； • 不支持自定义类型映射。 5.1.

tbl_name WHERE col3 = ? SELECT 子句不支持 * 和内置分 布式主键生成器 无 SELECT MAX(tbl_name.col1) FROM tbl_name 查询列是函数表达式时，查询列 前不能使用表名 使用表 别名 分页 完全支持 MySQL、PostgreSQL 和 Oracle 的分页查询，SQLServer 由于分页查询较为复杂，仅部分支持。 4 埋点，以及日志输出功能。需要开启代理的插 件功能后，才能将监控指标数据输出至第三方 APM 中展示。 APM APM 是应用性能监控的缩写。着眼于分布式系统的性能诊断，其主要功能包括调用链展示，应用拓扑分 析等。 Tracing 链路跟踪，通过探针收集调用链数据，并发送到第三方 APM 系统。 4.10. 可观察性 60 Apache ShardingSphere document, v5.1.0 cuteSQL/: 表示执行 SQL 异常的日志。 5.1.8 不支持项 DataSource 接口 • 不支持 timeout 相关操作 Connection 接口 • 不支持存储过程，函数，游标的操作 • 不支持执行 native SQL • 不支持 savepoint 相关操作 • 不支持 Schema/Catalog 的操作 • 不支持自定义类型映射 5.1. ShardingSphere-JDBC

解析 分为词法解析和语法解析。先通过词法解析器将 SQL 拆分为一个个不可再分的单词。再使用语法解析器 对 SQL 进行理解，并最终提炼出解析上下文。解析上下文包括表、选择项、排序项、分组项、聚合函数、 分页信息、查询条件以及可能需要修改的占位符的标记。 执行器优化 合并和优化分片条件，如 OR 等。 SQL 路由 根据解析上下文匹配用户配置的分片策略，并生成路由路径。目前支持分片路由和广播路由。 异同，在解析模块提供了各类数据库的 SQL 方言字典。 SQL 解析引擎 历史 SQL 解析作为分库分表类产品的核心，其性能和兼容性是最重要的衡量指标。ShardingSphere 的 SQL 解 析器经历了 3 代产品的更新迭代。 第一代 SQL 解析器为了追求性能与快速实现，在 1.4.x 之前的版本使用 Druid 作为 SQL 解析器。经实际 测试，它的性能远超其它解析器。 第二代 SQL 满足直接路由的条件相对苛刻，它需要通过 Hint（使用 HintAPI 直接指定路由至库表）方式分片，并且 是只分库不分表的前提下，则可以避免 SQL 解析和之后的结果归并。因此它的兼容性最好，可以执行包 括子查询、自定义函数等复杂情况的任意 SQL。直接路由还可以用于分片键不在 SQL 中的场景。例如，设 置用于数据库分片的键为 3， hintManager.setDatabaseShardingValue(3);

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 解析 分为词法解析和语法解析。先通过词法解析器将 SQL 拆分为一个个不可再分的单词。再使用语法解析器 对 SQL 进行理解，并最终提炼出解析上下文。解析上下文包括表、选择项、排序项、分组项、聚合函数、 分页信息、查询条件以及可能需要修改的占位符的标记。 7.1. 数据分片 224 Apache ShardingSphere document, v5.0.0 7.1.2 SQL 路由

合 使 用 产 品 架 构 部 署 架 构 l ShardingSphere-JDBC 采用无中心化架 构，与应用程序共享资源，适用于 Java 开发的高性能的轻量级 OLTP 应用； l ShardingSphere-Proxy 提供静态入口 以及异构语言的支持，独立于应用程序 部署，适用于 OLAP 应用以及对分片数 据库进行管理和运维的场景。 整 体 架 构 l L1 内核层：面向数据库内核， 包括数据库事务引擎，查询优 化器等； l L2 功能层：可定制化开发平 台。具有高定制化、高度内 聚、灵活扩展等特点； l L3 生态层：通过三个接口分别 实现数据库协议、 SQL 方言和 数据库存储对接，用于打造异 构数据网关； 连接 连接是 ShardingSphere 的基础能 力，可以有效简化数据和应用之间 的连接。连接的设计要点在于强大 的数据库的兼容性，在应用和数据 之间搭建了一层与具体数据库实现 ShardingSphere 的设计 理念，架构内核是完全面向顶层接 口设计的，内核模块完全不感知具 体功能的存在。它为分库分表、读 写分离等每一个功能插件赋予单独 部署和协同配合的能力。 整 体 架 构 内 核 架 构 l ShardingSphere 可插拔架构提供了 数十个基于 SPI 的扩展点，开发者可 以十分方便的对功能进行定制化扩展； l 按照扩展点是基于技术还是基于功能 实现，可以将扩展点划分为功能扩展