ShardingSphere介绍与使用&Springboot+ShardingJDBC实现分库分表最简Demo

傷城~ 2023-09-30 19:37 23阅读 0赞

## ShardingSphere的基本介绍 ##

#### 1、什么是shardingSphere ####

Apache ShardingSphere 是一套开源的分布式数据库中间件解决方案组成的生态圈，它由 JDBC、Proxy 和 Sidecar（规划中）这 3 款相互独立，却又能够混合部署配合使用的产品组成。 它们均提供标准化的数据分片、分布式事务和数据库治理功能，可适用于如 Java 同构、异构语言、云原生等各种多样化的应用场景。

Apache ShardingSphere 定位为关系型数据库中间件，旨在充分合理地在分布式的场景下利用关系型数据库的计算和存储能力，而并非实现一个全新的关系型数据库。 它通过关注不变，进而抓住事物本质。关系型数据库当今依然占有巨大市场，是各个公司核心业务的基石，未来也难于撼动，我们目前阶段更加关注在原有基础上的增量，而非颠覆。

Apache ShardingSphere 5.x 版本开始致力于可插拔架构，项目的功能组件能够灵活的以可插拔的方式进行扩展。 目前，数据分片、读写分离、多数据副本、数据加密、影子库压测等功能，以及 MySQL、PostgreSQL、SQLServer、Oracle 等 SQL 与协议的支持，均通过插件的方式织入项目。 开发者能够像使用积木一样定制属于自己的独特系统。Apache ShardingSphere 目前已提供数十个 SPI 作为系统的扩展点，仍在不断增加中。

ShardingSphere 已于2020年4月16日成为 Apache 软件基金会的顶级项目。

##### 1、sharding-JDCB #####

定位为轻量级Java框架，在Java的JDBC层提供的额外服务。 它使用客户端直连数据库，以jar包形式提供服务，无需额外部署和依赖，可理解为增强版的JDBC驱动，完全兼容JDBC和各种ORM框架。

*  适用于任何基于JDBC的ORM框架，如：JPA, Hibernate, Mybatis, Spring JDBC Template或直接使用JDBC。
 *  支持任何第三方的数据库连接池，如：DBCP, C3P0, BoneCP, Druid, HikariCP等。
 *  支持任意实现JDBC规范的数据库。目前支持MySQL，Oracle，SQLServer，PostgreSQL以及任何遵循SQL92标准的数据库。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3_size_16_color_FFFFFF_t_70_pic_center]

##### 2、sharding-proxy #####

定位为透明化的数据库代理端，提供封装了数据库二进制协议的服务端版本，用于完成对异构语言的支持。 目前先提供MySQL/PostgreSQL版本，它可以使用任何兼容MySQL/PostgreSQL协议的访问客户端(如：MySQL Command Client, MySQL Workbench, Navicat等)操作数据，对DBA更加友好。

*  向应用程序完全透明，可直接当做MySQL/PostgreSQL使用。
 *  适用于任何兼容MySQL/PostgreSQL协议的的客户端。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3_size_16_color_FFFFFF_t_70_pic_center 1]

##### 3、sharding-sidecar #####

定位为Kubernetes的云原生数据库代理，以Sidecar的形式代理所有对数据库的访问。 通过无中心、零侵入的方案提供与数据库交互的的啮合层，即Database Mesh，又可称数据网格。

Database Mesh的关注重点在于如何将分布式的数据访问应用与数据库有机串联起来，它更加关注的是交互，是将杂乱无章的应用与数据库之间的交互有效的梳理。使用Database Mesh，访问数据库的应用和数据库终将形成一个巨大的网格体系，应用和数据库只需在网格体系中对号入座即可，它们都是被啮合层所治理的对象。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3_size_16_color_FFFFFF_t_70_pic_center 2]

##### 4、三个组件的对比 #####

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3_size_16_color_FFFFFF_t_70_pic_center 3]

##### 5、混合架构 #####

Sharding-JDBC采用无中心化架构，适用于Java开发的高性能的轻量级OLTP应用；Sharding-Proxy提供静态入口以及异构语言的支持，适用于OLAP应用以及对分片数据库进行管理和运维的场景。

ShardingSphere是多接入端共同组成的生态圈。 通过混合使用Sharding-JDBC和Sharding-Proxy，并采用同一注册中心统一配置分片策略，能够灵活的搭建适用于各种场景的应用系统，架构师可以更加自由的调整适合于当前业务的最佳系统架构。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3_size_16_color_FFFFFF_t_70_pic_center 4]

#### 2、核心概念 ####

##### 1、逻辑表 #####

水平拆分的数据库（表）的相同逻辑和数据结构表的总称。例：订单数据根据主键尾数拆分为10张表，分别是`t_order_0`到`t_order_9`，他们的逻辑表名为`t_order`。

##### 2、真实表 #####

在分片的数据库中真实存在的物理表。即上个示例中的`t_order_0`到`t_order_9`。

##### 3、数据节点 #####

数据分片的最小单元。由数据源名称和数据表组成，例：`ds_0.t_order_0`。

##### 4、绑定表 #####

指分片规则一致的主表和子表。例如：`t_order`表和`t_order_item`表，均按照`order_id`分片，则此两张表互为绑定表关系。绑定表之间的多表关联查询不会出现笛卡尔积关联，关联查询效率将大大提升。举例说明，如果SQL为：

SELECT i.* FROM t_order o JOIN t_order_item i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);

在不配置绑定表关系时，假设分片键`order_id`将数值10路由至第0片，将数值11路由至第1片，那么路由后的SQL应该为4条，它们呈现为笛卡尔积：

SELECT i.* FROM t_order_0 o JOIN t_order_item_0 i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);
    
    SELECT i.* FROM t_order_0 o JOIN t_order_item_1 i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);
    
    SELECT i.* FROM t_order_1 o JOIN t_order_item_0 i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);
    
    SELECT i.* FROM t_order_1 o JOIN t_order_item_1 i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);

在配置绑定表关系后，路由的SQL应该为2条：

SELECT i.* FROM t_order_0 o JOIN t_order_item_0 i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);
    
    SELECT i.* FROM t_order_1 o JOIN t_order_item_1 i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);

其中`t_order`在FROM的最左侧，ShardingSphere将会以它作为整个绑定表的主表。 所有路由计算将会只使用主表的策略，那么`t_order_item`表的分片计算将会使用`t_order`的条件。故绑定表之间的分区键要完全相同。

##### 5、广播表 #####

指所有的分片数据源中都存在的表，表结构和表中的数据在每个数据库中均完全一致。适用于数据量不大且需要与海量数据的表进行关联查询的场景，例如：字典表。

##### 6、分片键 #####

用于分片的数据库字段，是将数据库(表)水平拆分的关键字段。例：将订单表中的订单主键的尾数取模分片，则订单主键为分片字段。 SQL中如果无分片字段，将执行全路由，性能较差。 除了对单分片字段的支持，ShardingSphere也支持根据多个字段进行分片。

##### 7、分片算法 #####

通过分片算法将数据分片，支持通过`=`、`>=`、`<=`、`>`、`<`、`BETWEEN`和`IN`分片。分片算法需要应用方开发者自行实现，可实现的灵活度非常高。

目前提供4种分片算法。由于分片算法和业务实现紧密相关，因此并未提供内置分片算法，而是通过分片策略将各种场景提炼出来，提供更高层级的抽象，并提供接口让应用开发者自行实现分片算法。

*  精确分片算法
    
    对应PreciseShardingAlgorithm，用于处理使用单一键作为分片键的=与IN进行分片的场景。需要配合StandardShardingStrategy使用。
 *  范围分片算法
    
    对应RangeShardingAlgorithm，用于处理使用单一键作为分片键的BETWEEN AND、>、<、>=、<=进行分片的场景。需要配合StandardShardingStrategy使用。
 *  复合分片算法
    
    对应ComplexKeysShardingAlgorithm，用于处理使用多键作为分片键进行分片的场景，包含多个分片键的逻辑较复杂，需要应用开发者自行处理其中的复杂度。需要配合ComplexShardingStrategy使用。
 *  Hint分片算法
    
    对应HintShardingAlgorithm，用于处理使用Hint行分片的场景。需要配合HintShardingStrategy使用。

##### 8、分片策略 #####

包含分片键和分片算法，由于分片算法的独立性，将其独立抽离。真正可用于分片操作的是分片键 + 分片算法，也就是分片策略。目前提供5种分片策略。

*  标准分片策略
    
    对应StandardShardingStrategy。提供对SQL语句中的=, >, <, >=, <=, IN和BETWEEN AND的分片操作支持。StandardShardingStrategy只支持单分片键，提供PreciseShardingAlgorithm和RangeShardingAlgorithm两个分片算法。PreciseShardingAlgorithm是必选的，用于处理=和IN的分片。RangeShardingAlgorithm是可选的，用于处理BETWEEN AND, >, <, >=, <=分片，如果不配置RangeShardingAlgorithm，SQL中的BETWEEN AND将按照全库路由处理。
 *  复合分片策略
    
    对应ComplexShardingStrategy。复合分片策略。提供对SQL语句中的=, >, <, >=, <=, IN和BETWEEN AND的分片操作支持。ComplexShardingStrategy支持多分片键，由于多分片键之间的关系复杂，因此并未进行过多的封装，而是直接将分片键值组合以及分片操作符透传至分片算法，完全由应用开发者实现，提供最大的灵活度。
 *  行表达式分片策略
    
    对应InlineShardingStrategy。使用Groovy的表达式，提供对SQL语句中的=和IN的分片操作支持，只支持单分片键。对于简单的分片算法，可以通过简单的配置使用，从而避免繁琐的Java代码开发，如: `t_user_$->{u_id % 8}` 表示t\_user表根据u\_id模8，而分成8张表，表名称为`t_user_0`到`t_user_7`。
 *  Hint分片策略
    
    对应HintShardingStrategy。通过Hint指定分片值而非从SQL中提取分片值的方式进行分片的策略。
 *  不分片策略
    
    对应NoneShardingStrategy。不分片的策略。

--------------------

## Springboot+ShardingJDBC实现分库分表最简Demo ##

技术：Sprintboot+sharding-jdbc

运行环境：Sprintboot2.2.1.RELEASE+sharding-jdbc3.1.0

## 概述 ##

本文介绍如何使用当前比较成熟的分库分表框架 Sharding-JDBC 实现分库分表，读写分离，以及自定义分库分表算法。

## 详细 ##

#### 1. Sharding-JDBC 简介 ####

**Sharding-Sphere** 是一套开源的分布式数据库中间件解决方案组成的生态圈，它由 Sharding-JDBC、Sharding-Proxy和Sharding-Sidecar（计划中） 这3款相互独立的产品组成。他们均提供标准化的数据分片、分布式事务和数据库治理功能，可适用于如Java同构、异构语言、容器、 云原生等各种多样化的应用场景。

**ShardingSphere** 定位为关系型数据库中间件，旨在充分合理地在分布式的场景下利用关系型数据库的计算和存储能力， 而并非实现一个全新的关系型数据库。下面是 Sharding-Sphere 的架构图。  
![img][]

Sharding-JDBC 定位为轻量级 Java 框架，在 Java 的 JDBC 层提供的额外服务。 它使用客户端直连数据库，以jar包形式提供服务， 无需额外部署和依赖，可理解为增强版的JDBC驱动，完全兼容JDBC和各种ORM框架。

*  适用于任何基于Java的ORM框架，如：JPA, Hibernate, Mybatis, Spring JDBC Template或直接使用JDBC。
 *  基于任何第三方的数据库连接池，如：DBCP, C3P0, BoneCP, Druid, HikariCP等。
 *  支持任意实现JDBC规范的数据库。目前支持MySQL，Oracle，SQLServer和PostgreSQL。

![img][img 1]

#### 2. 概念解释 ####

在快速开始之前我们先要对后面要用到的一些概念进行一些解释。

##### 逻辑表 #####

水平拆分的数据库（表）的相同逻辑和数据结构表的总称。例：订单数据根据主键尾数拆分为10 张表， 分别是t\_order\_0到t\_order\_9，他们的逻辑表名为t\_order。

##### 真实表 #####

在分片的数据库中真实存在的物理表。即上个示例中的t\_order\_0到t\_order\_9。

##### 数据节点 #####

数据分片的最小单元。由数据源名称和数据表组成，例：ds\_0.t\_order\_0。

##### 绑定表 #####

指分片规则一致的主表和子表。例如：t\_order表和t\_order\_item表，均按照order\_id分片，则此两张表互为绑定表关系。 绑定表之间的多表关联查询不会出现笛卡尔积关联，关联查询效率将大大提升。举例说明，如果SQL为：

SELECT i.* FROM t_order o JOIN t_order_item i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);

在不配置绑定表关系时，假设分片键order\_id将数值10路由至第0片，将数值11路由至第1片，那么路由后的SQL应该为4条，它们呈现为笛卡尔积：

SELECT i.* FROM t_order_0 o JOIN t_order_item_0 i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);
    SELECT i.* FROM t_order_0 o JOIN t_order_item_1 i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);
    SELECT i.* FROM t_order_1 o JOIN t_order_item_0 i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);
    SELECT i.* FROM t_order_1 o JOIN t_order_item_1 i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);

在配置绑定表关系后，路由的SQL应该为2条：

SELECT i.* FROM t_order_0 o JOIN t_order_item_0 i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);
    SELECT i.* FROM t_order_1 o JOIN t_order_item_1 i ON o.order_id=i.order_id WHERE o.order_id in (10, 11);

其中 t\_order 在 FROM 的最左侧，ShardingSphere 将会以它作为整个绑定表的主表。所有路由计算将会只使用主表的策略， 那么t\_order\_item 表的分片计算将会使用 t\_order 的条件。

> 如何将两个表绑定呢？很简单，只要把他们的分区(包括分表和分库)键设置为同一个就可以了。

##### 分片键 #####

简单来说就是用于分片的数据库字段，是将数据库(表)水平拆分的关键字段。例：将订单表中的订单主键的尾数取模分片，则订单主键为分片字段。 SQL中如果无分片字段，将执行全路由，性能较差。 除了对单分片字段的支持，ShardingSphere也支持根据多个字段进行分片。

#### 快速开始 ####

##### 1. 建库、建表 #####

假设我们有个业务逻辑表 t\_user 现在要分表分库，假设我们分成两个库(demo\_ds\_0,demo\_ds\_1)， 每个库中又把 user 表水平拆分成 t\_user\_0, t\_user\_1。

CREATE DATABASE demo_ds_0 CHARSET=utf8;
    use demo_ds_0;
    DROP TABLE IF EXISTS `t_user_0`;
    CREATE TABLE `t_user_0` (
      `user_id` bigint(20) AUTO_INCREMENT,
      `username` varchar(30) NOT NULL,
      `password` varchar(30) DEFAULT NULL,
      PRIMARY KEY (`user_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
    DROP TABLE IF EXISTS `t_user_1`;
    CREATE TABLE `t_user_1` (
      `user_id` bigint(20) AUTO_INCREMENT,
      `username` varchar(30) NOT NULL,
      `password` varchar(30) DEFAULT NULL,
      PRIMARY KEY (`user_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
    CREATE DATABASE demo_ds_1 CHARSET=utf8;
    use demo_ds_1;
    DROP TABLE IF EXISTS `t_user_0`;
    CREATE TABLE `t_user_0` (
      `user_id` bigint(20) AUTO_INCREMENT,
      `username` varchar(30) NOT NULL,
      `password` varchar(30) DEFAULT NULL,
      PRIMARY KEY (`user_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
    DROP TABLE IF EXISTS `t_user_1`;
    CREATE TABLE `t_user_1` (
      `user_id` bigint(20) AUTO_INCREMENT,
      `username` varchar(30) NOT NULL,
      `password` varchar(30) DEFAULT NULL,
      PRIMARY KEY (`user_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;

##### 2、新建 SpringBoot 项目 #####

###### a. 项目结构 ######

![img][img 2]

###### b. 在pom中添加相关的依赖 ######

<dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter</artifactId>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
            <dependency>
                <groupId>io.shardingsphere</groupId>
                <artifactId>sharding-jdbc-spring-boot-starter</artifactId>
                <version>3.1.0</version>
            </dependency>
            <dependency>
                <groupId>org.mybatis.spring.boot</groupId>
                <artifactId>mybatis-spring-boot-starter</artifactId>
                <version>2.1.0</version>
            </dependency>
            <dependency>
                <groupId>com.alibaba</groupId>
                <artifactId>druid</artifactId>
                <version>1.1.6</version>
            </dependency>
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-test</artifactId>
                <scope>test</scope>
            </dependency>
        </dependencies>

###### c. 配置文件application.properties ######

# 数据库连接池配置变量
    initialSize=5
    minIdle=5
    maxIdle=100
    maxActive=20
    maxWait=60000
    timeBetweenEvictionRunsMillis=60000
    minEvictableIdleTimeMillis=300000
    ####################################
    # configuration of DataSource
    ####################################
    sharding.jdbc.datasource.names=ds0,ds1
    sharding.jdbc.datasource.ds0.type=com.alibaba.druid.pool.DruidDataSource
    sharding.jdbc.datasource.ds0.driver-class-name=com.mysql.jdbc.Driver
    sharding.jdbc.datasource.ds0.url=jdbc:mysql://localhost:3306/demo_ds_0
    sharding.jdbc.datasource.ds0.username=root
    sharding.jdbc.datasource.ds0.password=root
    # 初始连接数
    sharding.jdbc.datasource.ds0.initialSize=${
        initialSize}
    # 最小连接数
    sharding.jdbc.datasource.ds0.minIdle=${
        minIdle}
    # 最大连接池数量
    sharding.jdbc.datasource.ds0.maxActive=${
        maxActive}
    # 配置获取连接等待超时的时间
    sharding.jdbc.datasource.ds0.maxWait=${
        maxWait}
    # 用来检测连接是否有效的sql
    sharding.jdbc.datasource.ds0.validationQuery=SELECT 1 FROM DUAL
    # 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒
    sharding.jdbc.datasource.ds0.timeBetweenEvictionRunsMillis=${
        timeBetweenEvictionRunsMillis}
    # 配置一个连接在池中最小生存的时间，单位是毫秒
    sharding.jdbc.datasource.ds0.minEvictableIdleTimeMillis=${
        minEvictableIdleTimeMillis}
    sharding.jdbc.datasource.ds1.type=com.alibaba.druid.pool.DruidDataSource
    sharding.jdbc.datasource.ds1.driver-class-name=com.mysql.jdbc.Driver
    sharding.jdbc.datasource.ds1.url=jdbc:mysql://localhost:3306/demo_ds_1
    sharding.jdbc.datasource.ds1.username=root
    sharding.jdbc.datasource.ds1.password=root
    # 初始连接数
    sharding.jdbc.datasource.ds1.initialSize=${
        initialSize}
    # 最小连接数
    sharding.jdbc.datasource.ds1.minIdle=${
        minIdle}
    # 最大连接池数量
    sharding.jdbc.datasource.ds1.maxActive=${
        maxActive}
    # 配置获取连接等待超时的时间
    sharding.jdbc.datasource.ds1.maxWait=${
        maxWait}
    # 用来检测连接是否有效的sql
    sharding.jdbc.datasource.ds1.validationQuery=SELECT 1 FROM DUAL
    # 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒
    sharding.jdbc.datasource.ds1.timeBetweenEvictionRunsMillis=${
        timeBetweenEvictionRunsMillis}
    # 配置一个连接在池中最小生存的时间，单位是毫秒
    sharding.jdbc.datasource.ds1.minEvictableIdleTimeMillis=${
        minEvictableIdleTimeMillis}
    ####################################
    # 分库分表配置
    ####################################
    #actual-data-nodes：真实数据节点，由数据源名 + 表名组成，以小数点分隔。多个表以逗号分隔，支持inline表达式
    sharding.jdbc.config.sharding.tables.t_user.actual-data-nodes=ds${
        0..1}.t_user_${
        0..1}
    # 数据库分片列名称
    sharding.jdbc.config.sharding.default-database-strategy.inline.sharding-column=user_id
    # 分库算法表达式(取模 , HASH , 分块等)
    sharding.jdbc.config.sharding.default-database-strategy.inline.algorithm-expression=ds${
        user_id % 2}
    # 分表字段
    sharding.jdbc.config.sharding.tables.t_user.table-strategy.inline.sharding-column=user_id
    # 分表策略，这里不能跟分库策略一样，否则会导致有一半数据表没有机会插入数据
    sharding.jdbc.config.sharding.tables.t_user.table-strategy.inline.algorithm-expression=t_user_${
        (user_id % 5) % 2}
    # 配置自动生成主键
    sharding.jdbc.config.sharding.tables.t_user.key-generator-column-name=user_id
    # 配置生成自增ID的雪花算法，单台服务器可以不配置
    spring.shardingsphere.sharding.tables.t_user.key-generator.column=user_id
    spring.shardingsphere.sharding.tables.t_user.key-generator.type=SNOWFLAKE
    spring.shardingsphere.sharding.tables.t_user.key-generator.props.worker.id=1
    spring.shardingsphere.sharding.tables.t_user.key-generator.props.max.tolerate.time.difference.milliseconds=0
    spring.shardingsphere.props.sql.show=true
    # open debug mode for mybatis，print SQL in console
    logging.level.org.rockyang.shardingjdbc.common.mapper=DEBUG
    logging.level.org.springframework=INFO
    mybatis.configuration.cache-enabled=false

###### d. SpringbootShardingJdbcDemoApplication启动类 ######

package com.example.demo;
    import org.mybatis.spring.annotation.MapperScan;
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    @SpringBootApplication
    @MapperScan("com.example.demo.mapper")
    public class SpringbootShardingJdbcDemoApplication {
        
        public static void main(String[] args) {
        
            SpringApplication.run(SpringbootShardingJdbcDemoApplication.class, args);
        }
    }

###### e. 用户相关类及接口 ######

使用最简单的用户类及相关方法来进行演示测试

**User model**

> 只说明关键属性

public final class User {
        
       private Long userId;
       private String username;
       private String password;
    }
    
    **User Service**
    ```java
    public interface UserService {
        
       
        Integer add(User user);
        
        List<User> selectAll();
    }

**User Service Implementation**

@Service
    public class UserServiceImpl implements UserService {
        
        @Resource
        UserMapper userMapper;
        @Override
        public Integer add(User user) {
        
            return userMapper.insert(user);
        }
        @Override
        public List<User> selectAll() {
        
            List<User> list=userMapper.selectAll();
            return list;
        }
    }

**User Mapper**

@Mapper
    public interface UserMapper {
        
        /**
         * add a new user
         * @param model
         * @return
         */
        Integer insert(User model);
        /**
         * select all users
         * @return
         */
        List<User> selectAll();
    }

##### 3. 测试 #####

###### a. 测试类 ######

@RunWith(SpringRunner.class)
    @SpringBootTest
    public class UserServiceTest {
        
        private static Logger logger = LoggerFactory.getLogger(UserServiceTest.class);
        @Autowired
        private UserService userService;
        /* 添加一条数据 */
        @Test
        public void testAdd()
        {
        
            String username = StringUtil.generateRandomString(2);
            String password = StringUtil.generateRandomString(2);
            User user = new User(username, password);
            userService.add(user);
            logger.info("userId: {}", user.getUserId());
        }
        /* 批量添加数据 */
        @Test
        public void testAddBatch()
        {
        
            String username;
            String password;
            for (int i = 0; i < 50; i++) {
        
                username = StringUtil.generateRandomString(20);
                password = StringUtil.generateRandomString(20);
                User user = new User(username, password);
                userService.add(user);
                logger.info("userId: {}", user.getUserId());
            }
        }
        /* 测试查询 */
        @Test
        public void testSelect()
        {
        
            List<User> users = userService.selectAll();
            logger.info("Total records: {}", users.size());
            for (User user : users) {
        
                logger.info("{}", user);
            }
        }
    }

###### b. 测试 ######

对方法testAddBatch()进行测试，查看数据库如下：  
库demo\_ds\_0  
![img][img 3]  
![img][img 4]  
库demo\_ds\_1  
![img][img 5]  
![img][img 6]

##### 4. 总结 #####

*  分表的策略不能跟分库一样，比如都用 user*id 取模的话，那么就会出现每个数据库中都有一半的数据表没有数据，比如 demo\_ds\_0 中的 t\_user\_1 表，demo\_ds\_1 中的 t\_user\_0, 所以我们这里分表采取了 t\_user*$\{(user\_id % 5) % 2\} 这种先对一个基数取模来解决这个问题。
 *  Sharding-JDBC 的查询是使用归并的形式，将从各个数据节点获取的多数据结果集，组合成为一个结果集并正确的返回至请求客户端。详细的算法 请参考官方文档[归并引擎][Link 1]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3_size_16_color_FFFFFF_t_70_pic_center]: https://img-blog.csdnimg.cn/20210117134310480.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3_size_16_color_FFFFFF_t_70_pic_center 1]: https://img-blog.csdnimg.cn/20210117134323179.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3_size_16_color_FFFFFF_t_70_pic_center 2]: https://img-blog.csdnimg.cn/20210117134334515.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3_size_16_color_FFFFFF_t_70_pic_center 3]: https://img-blog.csdnimg.cn/20210117134345256.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3_size_16_color_FFFFFF_t_70_pic_center 4]: https://img-blog.csdnimg.cn/20210117134357216.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzODQzMDM3,size_16,color_FFFFFF,t_70#pic_center
[img]: https://img-blog.csdnimg.cn/img_convert/89b9cbcf01becbc3dfb87ab4475d8506.png
[img 1]: https://img-blog.csdnimg.cn/img_convert/7d45cbbbcc4d549a3191ededa6cc940f.png
[img 2]: https://img-blog.csdnimg.cn/img_convert/83c2568e1f7d149da1022223179c1415.png
[img 3]: https://img-blog.csdnimg.cn/img_convert/e1579f116ab721e2fe28f9ea3634a11a.png
[img 4]: https://img-blog.csdnimg.cn/img_convert/e39f0ee65d337ca1fe2f24dcaa1f103e.png
[img 5]: https://img-blog.csdnimg.cn/img_convert/fea833e8223361ff98f39cbb579d8e6d.png
[img 6]: https://img-blog.csdnimg.cn/img_convert/13f47529f3b6197324ce92c19d8500e1.png
[Link 1]: https://shardingsphere.apache.org/document/legacy/3.x/document/cn/features/sharding/principle/merge/