Spring 命名空间配置

ShardingSphere-5.0.0-beta

数据分片

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/sharding/sharding-5.0.0.xsd

<sharding:rule />

<sharding:table-rules />

<sharding:table-rule />

<auto-table-rules/>

<auto-table-rule/> | 名称 | 类型 | 说明 | | ————————- | —– | ————— | | logic-table | 属性 | 逻辑表名称 | | actual-data-sources | 属性 | 自动分片表数据源名 | | sharding-strategy-ref | 属性 | 自动分片表策略名称 | | key-generate-strategy-ref | 属性 | 分布式序列策略名称 |

<sharding:binding-table-rules />

<sharding:binding-table-rule />

<sharding:broadcast-table-rules />

<sharding:broadcast-table-rule />

<sharding:standard-strategy />

<sharding:complex-strategy />

<sharding:hint-strategy />

<sharding:none-strategy />

<sharding:key-generate-strategy />

<sharding:sharding-algorithm />

<sharding:key-generate-algorithm />

算法类型的详情，请参见内置分片算法列表和内置分布式序列算法列表。

注意事项

行表达式标识符可以使用 ${...} 或 $->{...}，但前者与 Spring 本身的属性文件占位符冲突，因此在 Spring 环境中使用行表达式标识符建议使用 $->{...}。

读写分离

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/readwrite-splitting/readwrite-splitting-5.0.0.xsd

<readwrite-splitting:rule />

<readwrite-splitting:data-source-rule />

<readwrite-splitting:load-balance-algorithm />

算法类型的详情，请参见内置负载均衡算法列表。

数据加密

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/encrypt/encrypt-5.0.0.xsd

<encrypt:rule />

<encrypt:table />

<encrypt:column />

<encrypt:encrypt-algorithm />

算法类型的详情，请参见内置加密算法列表。

影子库

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/shadow/shadow-5.0.0.xsd

<shadow:rule />

<shadow:mapping />

分布式治理

配置项说明

命名空间: http://shardingsphere.apache.org/schema/shardingsphere/governance/governance-5.0.0.xsd

<governance:reg-center />

ShardingSphere-4.x

数据分片

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/sharding/sharding-4.0.0.xsd

<sharding:data-source />

<sharding:sharding-rule />

<sharding:table-rules />

<sharding:table-rule />

<sharding:binding-table-rules />

<sharding:binding-table-rule />

<sharding:broadcast-table-rules />

<sharding:broadcast-table-rule />

<sharding:standard-strategy />

<sharding:complex-strategy />

<sharding:inline-strategy />

<sharding:hint-database-strategy />

<sharding:none-strategy />

<sharding:key-generator />

Properties

属性配置项，可以为以下自增列值生成器的属性。

SNOWFLAKE

<sharding:encrypt-rule />

<sharding:props />

读写分离

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/masterslave/master-slave.xsd

<https://www.xnip.cn/doc/cZMUP36QKVmaster-slave:data-source />

<master-slave:props />

<master-slave:load-balance-algorithm /> 4.0.0-RC2 版本 添加

数据脱敏

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/encrypt/encrypt.xsd

<encrypt:data-source />

<encrypt:encryptors />

<encrypt:encryptor />

<encrypt:tables />

<encrypt:table />

<encrypt:column />

<encrypt:props />

治理

数据分片 + 治理

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/orchestration/orchestration.xsd

<orchestration:sharding-data-source />

读写分离 + 治理

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/orchestration/orchestration.xsd

<orchestration:master-slave-data-source />

数据脱敏 + 治理

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/orchestration/orchestration.xsd

<orchestration:encrypt-data-source />

治理注册中心

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/orchestration/orchestration.xsd

<orchestration:registry-center />

ShardingSphere-3.x

数据分片

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/sharding/sharding.xsd

<sharding:data-source />

<sharding:sharding-rule />

<sharding:table-rules />

<sharding:table-rule />

<sharding:binding-table-rules />

<sharding:broadcast-table-rule />

<sharding:standard-strategy />

<sharding:complex-strategy />

<sharding:inline-strategy />

<sharding:hint-database-strategy />

<sharding:none-strategy />

<sharding:props />

<sharding:config-map />

读写分离

配置项说明

命名空间：http://apache.shardingsphere.org/schema/shardingsphere/masterslave/master-slave.xsd

<https://www.xnip.cn/doc/cZMUP36QKVmaster-slave:data-source />

<master-slave:config-map />

<master-slave:props />

治理

数据分片 + 数据治理

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/orchestration/orchestration.xsd

<orchestration:sharding-data-source />

读写分离 + 数据治理

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/orchestration/orchestration.xsd

<orchestration:master-slave-data-source />

数据治理注册中心

配置项说明

命名空间：http://shardingsphere.apache.org/schema/shardingsphere/orchestration/orchestration.xsd

<orchestration:registry-center />

ShardingSphere-2.x

数据分片

配置项说明

<sharding:data-source/>

定义sharding-jdbc数据源

<sharding:sharding-rule/>

<sharding:table-rules/>

<sharding:table-rule/>

<sharding:binding-table-rules/>

<sharding:binding-table-rule/>

<sharding:standard-strategy/> 标准分片策略，用于单分片键的场景

<sharding:complex-strategy/> 复合分片策略，用于多分片键的场景

<sharding:inline-strategy/> inline表达式分片策略

<sharding:hint-database-strategy/> Hint方式分片策略

<sharding:none-strategy/> 不分片的策略

<sharding:props/>

读写分离

配置项说明

<https://www.xnip.cn/doc/cZMUP36QKVmaster-slave:data-source/> 定义sharding-jdbc读写分离的数据源

Spring格式特别说明

如需使用inline表达式，需配置ignore-unresolvable为true，否则placeholder会把inline表达式当成属性key值导致出错。

分片算法表达式语法说明

inline表达式特别说明

${begin..end} 表示范围区间

${[unit1, unit2, unitX]} 表示枚举值

inline表达式中连续多个${…}表达式，整个inline最终的结果将会根据每个子表达式的结果进行笛卡尔组合，例如正式表inline表达式如下：

dbtbl_${['online', 'offline']}_${1..3}

最终会解析为dbtbl_online_1，dbtbl_online_2，dbtbl_online_3，dbtbl_offline_1，dbtbl_offline_2和dbtbl_offline_3这6张表。

字符串内嵌groovy代码

表达式本质上是一段字符串，字符串中使用${}来嵌入groovy代码。

data_source_${id % 2 + 1}

上面的表达式中data_source_是字符串前缀，id % 2 + 1是groovy代码。

治理

Zookeeper标签说明

Etcd配置示例