mycat rule.xml详解及使用案例

rule.xml

rule.xml里面就定义了我们对表进行拆分所涉及到的规则定义。我们可以灵活的对表使用不同的分片算法，或者对表使用相同的
算法但具体的参数不同。这个文件里面主要有tableRule和function这两个标签。在具体使用过程中可以按照需求添加tableRule
和function。

tableRule标签

这个标签定义表规则。
定义的表规则，在schema.xml：

<tableRule name="rule1">
 <rule>
 <columns>id</columns>
 <algorithm>func1</algorithm>
 </rule>
</tableRule>

name 属性指定唯一的名字，用于标识不同的表规则。
内嵌的rule标签则指定对物理表中的哪一列进行拆分和使用什么路由算法。
columns 内指定要拆分的列名字。
algorithm 使用function标签中的name属性。连接表规则和具体路由算法。当然，多个表规则可以连接到同一个路由算法上。
标签内使用。让逻辑表使用这个规则进行分片。

function标签

<function name="hash-int"
class="org.opencloudb.route.function.PartitionByFileMap">
<property name="mapFile">partition-hash-int.txt</property>
</function>

name 指定算法的名字。
class 制定路由算法具体的类名字。
property 为具体算法需要用到的一些属性。

案例一: 分片枚举

分片枚举
通过在配置文件中配置可能的枚举id，自己配置分片，本规则适用于特定的场景，比如有些业务需要按照省份或区县来做保存，
而全国省份区县固定的，这类业务使用本条规则，配置如下：

<tableRule name="sharding-by-intfile">
 <rule>
 <columns>user_id</columns>
 <algorithm>hash-int</algorithm>
 </rule>
 </tableRule>
<function name="hash-int" class="org.opencloudb.route.function.PartitionByFileMap">
 <property name="mapFile">partition-hash-int.txt</property>
 <property name="type">0</property>
 <property name="defaultNode">0</property>
 </function>
partition-hash-int.txt 配置：
10000=0
10010=1
DEFAULT_NODE=1

上面columns 标识将要分片的表字段，algorithm 分片函数，
其中分片函数配置中，mapFile标识配置文件名称，type默认值为0，0表示Integer，非零表示String，
所有的节点配置都是从0开始，及0代表节点1
/**

• defaultNode 默认节点:小于0表示不设置默认节点，大于等于0表示设置默认节点

默认节点的作用：枚举分片时，如果碰到不识别的枚举值，就让它路由到默认节点

• 如果不配置默认节点（defaultNode值小于0表示不配置默认节点），碰到
• 不识别的枚举值就会报错，
• like this：can’t find datanode for sharding column:column_name val:ffffffff
  */

案例二: 固定分片hash算法

本条规则类似于十进制的求模运算，区别在于是二进制的操作,是取id的二进制低10位，即id二进制&1111111111。
此算法的优点在于如果按照10进制取模运算，在连续插入1-10时候1-10会被分到1-10个分片，增大了插入的事务控制难度，而
此算法根据二进制则可能会分到连续的分片，减少插入事务事务控制难度。

<tableRule name="rule1">
 <rule>
 <columns>user_id</columns>
 <algorithm>func1</algorithm>
 </rule>
</tableRule>
 <function name="func1" class="org.opencloudb.route.function.PartitionByLong">
 <property name="partitionCount">2,1</property>
 <property name="partitionLength">256,512</property>
 </function>

配置说明：
上面columns 标识将要分片的表字段，algorithm 分片函数，
partitionCount 分片个数列表&#x