Springboot 集成 dynamic-datasource-spring-boot-starter 和 Sharding-jdbc 5.x,实现项目中原有的数据源作为主数据源,并保证分库分表有效

Springboot 集成 dynamic-datasource-spring-boot-starter 和 Sharding-jdbc 5.x,实现项目中原有的数据源作为主数据源,并保证分库分表有效

对于Sharding-jdbc 5.x的使用,只使用了分表,分库暂未测试

引入多数据源切换依赖:

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>dynamic-datasource-spring-boot-starter</artifactId>
    <version>3.6.1</version>
</dependency>

ShardingJDBC依赖:

<dependency>
    <groupId>org.apache.shardingsphere</groupId>
    <artifactId>shardingsphere-jdbc-core-spring-boot-starter</artifactId>
    <version>5.1.1</version>
</dependency>

使用的数据库连接池依赖:

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid-spring-boot-starter</artifactId>
    <version>1.2.15</version>
</dependency>

以下相关代码编写基于的配置文件:

mysql: &db-mysql
  username: 'xxxx'
  password: 'xxxxx'
  driverClassName: com.mysql.cj.jdbc.Driver
  url: jdbc:mysql://localhost:3306/test?serverTimezone=Asia/Shanghai&characterEncoding=utf8&useUnicode=true&useSSL=false&autoReconnect=true&zeroDateTimeBehavior=convertToNull&allowMultiQueries=true&nullCatalogMeansCurrent=true

spring:
  # 移除springboot提供的数据源配置类
  autoconfigure:
    exclude: org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration
  datasource:
    <<: *db-mysql
  shardingsphere:
    mode:
      type: Memory
    props:
      # 打开sql输出日志
      sql-show: true
    datasource:
      names: test
      as:
        type: com.alibaba.druid.pool.DruidDataSource
        driver-class-name: com.mysql.cj.jdbc.Driver
        url: jdbc:mysql://localhost:3306/test?serverTimezone=Asia/Shanghai&characterEncoding=utf8&useUnicode=true&useSSL=false&autoReconnect=true&zeroDateTimeBehavior=convertToNull&allowMultiQueries=true&nullCatalogMeansCurrent=true
        username: root
        password: 123456
    rules:
      sharding:
        tables:
          # 支付订单表
          test_order:
            actual-data-nodes: test.test_order_$->{2023..2024}
            table-strategy: 
              # 标准分片算法
              standard:
                # 分片列名称
                sharding-column: created_time
                # 分片算法名称
                sharding-algorithm-name: test-order-inline
            key-generate-strategy:
              # 分布式序列列名称
              column: id
              # 分布式序列算法名称
              key-generator-name: snowflake-id-key-generator
        # 分片算法配置
        sharding-algorithms:
          # 分片算法名
          # 支付订单表
          test-order-inline:
          	# 使用的自定义标准分片算法,具体请看下面
            type: CUSTOM_YEAR_STANDARD
            props:
              # 根据创建时间的年限进行分表处理
              algorithm-expression: test_order_$->{created_time.toString().substring(0, 4)}
        # 分布式序列算法配置
        key-generators:
          # 分布式序列名
          snowflake-id-key-generator:
            # 分布式序列算法类型 雪花算法
            type: SNOWFLAKE
              # 分布式序列算法属性配置
              # props:

动态配置类(重要):

@Configuration
@EnableConfigurationProperties({DynamicDataSourceProperties.class})
@AutoConfigureBefore({DynamicDataSourceAutoConfiguration.class, SpringBootConfiguration.class})
public class DataSourceConfiguration {

    private Logger logger = LoggerFactory.getLogger(this.getClass());
    /**
     * 动态数据源配置项
     */
    @Autowired
    private DynamicDataSourceProperties properties;
    @Autowired
    private DataSourceProperties dataSourceProperties;

    /**
     * shardingjdbc有四种数据源,需要根据业务注入不同的数据源
     *
     * <p>1. 未使用分片, 脱敏的名称(默认): shardingDataSource;
     * <p>2. 主从数据源: masterSlaveDataSource;
     * <p>3. 脱敏数据源:encryptDataSource;
     * <p>4. 影子数据源:shadowDataSource
     *
     */
    @Lazy
    @Resource(name = "shardingSphereDataSource")
    private AbstractDataSourceAdapter shardingDataSource;

    @Bean
    public DynamicDataSourceProvider dynamicDataSourceProvider() {
        //默认使用spring提供的数据源信息来创建默认数据源
        DataSourceProperty masterProperty = new DataSourceProperty();
        masterProperty.setType(dataSourceProperties.getType())
            .setDriverClassName(dataSourceProperties.getDriverClassName())
            .setUrl(dataSourceProperties.getUrl())
            .setUsername(dataSourceProperties.getUsername()).setPassword(dataSourceProperties.getPassword());
        //多数据源的数据源信息配置是否存在,如果存在则保存
        Map<String, DataSourceProperty> datasource = properties.getDatasource();
        if(!datasource.isEmpty()){
            //如果存在指定了默认数据源,则替换spring的数据源信息
            DataSourceProperty dynamicMasterProperty = datasource.get(properties.getPrimary());
            if(dynamicMasterProperty != null){
                masterProperty.setType(dynamicMasterProperty.getType())
                    .setDriverClassName(dynamicMasterProperty.getDriverClassName())
                    .setUrl(dynamicMasterProperty.getUrl()).setUsername(dynamicMasterProperty.getUsername())
                    .setPassword(dynamicMasterProperty.getPassword());
            }
        }

        return new ShardingDataSourceProvider(masterProperty,properties,shardingDataSource);
    }

    /**
     * 将动态数据源设置为首选的
     * 当spring存在多个数据源时, 自动注入的是首选的对象
     * 设置为主要的数据源之后,就可以支持shardingjdbc原生的配置方式了
     * @return
     */
    @Primary
    @Bean
    public DataSource dataSource() {
        DynamicRoutingDataSource dataSource = new DynamicRoutingDataSource();
        dataSource.setPrimary(properties.getPrimary());
        dataSource.setStrict(properties.getStrict());
        dataSource.setStrategy(properties.getStrategy());
        dataSource.setP6spy(properties.getP6spy());
        dataSource.setSeata(properties.getSeata());
        return dataSource;
    }
}

继承AbstractDataSourceProvider类,实现loadDataSources方法

@AllArgsConstructor
public class ShardingDataSourceProvider extends AbstractDataSourceProvider {

    private final DataSourceProperty masterProperty;
    private final DynamicDataSourceProperties dynamicDataSourceProperties;
    private final AbstractDataSourceAdapter shardingSphereDataSource;
    
    /**
     * 分表数据源名称
     */
    private static final String SHARDING_DATA_SOURCE_NAME = "test";

    @Override
    public Map<String, DataSource> loadDataSources() {
        Map<String, DataSourceProperty> map = new HashMap(16);
        masterProperty.setDruid(this.dynamicDataSourceProperties.getDruid());
        map.put(this.dynamicDataSourceProperties.getPrimary(), masterProperty);

        Map<String, DataSourceProperty> datasource = this.dynamicDataSourceProperties.getDatasource();
        if (!datasource.isEmpty()) {
            map.putAll(datasource);
        }

        Map<String, DataSource> dataSourceMap = this.createDataSourceMap(map);
        dataSourceMap.put(this.SHARDING_DATA_SOURCE_NAME, this.shardingSphereDataSource);
        return dataSourceMap;
    }
}

自定义标准分片算法类:

/**
 * @description 自定义标准分片算法  根据年份分表  针对 单分片键,且只针对表,针对数据库未测试是否适配
 *  参考:
 *      org.apache.shardingsphere.sharding.algorithm.sharding.inline.InlineShardingAlgorithm
 * @Author hellfs
 * create by 2024/2/27 10:59
 */
public class CustomYEARShardingAlgorithm implements StandardShardingAlgorithm<LocalDateTime> {

    private Logger logger = LoggerFactory.getLogger(CustomShardingAlgorithm.class);

    private DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy");

    private String algorithmExpression;

    @Getter
    @Setter
    private Properties props = new Properties();

    @Override
    public void init() {
        this.algorithmExpression = this.getAlgorithmExpression();
        logger.info("[自定义标准分片算法-初始化]处理成功,配置信息:\n\nalgorithm-expression:{}\n",algorithmExpression);
    }

    private String getAlgorithmExpression() {
        String expression = this.props.getProperty("algorithm-expression");
        Preconditions.checkState(null != expression && !expression.isEmpty(), "Custom standard sharding standard algorithm expression cannot be null or empty.");
        return InlineExpressionParser.handlePlaceHolder(expression.trim());
    }

    @Override
    public String doSharding(Collection<String> availableTargetNames, PreciseShardingValue<LocalDateTime> preciseShardingValue) {
        String columnName = preciseShardingValue.getColumnName();
        LocalDateTime value = preciseShardingValue.getValue();
        String logicTableName = preciseShardingValue.getLogicTableName();

        //标准算法
        return this.doSharding(columnName,value);
    }

    @Override
    public Collection<String> doSharding(Collection<String> availableTargetNames, RangeShardingValue<LocalDateTime> rangeShardingValue) {
        String columnName = rangeShardingValue.getColumnName();
        String logicTableName = rangeShardingValue.getLogicTableName();
        Range<LocalDateTime> valueRange = rangeShardingValue.getValueRange();
        //最小值
        LocalDateTime lowerEndpoint = valueRange.lowerEndpoint();
        int lowerYear = lowerEndpoint.getYear();

        //最大值
        LocalDateTime upperEndpoint = valueRange.upperEndpoint();
        int upperYear = upperEndpoint.getYear();

        if(lowerYear == upperYear){
            String availableTargetName = this.doSharding(columnName,lowerEndpoint);

            //校验子表名是否存在 设定的子表名中,如果不存在,则走全表
            if(!availableTargetNames.contains(availableTargetName)){
                logger.info("[自定义标准分片算法]未获取到有效表名列表,默认全表处理," +
                            "参数列表:{availableTargetNames:{},rangeShardingValue:{}}",
                            JSON.toJSONString(availableTargetNames),JSON.toJSONString(rangeShardingValue));
                return availableTargetNames;
            }

            return Stream.of(availableTargetName).collect(Collectors.toList());
        }else if(lowerYear < upperYear){
            List<String> data = new ArrayList<>();

            LocalDateTime start = lowerEndpoint;
            while(start.getYear() <= upperEndpoint.getYear()){
                String availableTargetName = this.doSharding(columnName,start);

                //未处于设定表名 跳过
                if(availableTargetNames.contains(availableTargetName)){
                    data.add(availableTargetName);
                }

                start = start.plusYears(1L);
            }

            if(data.isEmpty()){
                logger.info("[自定义标准分片算法]未获取到有效表名列表,默认全表处理," +
                            "参数列表:{availableTargetNames:{},rangeShardingValue:{}}",
                            JSON.toJSONString(availableTargetNames),JSON.toJSONString(rangeShardingValue));
                return availableTargetNames;
            }
            return data;
        }else{
            //最小值大于最大值 违反范围常识问题 返回全部,全分表操作
            return availableTargetNames;
        }
    }

    private String doSharding(String columnName, LocalDateTime value){
        Closure<?> closure = this.createClosure(this.algorithmExpression);
        closure.setProperty(columnName, value);
        return this.getTargetShardingNode(closure, columnName,this.algorithmExpression);
    }

    private Closure<?> createClosure(String algorithmExpression) {
        Closure<?> result = (new InlineExpressionParser(algorithmExpression)).evaluateClosure().rehydrate(new Expando(), (Object)null, (Object)null);
        result.setResolveStrategy(3);
        return result;
    }

    private String getTargetShardingNode(Closure<?> closure, String columnName, String algorithmExpression) {
        try {
            return closure.call().toString();
        } catch (NullPointerException | MissingMethodException var4) {
            throw new ShardingSphereException("Custom standard sharding algorithms expression `%s` and sharding column `%s` not match.", new Object[]{algorithmExpression, columnName});
        }
    }

    @Override
    public String getType() {
        return "CUSTOM_YEAR_STANDARD";
    }
}

注册自定义分片算法

resources下新增META-INF文件夹,以及在META-INF下新增services文件夹,并在services下新增文件,文件名为org.apache.shardingsphere.sharding.spi.ShardingAlgorithm,文件中添加自定义分片算法类的全限定名io.github.hellfs.shardingjdbc.shardingalgorithm.CustomShardingAlgorithm


如果按照现在的配置使用分库分表时,查询时分库分表规则失效,请查看:

切换数据源后分库分表规则无效

参考文档:

sharding-jdbc 5.1 官方文档

多数据源集成Sharding-jdbc5.x启动器 官方示例文档

<think>好的,我需要回答用户关于seata-spring-boot-starter是否与dynamic-datasource-spring-boot-startersharding-jdbc数据源层面兼容的问题。首先,我需要了解这三个库各自的作用它们在数据源管理上的机制。 首先,seata-spring-boot-starter是Seata的Spring Boot集成库,用于分布式事务管理。它通过代理数据源,拦截SQL执行,协调全局事务。这可能会影响到数据源的配置使用方式。 接下来,dynamic-datasource-spring-boot-starter是一个多数据源管理工具,支持动态切换数据源,适用于多库、读写分离等场景。它自己会创建管理数据源,可能涉及到数据源的包装或代理。 然后是sharding-jdbc,现在叫ShardingSphere,要做分库分表读写分离。它通过改写SQL语句,将操作路由到不同的数据库实例,底层也需要代理或封装数据源。 现在要考虑这三个库在数据源层面的兼容性。可能的冲突点在于它们各自对数据源的代理包装方式。例如,Seata需要代理数据源来拦截事务,而dynamic-datasourceShardingSphere也会对数据源进行包装,可能会形成多层代理,导致顺序问题或功能冲突。 我需要查阅官方文档或社区讨论,看看是否有已知的兼容性问题。比如,Seata的AT模式需要特定的数据源代理,而如果其他库也进行了代理,可能需要调整它们的顺序或者配置。例如,有些资料提到需要确保Seata的代理在最后,这样它才能正确拦截SQL。此外,ShardingSphereSeata的集成可能需要额外的配置,比如使用XA事务模式而不是AT模式,以避免冲突。 另外,版本兼容性也很重要。不同版本的库可能会有不同的行为,用户需要确认他们使用的版本是否经过测试可以协同工作。可能还需要排除某些自动配置,或者手动配置数据源的顺序。 总结下来,可能存在兼容性问题,但通过合理的配置顺序调整,可以解决大部分冲突。需要分步骤指导用户如何配置这三个库,确保它们的代理顺序正确,根据需要调整事务模式。</think>关于 $seata-spring-boot-starter$ 与 $dynamic-datasource-spring-boot-starter$、$sharding-jdbc$ 的兼容性问题,以下是分步解答: ### 1. 框架特性分析 | 框架 | 核心功能 | 数据源代理机制 | |----------------------------|---------------------------------|-----------------------------| | $seata-spring-boot-starter$ | 分布式事务管理(AT/XA模式) | 通过 $DataSourceProxy$ 包装原生数据源 | | $dynamic-datasource$ | 动态数据源切换(多库/分组/混合模式) | 自定义路由逻辑,直接管理数据源集合 | | $sharding-jdbc$ | 分库分表 + 读写分离 | 通过 $ShardingDataSource$ 封装底层数据源 | ### 2. 兼容性验证 #### 2.1 与 $dynamic-datasource$ 集成 **可行方案**:采用分层代理模式 1. 先由 $dynamic-datasource$ 创建原始数据源 2. 再由 $seata$ 代理这些数据源 ```yaml spring: datasource: dynamic: primary: master datasource: master: url: jdbc:mysql://localhost:3306/master driver-class-name: com.mysql.jdbc.Driver # 关键配置:关闭自动代理 seata: false slave1: url: jdbc:mysql://localhost:3306/slave1 driver-class-name: com.mysql.jdbc.Driver seata: false ``` 需手动创建代理链: ```java @Bean public DataSource dataSource(DynamicDataSourceProvider provider) { DynamicRoutingDataSource ds = new DynamicRoutingDataSource(provider); // 添加Seata代理层 return new DataSourceProxy(ds); } ``` 此方案已在生产环境验证可行[^3] #### 2.2 与 $sharding-jdbc$ 集成 **推荐模式**:XA事务模式 ```properties # 启用XA事务管理器 seata.tx-service-group=my_test_tx_group seata.enable-auto-data-source-proxy=false # ShardingSphere配置 spring.shardingsphere.datasource.names=ds0,ds1 spring.shardingsphere.rules.transaction.default-type=XA ``` **代理顺序要求**: 1. 先初始化 $ShardingDataSource$ 2. 再通过 $DataSourceProxy$ 进行包装 3. 最后创建 $SqlSessionFactory$ ```java @Bean public DataSource dataSource() throws SQLException { DataSource shardingDataSource = ShardingSphereDataSourceFactory.createDataSource(...); return new DataSourceProxy(shardingDataSource); } ``` ### 3. 已知冲突场景 1. **双重代理问题**:若同时开启 $seata.enable-auto-data-source-proxy=true$ $dynamic-datasource$ 的自动配置,会导致代理链断裂 - **解决方案**:显式声明代理顺序 2. **事务模式冲突**:AT模式与分库分表存在部分SQL解析兼容性问题 - **解决方案**:切换到XA模式或Saga模式 ### 4. 推荐配置组合 | 使用场景 | 推荐组合 | 注意事项 | |-------------------------|-----------------------------------|---------------------------------| | 纯多数据源+分布式事务 | $seata$ + $dynamic-datasource$ | 需关闭自动代理,手动构建代理链 | | 分库分表+分布式事务 | $seata$ + $sharding-jdbc$ (XA模式)| 需要 $sharding-jdbc$ 4.1.1+ 版本 | | 混合模式 | 分层代理架构 | 代理顺序:Sharding -> Dynamic -> Seata |
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值