配置有三种策略:
defaultDataSourceName: 默认数据源,未配置分片规则的表将通过默认数据源定位
tables: 分库分表配置,可配置多个logic_table_name
<logic_table_name>: 逻辑表名
actualDataNodes: 真实数据节点,由数据源名 + 表名组成,以小数点分隔。多个表以逗号分隔,支持inline表达式。不填写表示将为现有已知的数据源 + 逻辑表名称生成真实数据节点。用于广播表(即每个库中都需要一个同样的表用于关联查询,多为字典表)或只分库不分表且所有库的表结构完全一致的情况。
databaseStrategy: 分库策略,以下的分片策略只能任选其一
standard: 标准分片策略,用于单分片键的场景
shardingColumn: 分片列名
preciseAlgorithmClassName: 精确的分片算法类名称,用于=和IN。该类需使用默认的构造器或者提供无参数的构造器
rangeAlgorithmClassName: 范围的分片算法类名称,用于BETWEEN,可以不配置。该类需使用默认的构造器或者提供无参数的构造器
complex: 复合分片策略,用于多分片键的场景
shardingColumns : 分片列名,多个列以逗号分隔
algorithmClassName: 分片算法类名称。该类需使用默认的构造器或者提供无参数的构造器
inline: inline表达式分片策略
shardingColumn : 分片列名
algorithmInlineExpression: 分库算法Inline表达式,需要符合groovy动态语法
hint: Hint分片策略
algorithmClassName: 分片算法类名称。该类需使用默认的构造器或者提供无参数的构造器
none: 不分片
tableStrategy: 分表策略,同分库策略
bindingTables: 绑定表列表
- 逻辑表名列表,多个<logic_table_name>以逗号分隔
defaultDatabaseStrategy: 默认数据库分片策略,同分库策略
defaultTableStrategy: 默认数据表分片策略,同分库策略
props: 属性配置(可选)
sql.show: 是否开启SQL显示,默认值: false
executor.size: 工作线程数量,默认值: CPU核数
学习中,我们先使用 标准分片策略
直接上硬货: 项目是 maven 的 spring mvc + mybaties 项目,数据库 mysql
maven pom.xml 中添加 sharding 依赖
<!-- 引入sharding-jdbc核心模块 -->
<dependency>
<groupId>io.shardingjdbc</groupId>
<artifactId>sharding-jdbc-core</artifactId>
<version>2.0.3</version>
</dependency>
<dependency>
<groupId>io.shardingjdbc</groupId>
<artifactId>sharding-jdbc-core-spring-namespace</artifactId>
<version>2.0.3</version>
</dependency>
applicationContext.xml 中 sharding 配置如下
<!--分表策略,sharding-column 这里根据 id (这列属性不能是String,只能是整型)分表,AdminSingleKeyTableShardingAlgorithm 分表算法-->
<sharding:standard-strategy id="tableShardingStrategy" sharding-column="id"
precise-algorithm-class="com.study.algorithm.AdminSingleKeyTableShardingAlgorithm"/>
<sharding:data-source id="shardingDataSource">
<!--因为我只有一张表。所以就只需要配置一个dataSource-->
<sharding:sharding-rule data-source-names="dataSource" default-data-source-name="dataSource">
<sharding:table-rules>
<!--logic-tables逻辑表名: 逻辑表名 其实就是 sql 中 写的表名称-->
<!--actual-data-nodes真实表名-->
<sharding:table-rule logic-table="t_manager"
actual-data-nodes="dataSource.t_manager_0,dataSource.t_manager_1"
table-strategy-ref="tableShardingStrategy"/>
</sharding:table-rules>
<sharding:binding-table-rules>
<!--logic-tables逻辑表名-->
<sharding:binding-table-rule logic-tables="t_manager"/>
</sharding:binding-table-rules>
</sharding:sharding-rule>
</sharding:data-source>
全部配置文件如下
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:sharding="http://shardingjdbc.io/schema/shardingjdbc/sharding"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-4.0.xsd
http://shardingjdbc.io/schema/shardingjdbc/sharding
http://shardingjdbc.io/schema/shardingjdbc/sharding/sharding.xsd
">
<context:component-scan base-package="com.study.service"/>
<context:property-placeholder location="classpath:jdbc.properties" ignore-unresolvable="true"/>
<!-- dbcp数据源 -->
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init"
destroy-method="close">
<property name="driverClassName" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
<!-- 连接池最大使用连接数 -->
<property name="maxActive" value="50"/>
<!-- 初始化连接大小 -->
<property name="initialSize" value="5"/>
<!-- 获取连接最大等待时间 -->
<property name="maxWait" value="30000"/>
<!-- 连接池最大空闲 -->
<property name="maxPoolPreparedStatementPerConnectionSize" value="20"/>
<!-- 连接池最小空闲 -->
<property name="minIdle" value="3"/>
<!-- 自动清除无用连接 -->
<property name="removeAbandoned" value="true"/>
<!-- 清除无用连接的等待时间 -->
<property name="removeAbandonedTimeout" value="180"/>
<!-- 连接属性 -->
<property name="connectionProperties" value="clientEncoding=UTF-8"/>
<property name="filters" value="stat"/>
</bean>
<!--分表策略,sharding-column 这里根据 id (这列属性不能是String,只能是整型)分表,AdminSingleKeyTableShardingAlgorithm 分表算法-->
<sharding:standard-strategy id="tableShardingStrategy" sharding-column="id"
precise-algorithm-class="com.study.algorithm.AdminSingleKeyTableShardingAlgorithm"/>
<sharding:data-source id="shardingDataSource">
<!--因为我只有一张表。所以就只需要配置一个dataSource-->
<sharding:sharding-rule data-source-names="dataSource" default-data-source-name="dataSource">
<sharding:table-rules>
<!--logic-tables逻辑表名: 逻辑表名 其实就是 sql 中 写的表名称-->
<!--actual-data-nodes真实表名-->
<sharding:table-rule logic-table="t_manager"
actual-data-nodes="dataSource.t_manager_0,dataSource.t_manager_1"
table-strategy-ref="tableShardingStrategy"/>
</sharding:table-rules>
<sharding:binding-table-rules>
<!--logic-tables逻辑表名-->
<sharding:binding-table-rule logic-tables="t_manager"/>
</sharding:binding-table-rules>
</sharding:sharding-rule>
</sharding:data-source>
<!-- mybatis的配置文件 -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="shardingDataSource"/>
<property name="mapperLocations" value="classpath*:com/study/dao/AdminDao.xml"/>
</bean>
<!-- spring与mybatis整合配置,扫描所有dao和所有mapper文件 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.study.dao"/>
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
</bean>
<bean id="transactionManager"
class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="shardingDataSource"/>
</bean>
</beans>
分表逻辑 AdminSingleKeyTableShardingAlgorithm 代码如下:
package com.study.algorithm;
import io.shardingjdbc.core.api.algorithm.sharding.PreciseShardingValue;
import io.shardingjdbc.core.api.algorithm.sharding.standard.PreciseShardingAlgorithm;
import org.apache.log4j.Logger;
import java.util.Collection;
/**
* 根据id 进行分表
*/
public class AdminSingleKeyTableShardingAlgorithm implements PreciseShardingAlgorithm<Integer> {
private Logger logger = Logger.getLogger(getClass());
public String doSharding(final Collection<String> availableTargetNames, final PreciseShardingValue<Integer> shardingValue) {
String col = shardingValue.getColumnName(); // sharding 配置的 id 名称
for (String each : availableTargetNames) { //each 为t_manager_0 t_manager_1 配置的正式的表名
int value = shardingValue.getValue(); //value 为代码中 id 的真实数据,比如 插入,id 为7,则 value 为7
if (each.endsWith(value % 2 + "")) {
return each;
}
}
throw new UnsupportedOperationException();
}
}
表结果如下:
有 两个表 t_manager_0 t_manager_1
Test 如下:
testInsert 知会 insert t_manager_1 这个表中