SpringBoot集成ShardingSphere-JDBC實(shí)現(xiàn)分庫(kù)分表
前言:該文章目前只基本實(shí)現(xiàn)分庫(kù)分表,如需更復(fù)雜功能請(qǐng)移步官方文檔,后續(xù)會(huì)出復(fù)雜實(shí)現(xiàn)的筆記,如有需要請(qǐng)關(guān)注留言
一、ShardingSphere-JDBC 概述
作用之一:實(shí)現(xiàn)分庫(kù)分表存儲(chǔ)
ShardingSphere-JDBC 是 Apache ShardingSphere 的輕量級(jí)解決方案,定位為增強(qiáng)型 JDBC 驅(qū)動(dòng)。它以 jar 包形式存在于應(yīng)用程序中,通過實(shí)現(xiàn) DataSource 接口,對(duì)上層應(yīng)用提供透明的分庫(kù)分表能力,與應(yīng)用程序共享同一個(gè) JVM 進(jìn)程。
1. 核心特性
- 分庫(kù)分表:支持水平分庫(kù)、水平分表、垂直分庫(kù)等多種分片模式。
- 讀寫分離:支持主從復(fù)制架構(gòu)下的讀寫分離。
- 分布式事務(wù):提供 XA 和柔性事務(wù)支持。
- 數(shù)據(jù)加密:支持敏感數(shù)據(jù)透明加密。
- 影子庫(kù):支持灰度發(fā)布和數(shù)據(jù)驗(yàn)證。
2. 與其他中間件對(duì)比
類型 | 優(yōu)點(diǎn) | 缺點(diǎn) |
---|---|---|
ShardingSphere-JDBC | 無額外部署成本,輕量級(jí),性能損耗小 | 與應(yīng)用綁定,升級(jí)維護(hù)需修改代碼 |
ShardingSphere-Proxy | 對(duì)應(yīng)用透明,支持異構(gòu)語(yǔ)言,獨(dú)立部署 | 需要額外運(yùn)維,性能略低于 JDBC |
MyCat/Atlas | 成熟穩(wěn)定,社區(qū)活躍 | 功能不如 ShardingSphere 全面 |
二、集成前項(xiàng)目架構(gòu)(單數(shù)據(jù)源)
1. 依賴配置
<!-- MyBatis-Plus 依賴 --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.4.3.4</version> </dependency> <!-- HikariCP 連接池 --> <dependency> <groupId>com.zaxxer</groupId> <artifactId>hikari-cp</artifactId> </dependency> <!-- MySQL 驅(qū)動(dòng) --> <dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <scope>runtime</scope> </dependency>
2.配置文件 (application.yml)
spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/enterprise_practical_project username: root password: qwer123456 hikari: maximum-pool-size: 15 minimum-idle: 5 connection-timeout: 30000 mybatis-plus: mapper-locations: classpath:cn/jjcoder/mapper/*.xml type-aliases-package: cn.jjcoder.entity configuration: map-underscore-to-camel-case: true
3. MyBatis-Plus 配置類
@Configuration public class MyBatisPlusConfig { //插件 @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } @Bean public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception { MybatisSqlSessionFactoryBean factory = new MybatisSqlSessionFactoryBean(); factory.setDataSource(dataSource); factory.setMapperLocations(new PathMatchingResourcePatternResolver() .getResources("classpath:cn/jjcoder/mapper/*.xml")); return factory.getObject(); } }
4. 架構(gòu)特點(diǎn)
- 應(yīng)用直接連接單一數(shù)據(jù)庫(kù)。
- MyBatis-Plus 直接管理數(shù)據(jù)源。
- 所有表存儲(chǔ)在同一個(gè)數(shù)據(jù)庫(kù)實(shí)例中。
三、集成后項(xiàng)目架構(gòu)(ShardingSphere-JDBC)
1. 新增依賴
<!-- ShardingSphere-JDBC 核心依賴 --> <!-- https://mvnrepository.com/artifact/org.apache.shardingsphere/sharding-jdbc-spring-boot-starter --> <dependency> <groupId>org.apache.shardingsphere</groupId> <artifactId>shardingsphere-jdbc-core-spring-boot-starter</artifactId> <version>5.1.2</version> <exclusions> <!-- 排除Druid自動(dòng)配置 --> <exclusion> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-starter</artifactId> </exclusion> <!-- 排除任務(wù)調(diào)度器 --> <exclusion> <groupId>org.apache.shardingsphere</groupId> <artifactId>shardingsphere-schedule-core</artifactId> </exclusion> </exclusions> </dependency>
2. 配置文件變更
spring: shardingsphere: # 公共數(shù)據(jù)源配置(錨點(diǎn)) common-ds: &common-ds type: com.zaxxer.hikari.HikariDataSource driver-class-name: com.mysql.cj.jdbc.Driver username: root password: qwer123456 hikari: minimum-idle: 5 maximum-pool-size: 15 idle-timeout: 30000 datasource: names: main_db,ds2025 main_db: <<: *common-ds # 引用公共配置 jdbc-url: jdbc:mysql://localhost:3306/enterprise_practical_project ds2025: <<: *common-ds jdbc-url: jdbc:mysql://localhost:3306/shard_db_2025 # ds2026: # <<: *common-ds # jdbc-url: jdbc:mysql://localhost:3306/shard_db_2026 rules: sharding: tables: standing_book: actual-data-nodes: ds$->{2025..2026}.standing_book_$->{202501..202512} database-strategy: standard: sharding-column: in_out_date sharding-algorithm-name: db-interval table-strategy: standard: sharding-column: in_out_date sharding-algorithm-name: table-interval sharding-algorithms: db-interval: type: INTERVAL props: datetime-pattern: "yyyy-MM-dd" datetime-lower: '2025-01-01' datetime-upper: '2026-12-31' sharding-suffix-pattern: 'yyyy' datetime-interval-amount: 1 datetime-interval-unit: years table-interval: type: INTERVAL props: datetime-pattern: "yyyy-MM-dd" datetime-lower: '2025-01-01' datetime-upper: '2026-12-31' sharding-suffix-pattern: 'yyyyMM' datetime-interval-amount: 1 datetime-interval-unit: months datetime-format-pattern: ^\d{4}-\d{2}-\d{2}$ mybatis-plus: mapper-scan: base-package: cn.jjcoder.mapper global-config: db-config: logic-delete-field: deleted # 全局邏輯刪除字段名 logic-delete-value: 1 # 邏輯已刪除值 logic-not-delete-value: 0 # 邏輯未刪除值 configuration: # 配置下劃線與駝峰之間轉(zhuǎn)換 map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl mapper-locations: classpath:cn.jjcoder.mapper/*.xml type-aliases-package: cn.jjcoder.entity
3. MyBatis-Plus 配置類
@Configuration public class MyBatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } @Bean public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception { MybatisSqlSessionFactoryBean sessionFactory = new MybatisSqlSessionFactoryBean(); sessionFactory.setDataSource(dataSource);// 注入的是 ShardingSphere 的數(shù)據(jù)源 sessionFactory.setMapperLocations(new PathMatchingResourcePatternResolver() .getResources("classpath:cn/jjcoder/mapper/*.xml")); return sessionFactory.getObject(); } /** * 使用 ShardingSphere 時(shí),事務(wù)管理器需要指向 ShardingSphere 的數(shù)據(jù)源: * @param dataSource * @return */ @Bean public PlatformTransactionManager transactionManager(DataSource dataSource) { return new DataSourceTransactionManager(dataSource); } }
4. 架構(gòu)特點(diǎn)
- 應(yīng)用通過 ShardingSphere-JDBC 連接多個(gè)數(shù)據(jù)庫(kù)。
- ShardingSphere 管理多個(gè)物理數(shù)據(jù)源,向上層(MP)提供統(tǒng)一的邏輯數(shù)據(jù)源。
- MyBatis-Plus 操作 ShardingSphere 提供的邏輯數(shù)據(jù)源,無需感知底層分片細(xì)節(jié)。
- 分片規(guī)則完全由 ShardingSphere 配置控制。
四、集成后效果演示
通過插入數(shù)據(jù)來演示 mybatis-plus 和ShardingSphere之間的工作流程分庫(kù)分表
前言:我目前在 application.yml 配置文件中配置的需要分庫(kù)分表的表為 standing_book(臺(tái)賬表),并且配好了多數(shù)據(jù)源的連接信息,以及具體的分片算法。所以在此之前需要保證數(shù)據(jù)庫(kù)有相應(yīng)的庫(kù)和表,以及表的分片鍵類型(這點(diǎn)我在剛開始做的時(shí)候沒注意,后續(xù)出了bug排查了好久)
保證以上之后,演示分庫(kù)分表具體效果:
由于分庫(kù)分表的表為standing_book,所以需給這個(gè)表插入數(shù)據(jù)才能觸發(fā),目前我的業(yè)務(wù)邏輯為 產(chǎn)品出入庫(kù)時(shí)生成臺(tái)賬信息保存數(shù)據(jù)庫(kù)
- 往 standing_book 插入數(shù)據(jù)代碼
/** * 根據(jù)商品出入庫(kù)生成臺(tái)賬 * @param list * @return */ @Override public boolean saveByProductInOrOut(List<ProductVO> list, String userName, boolean isIn) { String operationType = isIn ? "入庫(kù)" : "出庫(kù)"; List<StandingBook> standingBooks = new ArrayList<>(); for (ProductVO vo : list) { StandingBook standingBook = new StandingBook(); standingBook.setProductId(vo.getId()); //產(chǎn)品id standingBook.setProductName(vo.getName()); //產(chǎn)品名稱 standingBook.setOperationType(operationType); //操作類型 standingBook.setOperationNum(vo.getInOrOutCount()); //入庫(kù)or出庫(kù)數(shù)量 Integer newQuantity=isIn? vo.getInventory()+vo.getInOrOutCount() : vo.getInventory()-vo.getInOrOutCount(); standingBook.setNewQuantity(newQuantity); //出入庫(kù)后庫(kù)存總量 standingBook.setOrperator(userName); standingBook.setCreateDatetime(LocalDateTime.now()); standingBook.setInOutDate(LocalDate.now().toString()); //設(shè)置分片鍵值(shardingsphere會(huì)根據(jù)該字段值進(jìn)行分片,路由到相應(yīng)的庫(kù)表) standingBooks.add(standingBook); } //該 saveOrUpdateBatchCustom 將會(huì)觸發(fā)分庫(kù)分表算法 return this.saveOrUpdateBatchCustom(standingBooks); }
- 控制臺(tái)執(zhí)行信息如下
# mybatis-plus生成的sql 2025-05-20 20:06:48.308 DEBUG --- [onPool-worker-9] c.j.mapper.StandingBookMapper.insert : ==> Preparing: INSERT INTO standing_book ( standing_book_id, product_id, product_name, operation_type, in_out_date, orperator, operation_num, new_quantity, create_datetime ) VALUES ( ?, ?, ?, ?, ?, ?, ?, ?, ? ) 2025-05-20 20:06:48.316 DEBUG --- [onPool-worker-9] c.j.mapper.StandingBookMapper.insert : ==> Parameters: f1feb93be82375630ce8f4c3a8e006f8(String), 1dbcf56794cc1cc21ea12719ea7b7a86(String), 6(String), 入庫(kù)(String), 2025-05-20(String), root(String), 1(Integer), 35(Integer), 2025-05-20T20:06:48.307(LocalDateTime) # 被ShardingSphere接管() # 邏輯sql 2025-05-20 20:06:48.322 INFO --- [onPool-worker-9] ShardingSphere-SQL : Logic SQL: INSERT INTO standing_book ( standing_book_id, product_id, product_name, operation_type, in_out_date, orperator, operation_num, new_quantity, create_datetime ) VALUES ( ?, ?, ?, ?, ?, ?, ?, ?, ? ) 2025-05-20 20:06:48.322 INFO --- [onPool-worker-9] ShardingSphere-SQL : SQLStatement: MySQLInsertStatement(setAssignment=Optional.empty, onDuplicateKeyColumns=Optional.empty) # 實(shí)際執(zhí)行sql 2025-05-20 20:06:48.322 INFO --- [onPool-worker-9] ShardingSphere-SQL : Actual SQL: ds2025 ::: INSERT INTO standing_book_202505 ( standing_book_id, product_id, product_name, operation_type, in_out_date, orperator, operation_num, new_quantity, create_datetime ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?) ::: [f1feb93be82375630ce8f4c3a8e006f8, 1dbcf56794cc1cc21ea12719ea7b7a86, 6, 入庫(kù), 2025-05-20, root, 1, 35, 2025-05-20T20:06:48.307]
通過以上控制臺(tái)輸出可以看到
- mybatis-plus依舊會(huì)生成預(yù)編譯sql,但是被shardingsphere接管
- 可以看到 shardingsphere 的邏輯sql 和實(shí)際執(zhí)行sql
- 實(shí)際執(zhí)行sql上顯示了具體路由到的庫(kù)和表
具體執(zhí)行流程如下:
- 應(yīng)用代碼調(diào)用:Service 層調(diào)用 Mapper 接口方法。
- MyBatis-Plus 處理:
■ 通過 SqlSessionFactory 獲取 SqlSession。
■ 生成 SQL 語(yǔ)句。 - ShardingSphere 攔截:
■ ShardingDataSource 攔截 SQL 執(zhí)行請(qǐng)求。
■ 根據(jù)分片規(guī)則計(jì)算目標(biāo)庫(kù)表。
■ 路由 SQL 到對(duì)應(yīng)的物理數(shù)據(jù)源和表。 - 數(shù)據(jù)庫(kù)執(zhí)行:實(shí)際執(zhí)行 SQL 并返回結(jié)果。
- 結(jié)果返回:結(jié)果通過 ShardingSphere 封裝后返回給 MyBatis-Plus,MyBatis-Plus 將結(jié)果映射為 Java 對(duì)象返回給應(yīng)用。
五、配置加載與協(xié)作流程
1. 配置加載順序
- Spring Boot 啟動(dòng):加載 application.yml 配置文件。
- ShardingSphere 自動(dòng)配置:
- ShardingSphereAutoConfiguration 類解析 spring.shardingsphere 配置。
- 創(chuàng)建多個(gè)物理數(shù)據(jù)源(HikariCP 連接池)。
- 根據(jù)分片規(guī)則創(chuàng)建 ShardingDataSource(實(shí)現(xiàn) DataSource 接口)。
- 將 ShardingDataSource 注冊(cè)為 Spring 容器中的唯一 DataSource Bean。
- MyBatis-Plus 自動(dòng)配置:
- MybatisPlusAutoConfiguration 類自動(dòng)加載。
- 注入 ShardingSphere 提供的 DataSource Bean。
- 創(chuàng)建 SqlSessionFactory 和其他 MyBatis 組件。
2. 核心組件初始化過程
ShardingSphere 初始化:
ShardingSphereAutoConfiguration → 解析配置文件 → 創(chuàng)建多個(gè) HikariDataSource 實(shí)例 → 根據(jù)分片規(guī)則創(chuàng)建 ShardingRule → 將數(shù)據(jù)源和規(guī)則組裝為 ShardingDataSource → 注冊(cè) ShardingDataSource 到 Spring 容器
MyBatis-Plus 初始化:
MybatisPlusAutoConfiguration → 從 Spring 容器獲取唯一的 DataSource Bean(即 ShardingDataSource) → 創(chuàng)建 MybatisSqlSessionFactoryBean → 設(shè)置數(shù)據(jù)源、映射文件路徑等配置 → 初始化 SqlSessionFactory → 注冊(cè) MyBatis 的 MapperScanner
3. SQL 執(zhí)行協(xié)作流程
- 應(yīng)用代碼調(diào)用:Service 層調(diào)用 Mapper 接口方法。
- MyBatis-Plus 處理:
- 通過 SqlSessionFactory 獲取 SqlSession。
- 生成 SQL 語(yǔ)句。
- ShardingSphere 攔截:
- ShardingDataSource 攔截 SQL 執(zhí)行請(qǐng)求。
- 根據(jù)分片規(guī)則計(jì)算目標(biāo)庫(kù)表。
- 路由 SQL 到對(duì)應(yīng)的物理數(shù)據(jù)源和表。
- 數(shù)據(jù)庫(kù)執(zhí)行:實(shí)際執(zhí)行 SQL 并返回結(jié)果。
- 結(jié)果返回:結(jié)果通過 ShardingSphere 封裝后返回給 MyBatis-Plus,MyBatis-Plus 將結(jié)果映射為 Java 對(duì)象返回給應(yīng)用。
六、集成前后代碼對(duì)比
1. 依賴對(duì)比
- 集成前
- 項(xiàng)目?jī)H依賴 MyBatis-Plus、HikariCP 連接池和 MySQL 驅(qū)動(dòng),聚焦于單數(shù)據(jù)源下的數(shù)據(jù)庫(kù)操作與對(duì)象關(guān)系映射。
- 而集成 ShardingSphere-JDBC 后
- 新增了 ShardingSphere-JDBC 核心依賴,此依賴引入分庫(kù)分表等關(guān)鍵功能,使得項(xiàng)目具備處理多數(shù)據(jù)源和復(fù)雜數(shù)據(jù)分布的能力。
對(duì)比維度 | 集成前 | 集成后 |
---|---|---|
核心依賴變化 | 僅包含 MyBatis-Plus 及基礎(chǔ)數(shù)據(jù)庫(kù)連接依賴 | 新增 ShardingSphere-JDBC 核心依賴,構(gòu)建多數(shù)據(jù)源處理能力 |
功能擴(kuò)展 | 支持單數(shù)據(jù)源下的常規(guī)數(shù)據(jù)庫(kù)操作與對(duì)象映射 | 新增分庫(kù)分表、讀寫分離、分布式事務(wù)等高級(jí)功能 |
2. 配置文件對(duì)比
在數(shù)據(jù)源配置部分
- 集成前
- 采用傳統(tǒng)的 spring.datasource 配置單一數(shù)據(jù)源,簡(jiǎn)潔明了地定義驅(qū)動(dòng)、URL、用戶名和密碼等信息。
- 集成后,
- 數(shù)據(jù)源配置轉(zhuǎn)移到 spring.shardingsphere.datasource 下,不僅需定義多個(gè)物理數(shù)據(jù)源,還需配置各數(shù)據(jù)源的詳細(xì)參數(shù),如連接池設(shè)置。
- 此外,新增的 spring.shardingsphere.rules 用于配置復(fù)雜的分庫(kù)分表規(guī)則,涵蓋數(shù)據(jù)節(jié)點(diǎn)分布、分片策略和算法,以實(shí)現(xiàn)數(shù)據(jù)的合理分片存儲(chǔ)與高效訪問。
對(duì)比維度 | 集成前 | 集成后 |
---|---|---|
數(shù)據(jù)源配置位置 | spring.datasource,配置單一數(shù)據(jù)源 | spring.shardingsphere.datasource,配置多個(gè)物理數(shù)據(jù)源 |
配置復(fù)雜度 | 簡(jiǎn)單定義驅(qū)動(dòng)、URL、用戶名和密碼等基本信息 | 除基本信息外,還需配置多個(gè)數(shù)據(jù)源連接池參數(shù),以及分庫(kù)分表規(guī)則 |
新增配置項(xiàng) | 無 | spring.shardingsphere.rules,用于定義分庫(kù)分表規(guī)則,包括數(shù)據(jù)節(jié)點(diǎn)、分片策略和算法 |
3. 代碼邏輯對(duì)比
從數(shù)據(jù)訪問層代碼邏輯來看
- 集成前
- MyBatis-Plus 直接操作單一數(shù)據(jù)源,開發(fā)人員無需關(guān)注數(shù)據(jù)源的復(fù)雜性,可專注于業(yè)務(wù) SQL 編寫和對(duì)象映射。
- 集成后
- 雖然 MyBatis-Plus 的 Mapper 接口和業(yè)務(wù)代碼在形式上未發(fā)生明顯變化,但實(shí)際上,MyBatis-Plus 操作的已變?yōu)?ShardingSphere 提供的邏輯數(shù)據(jù)源。
- ShardingSphere 會(huì)在底層自動(dòng)處理 SQL 路由,根據(jù)分庫(kù)分表規(guī)則將 SQL 準(zhǔn)確發(fā)送到對(duì)應(yīng)的物理數(shù)據(jù)源和表,開發(fā)人員無需手動(dòng)處理復(fù)雜的路由邏輯,降低了開發(fā)難度和出錯(cuò)概率。
對(duì)比維度 | 集成前 | 集成后 |
---|---|---|
數(shù)據(jù)訪問方式 | MyBatis-Plus 直接操作單一數(shù)據(jù)源,簡(jiǎn)單直觀 | MyBatis-Plus 操作 ShardingSphere 提供的邏輯數(shù)據(jù)源,底層自動(dòng)處理 SQL 路由 |
開發(fā)關(guān)注點(diǎn) | 專注于業(yè)務(wù) SQL 編寫和對(duì)象映射 | 無需關(guān)注復(fù)雜的 SQL 路由邏輯,專注業(yè)務(wù)邏輯,由 ShardingSphere 處理數(shù)據(jù)分片 |
代碼改動(dòng) | 無明顯代碼改動(dòng) | 無明顯代碼改動(dòng),僅配置變化,對(duì)業(yè)務(wù)代碼透明 |
4. 架構(gòu)設(shè)計(jì)對(duì)比
在架構(gòu)層面
- 集成前
- 項(xiàng)目架構(gòu)簡(jiǎn)單,應(yīng)用與單一數(shù)據(jù)庫(kù)直接相連,數(shù)據(jù)處理邏輯集中在單庫(kù)內(nèi),適用于數(shù)據(jù)規(guī)模較小、業(yè)務(wù)邏輯相對(duì)簡(jiǎn)單的場(chǎng)景。
- 集成后
- 引入 ShardingSphere-JDBC 使架構(gòu)轉(zhuǎn)變?yōu)閼?yīng)用通過 ShardingSphere 連接多個(gè)數(shù)據(jù)庫(kù),形成分布式數(shù)據(jù)存儲(chǔ)架構(gòu)。
- ShardingSphere 作為中間層,管理多個(gè)物理數(shù)據(jù)源,向上提供統(tǒng)一的邏輯數(shù)據(jù)源,實(shí)現(xiàn)數(shù)據(jù)的分布式存儲(chǔ)與訪問,提升了系統(tǒng)的擴(kuò)展性和性能,以應(yīng)對(duì)大規(guī)模數(shù)據(jù)和高并發(fā)訪問的挑戰(zhàn)。
對(duì)比維度 | 集成前 | 集成后 |
---|---|---|
數(shù)據(jù)庫(kù)連接關(guān)系 | 應(yīng)用直接連接單一數(shù)據(jù)庫(kù),架構(gòu)簡(jiǎn)單 | 應(yīng)用通過 ShardingSphere-JDBC 連接多個(gè)數(shù)據(jù)庫(kù),形成分布式架構(gòu) |
數(shù)據(jù)管理方式 | 單庫(kù)內(nèi)數(shù)據(jù)處理,邏輯集中 | ShardingSphere 管理多個(gè)物理數(shù)據(jù)源,實(shí)現(xiàn)數(shù)據(jù)分片存儲(chǔ)與統(tǒng)一訪問 |
架構(gòu)擴(kuò)展性 | 擴(kuò)展性有限,難以應(yīng)對(duì)大規(guī)模數(shù)據(jù)和高并發(fā) | 擴(kuò)展性增強(qiáng),可通過增加數(shù)據(jù)源應(yīng)對(duì)數(shù)據(jù)增長(zhǎng)和高并發(fā)需求 |
七、關(guān)鍵注意事項(xiàng)
1. 數(shù)據(jù)源唯一性
(以下配置如果你是以代碼形式配置數(shù)據(jù)源的話這么配置,如果是在application.yml中配置需在配置文件配置)
確保 Spring 容器中只有一個(gè) DataSource
Bean,即 ShardingSphere 提供的 ShardingDataSource
。如果存在多個(gè) DataSource
Bean,需要通過 @Primary
注解明確指定主數(shù)據(jù)源。
若項(xiàng)目中存在多個(gè)數(shù)據(jù)源配置,需顯式指定 ShardingSphere 的數(shù)據(jù)源為主要數(shù)據(jù)源:
示例代碼
@Configuration public class DataSourceConfig { // 假設(shè)存在多個(gè)數(shù)據(jù)源 Bean @Bean @Primary // 指定 ShardingSphere 的數(shù)據(jù)源為主要數(shù)據(jù)源 public DataSource shardingDataSource() throws SQLException { // 從 ShardingSphere 配置構(gòu)建數(shù)據(jù)源 return ShardingSphereDataSourceFactory.createDataSource(createShardingRuleConfiguration()); } // 其他數(shù)據(jù)源 Bean(非主要) @Bean public DataSource anotherDataSource() { // 配置其他數(shù)據(jù)源 return DataSourceBuilder.create().build(); } // 構(gòu)建 ShardingSphere 分片規(guī)則配置 private ShardingRuleConfiguration createShardingRuleConfiguration() { // 配置分片規(guī)則... } }
2. 事務(wù)管理
在使用ShardingSphere的分布式事務(wù)支持時(shí),可通過配置事務(wù)類型屬性來選擇事務(wù)模式。例如,若采用XA強(qiáng)一致性事務(wù),可在application.yml
中添加spring.shardingsphere.props.transaction.type=XA
配置;若選擇柔性事務(wù)(如基于最大努力送達(dá)型的事務(wù)),則需結(jié)合具體業(yè)務(wù)場(chǎng)景,合理配置補(bǔ)償策略和消息隊(duì)列等組件,確保事務(wù)最終一致性。
對(duì)于跨庫(kù)事務(wù),需要使用分布式事務(wù)管理器,如 Seata 或 ShardingSphere 自身提供的分布式事務(wù)支持:
spring: shardingsphere: props: xa-transaction-manager-type: atomikos # 使用 Atomikos XA 事務(wù)管理器
3. SQL 限制
分庫(kù)分表場(chǎng)景下,部分復(fù)雜 SQL 可能無法執(zhí)行,如:
- 跨庫(kù)關(guān)聯(lián)查詢。
- 跨庫(kù)聚合函數(shù)(如 COUNT、SUM)。
- 分布式主鍵生成。
4. 性能監(jiān)控
ShardingSphere 提供內(nèi)置的 SQL 監(jiān)控功能,可以通過配置開啟:
spring: shardingsphere: props: sql-show: true # 打印 SQL metrics-name: prometheus # 集成 Prometheus 監(jiān)控
八、常見問題與解決方案
1. 啟動(dòng)時(shí)報(bào) “SqlSessionFactory 找不到”
在 MybatisPlusConfig 配置如下bean
@Bean public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception { MybatisSqlSessionFactoryBean sessionFactory = new MybatisSqlSessionFactoryBean(); sessionFactory.setDataSource(dataSource); sessionFactory.setMapperLocations(new PathMatchingResourcePatternResolver() .getResources("classpath:cn/jjcoder/mapper/*.xml")); return sessionFactory.getObject(); }
2. SQL 執(zhí)行異常,表不存在
- 原因:分片規(guī)則配置錯(cuò)誤,SQL 路由到不存在的表。
- 解決方案:
- 檢查
actual-data-nodes
配置是否正確。 - 確認(rèn)分片算法和分片鍵配置是否匹配。
- 確保
actual-data-nodes
中的表名與實(shí)際數(shù)據(jù)庫(kù)中的表名一致:
- 檢查
3. 事務(wù)不生效
- 原因:跨庫(kù)事務(wù)需要分布式事務(wù)支持。
- 解決方案:
- 配置分布式事務(wù)管理器(如 Atomikos、Seata)。
- 使用
@Transactional
注解時(shí)指定正確的事務(wù)管理器。
配置文件修改示例:
配置 Atomikos XA 事務(wù)管理器:
spring: shardingsphere: props: xa-transaction-manager-type: atomikos # 啟用 XA 事務(wù)
Java 配置示例:
定義分布式事務(wù)管理器:
@Configuration public class TransactionConfig { @Bean public PlatformTransactionManager transactionManager(DataSource dataSource) { // 使用 Atomikos 分布式事務(wù)管理器 JtaTransactionManager transactionManager = new JtaTransactionManager(); transactionManager.setTransactionManager(new UserTransactionManager()); transactionManager.setUserTransaction(new UserTransactionImp()); return transactionManager; } }
4. 性能下降明顯
- 原因:分片規(guī)則不合理或連接池配置不當(dāng)。
- 解決方案:
- 優(yōu)化分片算法,避免數(shù)據(jù)傾斜。
- 調(diào)整連接池參數(shù)(如
maximum-pool-size
)。 - 開啟 SQL 監(jiān)控,分析慢查詢。
配置文件修改示例:
優(yōu)化 HikariCP 連接池參數(shù):
spring: shardingsphere: # 公共數(shù)據(jù)源配置(錨點(diǎn)) common-ds: &common-ds type: com.zaxxer.hikari.HikariDataSource driver-class-name: com.mysql.cj.jdbc.Driver username: root password: qwer123456 hikari: maximum-pool-size: 30 # 增加最大連接數(shù) minimum-idle: 10 # 增加最小空閑連接數(shù) idle-timeout: 30000 # 空閑連接超時(shí)時(shí)間 max-lifetime: 1800000 # 連接最大生命周期
九、總結(jié)
通過集成 ShardingSphere-JDBC,我們?cè)诓恍薷?MyBatis-Plus 代碼的前提下,實(shí)現(xiàn)了數(shù)據(jù)庫(kù)的分庫(kù)分表能力。這種架構(gòu)既保留了 MyBatis-Plus 的開發(fā)便利性,又通過 ShardingSphere 提升了系統(tǒng)的可擴(kuò)展性和性能。關(guān)鍵要點(diǎn)包括:
- ShardingSphere-JDBC 作為增強(qiáng)型 JDBC 驅(qū)動(dòng),對(duì)上層應(yīng)用透明。
- 集成后,MyBatis-Plus 操作的是 ShardingSphere 提供的邏輯數(shù)據(jù)源,無需關(guān)心底層分片細(xì)節(jié)。
- 分片規(guī)則完全通過配置文件控制,無需修改 DAO 層代碼。
- 需要注意分布式事務(wù)、復(fù)雜 SQL 支持等特殊
到此這篇關(guān)于SpringBoot集成ShardingSphere-JDBC實(shí)現(xiàn)分庫(kù)分表的文章就介紹到這了,更多相關(guān)ShardingSphere-JDBC分庫(kù)分表內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
詳解Java程序并發(fā)的Wait-Notify機(jī)制
這篇文章主要介紹了詳解Java程序并發(fā)的Wait-Notify機(jī)制,多線程并發(fā)是Java編程中的重要部分,需要的朋友可以參考下2015-07-07Java使用CompletableFuture實(shí)現(xiàn)異步編程
在現(xiàn)代 Java 開發(fā)中,異步編程是一項(xiàng)重要技能,而 CompletableFuture 是從 Java 8 開始提供的一個(gè)功能強(qiáng)大的工具,用于簡(jiǎn)化異步任務(wù)的編寫和組合,本文將詳細(xì)介紹 CompletableFuture 的基本使用和一些常見的應(yīng)用場(chǎng)景,需要的朋友可以參考下2025-01-01mybatisplus?實(shí)現(xiàn)接口MetaObjectHandler自動(dòng)填充字段值
MetaObjectHandler是MyBatis-Plus提供的一個(gè)接口,本文主要介紹了mybatisplus?實(shí)現(xiàn)接口MetaObjectHandler自動(dòng)填充字段值,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2024-07-07Mybatis-Plus的saveOrUpdateBatch(null)問題及解決
這篇文章主要介紹了Mybatis-Plus的saveOrUpdateBatch(null)問題及解決方案,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2023-07-07基于Java注解(Annotation)的自定義注解入門介紹
要深入學(xué)習(xí)注解,我們就必須能定義自己的注解,并使用注解,在定義自己的注解之前,我們就必須要了解Java為我們提供的元注解和相關(guān)定義注解的語(yǔ)法2013-04-04一篇文章帶你了解JAVA面對(duì)對(duì)象三大特征之封裝
所有的面向?qū)ο缶幊陶Z(yǔ)言的思路都是差不多的,而這三大特性,則是思路中的支柱點(diǎn),接下來我就重點(diǎn)講解了一下java三大特性-封裝,感興趣的朋友跟隨腳本之家小編一起看看吧2021-08-08MyBatis-Plus中實(shí)現(xiàn)自定義復(fù)雜排序邏輯的詳細(xì)步驟
這篇文章主要介紹了MyBatis-Plus中實(shí)現(xiàn)自定義復(fù)雜排序邏輯,通過使用MyBatis-Plus的QueryWrapper和SQL原始片段,我們可以靈活地實(shí)現(xiàn)復(fù)雜的數(shù)據(jù)排序邏輯,這種方法尤其適用于需要對(duì)數(shù)據(jù)進(jìn)行特定規(guī)則排序的場(chǎng)景,需要的朋友可以參考下2024-07-07SpringBoot 快速實(shí)現(xiàn) api 加密的方法
在項(xiàng)目中,為了保證數(shù)據(jù)的安全,我們常常會(huì)對(duì)傳遞的數(shù)據(jù)進(jìn)行加密,常用的加密算法包括對(duì)稱加密(AES)和非對(duì)稱加密(RSA),本文給大家介紹SpringBoot 快速實(shí)現(xiàn) api 加密,感興趣的朋友一起看看吧2023-10-10