时分库结果不正确？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 7.12 ShardingSphere 提供的默认分布式自增主键策略为什么是不连续的，且尾数大多为偶数？ 288 7.13 Windows 环境下，通过 Git 克隆 ShardingSphere 源码时为什么提示文件名过长，如何解 决？ . . . . . . . . 同级目录下生成代码，容易误提交，如何避免？ . . . . . . . . . . . . 292 viii 1 概览 星评增长时间线 贡献者增长时间线 Apache ShardingSphere 是一套开源的分布式数据库解决方案组成的生态圈，它由 JDBC、Proxy 和 Sidecar （规划中）这 3 款既能够独立部署，又支持混合部署配合使用的产品组成。它们均提供标准化的数据水平 扩展、 场景。 Apache ShardingSphere 旨在充分合理地在分布式的场景下利用关系型数据库的计算和存储能力，而并 非实现一个全新的关系型数据库。关系型数据库当今依然占有巨大市场份额，是企业核心系统的基石，未 来也难于撼动，我们更加注重在原有基础上提供增量，而非颠覆。 Apache ShardingSphere 5.x 版本开始致力于可插拔架构，项目的功能组件能够灵活的以可插拔的方式

Apache ShardingSphere document Apache ShardingSphere 2024 年 07 月 10 日 Contents 1 什么是 ShardingSphere 1 1.1 介绍 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ClassCastException: Integer can not cast to Long 异常。 . . . . 534 13.3.6 分片 ShardingSphere 提供的默认分布式自增主键策略为什么是不连续的，且尾数 大多为偶数？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535 13.3.7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542 xiii 1 什么是 ShardingSphere 1.1 介绍 Apache ShardingSphere 是一款分布式的数据库生态系统，可以将任意数据库转换为分布式数据库，并 通过数据分片、弹性伸缩、加密等能力对原有数据库进行增强。 Apache ShardingSphere

ClassCastException: Integer can not cast to Long? . . . . . . 290 7.7.12 12. [分片] ShardingSphere 提供的默认分布式自增主键策略为什么是不连续的，且 尾数大多为偶数？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 7.7.13 13. . . . . . . . . . . . . . . . . 291 7.7.14 14. [分片] 为什么我实现了 KeyGenerateAlgorithm 接口，也配置了 Type，但 是自定义的分布式主键依然不生效？ . . . . . . . . . . . . . . . . . . . . . . . . 291 7.7.15 15. [分片] ShardingSphere 生态。它关 注如何充分合理地利用数据库的计算和存储能力，而并非实现一个全新的数据库。ShardingSphere 站在 数据库的上层视角，关注他们之间的协作多于数据库自身。 连接、增量和可插拔是 Apache ShardingSphere 的核心概念。 • 连接：通过对数据库协议、SQL 方言以及数据库存储的灵活适配，快速的连接应用与多模式的异构 数据库； • 增量：获取数据库的访问流

ClassCastException: Integer can not cast to Long 异常。 . . . . 307 7.8.13 [分片] ShardingSphere 提供的默认分布式自增主键策略为什么是不连续的，且尾 数大多为偶数？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307 7.8.14 [分片] 态。它关 注如何充分合理地利用数据库的计算和存储能力，而并非实现一个全新的数据库。ShardingSphere 站在 数据库的上层视角，关注他们之间的协作多于数据库自身。 连接、增量和 可插拔是 Apache ShardingSphere 的核心概念。 • 连接：通过对数据库协议、SQL 方言以及数据库存储的灵活适配，快速的连接应用与多模式的异构 数据库； • 增量：获取数据库的访问流 款既能够独立部署，又支持混合部署 配合使用的产品组成。它们均提供标准化的基于数据库作为存储节点的增量功能，可适用于如 Java 同构、 异构语言、云原生等各种多样化的应用场景。 关系型数据库当今依然占有巨大市场份额，是企业核心系统的基石，未来也难于撼动，我们更加注重在 原有基础上提供增量，而非颠覆。 1 Apache ShardingSphere document, v5.1.1 1.1.1 ShardingSphere-JDBC

ClassCastException: Integer can not cast to Long 异常。 . . . . 303 7.8.13 [分片] ShardingSphere 提供的默认分布式自增主键策略为什么是不连续的，且尾 数大多为偶数？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303 7.8.14 [分片] 生态。它关 注如何充分合理地利用数据库的计算和存储能力，而并非实现一个全新的数据库。ShardingSphere 站在 数据库的上层视角，关注他们之间的协作多于数据库自身。 连接、增量和可插拔是 Apache ShardingSphere 的核心概念。 • 连接：通过对数据库协议、SQL 方言以及数据库存储的灵活适配，快速的连接应用与多模式的异构 数据库； • 增量：获取数据库的访问流 款既能够独立部署，又支持混合部署 配合使用的产品组成。它们均提供标准化的基于数据库作为存储节点的增量功能，可适用于如 Java 同构、 异构语言、云原生等各种多样化的应用场景。 关系型数据库当今依然占有巨大市场份额，是企业核心系统的基石，未来也难于撼动，我们更加注重在 原有基础上提供增量，而非颠覆。 1 Apache ShardingSphere document, v5.1.0 1.1.1 ShardingSphere-JDBC

ClassCastException: Integer can not cast to Long 异常。 . . . . 318 7.8.13 [分片] ShardingSphere 提供的默认分布式自增主键策略为什么是不连续的，且尾 数大多为偶数？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 7.8.14 [分片] 态。它关 注如何充分合理地利用数据库的计算和存储能力，而并非实现一个全新的数据库。ShardingSphere 站在 数据库的上层视角，关注他们之间的协作多于数据库自身。 连接、增量和 可插拔是 Apache ShardingSphere 的核心概念。 • 连接：通过对数据库协议、SQL 方言以及数据库存储的灵活适配，快速的连接应用与多模式的异构 数据库； • 增量：获取数据库的访问流 款既能够独立部署，又支持混合部署 配合使用的产品组成。它们均提供标准化的基于数据库作为存储节点的增量功能，可适用于如 Java 同构、 异构语言、云原生等各种多样化的应用场景。 关系型数据库当今依然占有巨大市场份额，是企业核心系统的基石，未来也难于撼动，我们更加注重在 原有基础上提供增量，而非颠覆。 1 Apache ShardingSphere document, v5.1.2 1.1.1 ShardingSphere-JDBC

Apache ShardingSphere document Apache ShardingSphere 2023 年 12 月 26 日 Contents 1 什么是 ShardingSphere 1 1.1 介绍 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ClassCastException: Integer can not cast to Long 异常。 . . . . 509 13.4.6 分片 ShardingSphere 提供的默认分布式自增主键策略为什么是不连续的，且尾数 大多为偶数？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509 13.4.7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515 xiii 1 什么是 ShardingSphere 1.1 介绍 Apache ShardingSphere 是一款分布式的数据库生态系统，可以将任意数据库转换为分布式数据库，并 通过数据分片、弹性伸缩、加密等能力对原有数据库进行增强。 Apache ShardingSphere

Apache ShardingSphere document Apache ShardingSphere 2023 年 08 月 11 日 Contents 1 什么是 ShardingSphere 1 1.1 介绍 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ClassCastException: Integer can not cast to Long 异常。 . . . . 488 13.4.6 分片 ShardingSphere 提供的默认分布式自增主键策略为什么是不连续的，且尾数 大多为偶数？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488 13.4.7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494 xii 1 什么是 ShardingSphere 1.1 介绍 Apache ShardingSphere 是一款分布式的数据库生态系统，可以将任意数据库转换为分布式数据库，并 通过数据分片、弹性伸缩、加密等能力对原有数据库进行增强。 Apache ShardingSphere

Apache ShardingSphere document v5.2.0 Apache ShardingSphere 2022 年 09 月 08日 Contents 1 概览 1 1.1 什么是 ShardingSphere . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.1.1 介绍 . ClassCastException: Integer can not cast to Long 异常。 . . . . 424 8.3.6 分片 ShardingSphere 提供的默认分布式自增主键策略为什么是不连续的，且尾数 大多为偶数？ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424 8.3.7 分片如何在 1 概览 本章介绍 Apache ShardingSphere 的定义，设计哲学和部署形态。 更多常见问题，请参考 FAQ。 1.1 什么是 ShardingSphere 1.1.1 介绍 Apache ShardingSphere 是一款开源的分布式数据库生态项目，由 JDBC 和 Proxy 两款产品组成。其核心 采用微内核 + 可插拔架构，通过插件开放扩展功能。它提供多源异构数据库增强平台，进而围绕其上层

1 Sharding-JDBC 概览 1.1 认识ShardingSphere ShardingSphere是一套开源的分布式数据库中间件解决方案组成的生态圈，它由Sharding- JDBC、Sharding-Proxy和Sharding-Sidecar（计划中）这3款相互独立的产品组成。 他们均提 供标准化的数据分片、分布式事务和数据库治理功能，可适用于如Java同构、异构语言、容 Sharding-Proxy Sharding-Sidecar 数据库 任意 MySQL MySQL 连接消耗数 高 低 高 异构语言 仅Java 任意 任意 性能 损耗低 损耗略高 损耗低 无中心化 是 否 是 静态入口 无 有 无 适用于任何兼容MySQL协议的客户端。 1.4 三个组件对比认识 1.5 混合架构 Sharding-JDBC采用无中心化架构，适用于Java开发的 高性能的轻量级OLTP应用；Sharding- Proxy提供静态入口以及异构语言的支持，适用于OLAP应用以及对分片数据库进行管理和运维 的场景。 ShardingSphere是多接入端共同组成的生态圈。 通过混合使用Sharding-JDBC和Sharding- Proxy，并采用同一注册中心统一配置分片策略，能够灵活的搭建适用于各种场景的应用系 统，架构师可以更加自由的调整适合于当前业务的最佳系统架构。