16 L1 内核层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 L2 功能层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 L3 生态层 . . . . . 异构 数据库； • 增量：获取数据库的访问流量，并提供流量重定向（数据分片、读写分离、影子库）、流量变形（数 据加密、数据脱敏）、流量鉴权（安全、审计、权限）、流量治理（熔断、限流）以及流量分析（服 务质量分析、可观察性）等透明化增量功能； • 可插拔：项目采用微内核 + 三层可插拔模型，使内核、功能组件以及生态对接完全能够灵活的方式 进行插拔式扩展，开发者能够像使用积木一样定制属于自己的独特系统。 1 Apache ShardingSphere document, v5.0.0 1.1.1 ShardingSphere-JDBC 定位为轻量级 Java 框架，在 Java 的 JDBC 层提供的额外服务。它使用客户端直连数据库，以 jar 包形式 提供服务，无需额外部署和依赖，可理解为增强版的 JDBC 驱动，完全兼容 JDBC 和各种 ORM 框架。 • 适用于任何基于 JDBC

16 L1 内核层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 L2 功能层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 L3 生态层 . . . . . Integer can not cast to Long 异常。 . . . . 303 7.8.13 [分片] ShardingSphere 提供的默认分布式自增主键策略为什么是不连续的，且尾 数大多为偶数？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303 7.8.14 [分片] 如何在 inline 异构 数据库； • 增量：获取数据库的访问流量，并提供流量重定向（数据分片、读写分离、影子库）、流量变形（数 据加密、数据脱敏）、流量鉴权（安全、审计、权限）、流量治理（熔断、限流）以及流量分析（服 务质量分析、可观察性）等透明化增量功能； • 可插拔：项目采用微内核 + 三层可插拔模型，使内核、功能组件以及生态对接完全能够灵活的方式 进行插拔式扩展，开发者能够像使用积木一样定制属于自己的独特系统。

16 L1 内核层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 L2 功能层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 L3 生态层 . . . . . Integer can not cast to Long 异常。 . . . . 307 7.8.13 [分片] ShardingSphere 提供的默认分布式自增主键策略为什么是不连续的，且尾 数大多为偶数？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307 7.8.14 [分片] 如何在 inline 异构 数据库； • 增量：获取数据库的访问流量，并提供流量重定向（数据分片、读写分离、影子库）、流量变形（数 据加密、数据脱敏）、流量鉴权（安全、审计、权限）、流量治理（熔断、限流）以及流量分析（服 务质量分析、可观察性）等透明化增量功能； • 可插拔：项目采用微内核 + 三层可插拔模型，使内核、功能组件以及生态对接完全能够灵活的方式 进行插拔式扩展，开发者能够像使用积木一样定制属于自己的独特系统。

16 L1 内核层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 L2 功能层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 L3 生态层 . . . . . Integer can not cast to Long 异常。 . . . . 318 7.8.13 [分片] ShardingSphere 提供的默认分布式自增主键策略为什么是不连续的，且尾 数大多为偶数？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 7.8.14 [分片] 如何在 inline . . . . . . . . . . . . . . . . 325 7.8.31 [ShardingSphere‐JDBC] Oracle 表名、字段名配置大小写在加载 metadata 元数 据时结果不正确？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 7.9 API 变更历史 . .

表 中 间 件 分 布 式 数 据 库 生 态 系 统 功能 提 供 基 础 功 能 提 供 基 础 设 施 和 最 佳 实 践 驱动方式 配 置 文 件 标 准 D i s t S Q L 耦合 耦合较大，存在功能依赖 相 互 隔 离 ， 互 无 感 知 组合方式 固 定 的 组 合 方 式 ： 以 数 据 分 片 为 基 础 ， 叠 加 读 写 分 离 和 数 据 加 密 等 功 能 自 自 由 的 组 合 方 式 ： 数 据 分 片 、 读 写 分 离 和 数 据 加 密 等 功 能 自 由 组 合 使 用 产 品 架 构 部 署 架 构 l ShardingSphere-JDBC 采用无中心化架 构，与应用程序共享资源，适用于 Java 开发的高性能的轻量级 OLTP 应用； l ShardingSphere-Proxy 提供静态入口 以及异构语言的支持，独立于应用程序 以及异构语言的支持，独立于应用程序 部署，适用于 OLAP 应用以及对分片数 据库进行管理和运维的场景。 整 体 架 构 l L1 内核层：面向数据库内核， 包括数据库事务引擎，查询优 化器等； l L2 功能层：可定制化开发平 台。具有高定制化、高度内 聚、灵活扩展等特点； l L3 生态层：通过三个接口分别 实现数据库协议、 SQL 方言和 数据库存储对接，用于打造异 构数据网关； 连接 连接是 ShardingSphere

. 5 L1 内核层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 L2 功能层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 L3 生态层 . . . . . . Java 框架，在 Java 的 JDBC 层提供的额外服务。 ShardingSphere-Proxy ShardingSphere‐Proxy 定位为透明化的数据库代理端，通过实现数据库二进制协议，对异构语言提供支 持。 1 Apache ShardingSphere document, v5.2.0 1.1.2 产品功能 特性 定义 数 据 分片 数据分片，是应对海量数据存 计算服务访问；同时可感知并利用底层数据库自身高可用实现整体的高可用能力。 数 据 迁移 数据迁移，是打通数据生态的关键能力。SharingSphere 提供基于数据全场景的迁移能力，可 应对业务数据量激增的场景。 联 邦 查询 联邦查询，是面对复杂数据环境下利用数据的有效手段之一。ShardingSphere 提供跨数据源 的复杂数据查询分析能力，简化并提升数据使用体验。 数 据 加密 数据加密，是保证数据安全

L1 内核层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.3.2 L2 功能层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.3.3 L3 生态层 . . . ShardingSphere‐Proxy？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507 13.3.4 Proxy 使 用 第 三 方 数 据 库 工 具 连 接 ShardingSphere‐Proxy 时， 如 果 ShardingSphere‐Proxy 没有创建 Database 或者没有注册 Storage Unit，连 接失败？ 角， 关注它们之间的协作多于数据库自身。 1.1.1 ShardingSphere-JDBC ShardingSphere‐JDBC 定位为轻量级 Java 框架，在 Java 的 JDBC 层提供的额外服务。 1.1.2 ShardingSphere-Proxy ShardingSphere‐Proxy 定位为透明化的数据库代理端，通过实现数据库二进制协议，对异构语言提供支 持。 1

L1 内核层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.3.2 L2 功能层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.3.3 L3 生态层 . . . ShardingSphere‐Proxy？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 13.3.4 Proxy 使 用 第 三 方 数 据 库 工 具 连 接 ShardingSphere‐Proxy 时， 如 果 ShardingSphere‐Proxy 没有创建 Database 或者没有注册 Storage Unit，连 接失败？ 角， 关注它们之间的协作多于数据库自身。 1.1.1 ShardingSphere-JDBC ShardingSphere‐JDBC 定位为轻量级 Java 框架，在 Java 的 JDBC 层提供的额外服务。 1.1.2 ShardingSphere-Proxy ShardingSphere‐Proxy 定位为透明化的数据库代理端，通过实现数据库二进制协议，对异构语言提供支 持。 1

L1 内核层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.3.2 L2 功能层 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2.3.3 L3 生态层 . . . ShardingSphere‐Proxy？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533 13.2.4 Proxy 使 用 第 三 方 数 据 库 工 具 连 接 ShardingSphere‐Proxy 时， 如 果 ShardingSphere‐Proxy 没有创建 Database 或者没有注册 Storage Unit，连 接失败？ 角， 关注它们之间的协作多于数据库自身。 1.1.1 ShardingSphere-JDBC ShardingSphere‐JDBC 定位为轻量级 Java 框架，在 Java 的 JDBC 层提供的额外服务。 1.1.2 ShardingSphere-Proxy ShardingSphere‐Proxy 定位为透明化的数据库代理端，通过实现数据库二进制协议，对异构语言提供支 持。 1

Apache 软件基金会的顶级项目。欢迎通过邮件列表参与讨 论。 1.1 简介 1.1.1 ShardingSphere-JDBC 定位为轻量级 Java 框架，在 Java 的 JDBC 层提供的额外服务。它使用客户端直连数据库，以 jar 包形式 提供服务，无需额外部署和依赖，可理解为增强版的 JDBC 驱动，完全兼容 JDBC 和各种 ORM 框架。 • 适用于任何基于 JDBC 侵入的方案提供与数据库交互的啮合层，即 Database Mesh，又可称数据库网格。 Database Mesh 的关注重点在于如何将分布式的数据访问应用与数据库有机串联起来，它更加关注的是 交互，是将杂乱无章的应用与数据库之间的交互进行有效地梳理。使用 Database Mesh，访问数据库的 应用和数据库终将形成一个巨大的网格体系，应用和数据库只需在网格体系中对号入座即可，它们都是 被啮合层所治理的对象。 ingSphere-JDBC Shardi ngSphere-Proxy Sharding Sphere-Sidecar 数据库 任意 M ySQL/PostgreSQL M ySQL/PostgreSQL 连接消耗数 高 低 高 异构语言 仅 Java 任意 任意 性能 损耗低 损耗略高 损耗低 无中心化 是 否 是 静态入口 无 有 无 1.1.4 混合架构 ShardingSphere‐JDBC 采用