SpringBoot 多数据源 - dynamic-datasource | 快速入门

• JDK 17
• Spring Boot 3.2.1
• dynamic-datasource 4.3.0

🚀 主要步骤

• 1️⃣ 引入依赖
• 2️⃣ 配置数据源
• 3️⃣ 使用 @DS 注解切换数据源

简介

dynamic-datasourc：一个基于 SpringBoot 的快速集成多数据源的启动器。
特性：

• 支持 JDK 1.7+
• 支持 SpringBoot 1.5.x、2.x、3.x
• 支持 数据源分组，适用于多种场景：纯粹多库、读写分离、一主多从、混合模式
• 连接池集成：简化对 Druid、HikariCP、BeeCP、Dbcp2 的快速集成
• 第三方集成：提供对 MyBatisPlus、Quartz、ShardingJDBC、P6spy、JDNI 等组件集成方案
• 进阶用法
  • 启动前
    • 支持数据库敏感配置加密（可自定义、ENC()）
    • 支持 自定义注解 ，需继承DS(3.2.0+)
  • 启动时
    • 支持 无数据源启动（启动时无数据源，运行时添加）
    • 支持 **懒加载 **数据源
    • 支持启动时运行初始化 SQL 脚本（表结构和数据）
  • 运行时
    • 支持运行时 动态增减数据源
    • 支持 自定义数据源来源 方案（如从数据库加载，而不是 YAML 配置文件）
    • 支持 SpEL 动态解析数据源，支持从 Session、Header、自定义方式解析数据源
    • 支持 多层数据源嵌套切换（ServiceA >>> ServiceB >>> ServiceC）
    • 提供 **本地多数据源事务方案、 基于 seata 的分布式事务方案 **
    • 提供 MyBatis 环境下的 纯读写分离 方案

第 1 步：引入依赖

引入 dynamic-datasource-spring-boot-starter 依赖：

<!-- 适合 SpringBoot 1.5.x + 2.x 版本 -->
<dependency>
  <groupId>com.baomidou</groupId>
  <artifactId>dynamic-datasource-spring-boot-starter</artifactId>
  <version>${version}</version>
</dependency>

<!-- 适合 SpringBoot 3.x 版本 -->
<dependency>
  <groupId>com.baomidou</groupId>
  <artifactId>dynamic-datasource-spring-boot3-starter</artifactId>
  <version>${version}</version>
</dependency>

第 2 步：配置数据源

多种配置数据源的形式

dynamic-datasource 支持多种数据源配置方式：

• 多主多从：多个主节点，多个从节点。master 分组有两个节点，slave 分组有三个节点。
• 纯粹多库：单纯就是多个数据库。
• 混合配置：既有多主多从，也有纯粹多库。

数据源分组：

• 配置文件所有以下划线 _ 分割的数据源 首部 即为数据源分组名称，相同组名称的数据源会放在一个组下。
• 使用 @DS 注解切换数据源时，也可以指定数据源分组名称，就会采用负载均衡方式选择具体数据源。

# 多主多从             纯粹多库（记得设置primary）            混合配置
spring:                      spring:                        spring:
  datasource:                  datasource:                    datasource:
    dynamic:                     dynamic:                       dynamic:
      datasource:                  datasource:                    datasource:
        master_1:                    mysql:                         master:
        master_2:                    oracle:                        slave_1:
        slave_1:                     sqlserver:                     slave_2:
        slave_2:                     postgresql:                    oracle_1:
        slave_3:                     h2:                            oracle_2:

数据源配置示例

配置示例：一个 mysql + 一个 tidb

spring:
  datasource:
    dynamic: