Amoeba 高级特性

本节讲述如何使用Amoeba高级特性。负载均衡、数据切分、如何编写数据切分规则等。

1. 负载均衡特性
   Amoeba 不仅仅提供普通的连接池功能，而还提供了虚拟的连接池。
   Virtual DbServer Configuration
1. <dbserver name="multiPool" virtual="true">  
2.     <poolconfig>  
3.         <classname>com.meidusa.amoeba.server.MultipleServerPool</classname>  
4.         <!-- 负载均衡参数 1=ROUNDROBIN , 2=WEIGHTBASED -->  
5.         <property name="loadbalance">1</property>  
6.         <!-- 参与该pool负载均衡的poolName列表以逗号分割 -->  
7.         <property name="poolNames">server1,server2</property>  
8.     </poolconfig>  
9. </dbserver>  
<dbserver name="multiPool" virtual="true"> <poolconfig> <classname>com.meidusa.amoeba.server.MultipleServerPool</classname> <!-- 负载均衡参数 1=ROUNDROBIN , 2=WEIGHTBASED --> <property name="loadbalance">1</property> <!-- 参与该pool负载均衡的poolName列表以逗号分割 --> <property name="poolNames">server1,server2</property> </poolconfig> </dbserver>
Virtual dbserver 参数配置说明：

配置项	是否必选	默认值	说明
className	否		默认值：com.meidusa.amoeba.server.MultipleServerPool
loadbalance	是	1	负载均衡参数 1=ROUNDROBIN（轮询方式） , 2=WEIGHTBASED（根据当前活动连接数。活动连接少的优先）
poolNames	是	空	以逗号分割的pool name list（比如：server1,server2）
virtual	否	false	如果该值为true，则className 默认值为com.meidusa.amoeba.server.MultipleServerPool

2. 开启QueryRouter 查询功能，配置规则文件
   queryRouter Tag Configuration
   
   1. <queryRouter>  
   2.     <className>com.meidusa.amoeba.mysql.parser.MysqlQueryRouter</className>  
   3.       
   4.     <property name="ruleConfig">./conf/rule.xml</property>  
   5.     <property name="functionConfig">./conf/functionMap.xml</property>  
   6.       
   7.     <property name="needParse">true</property>  
   8.     <property name="LRUMapSize">1500</property>  
   9.     <property name="defaultPool">server1</property>  
   10.       
   11.     <property name="writePool">server1</property>  
   12.     <property name="readPool">server1</property>  
   13.       
   14. </queryRouter>  
   <queryRouter> <className>com.meidusa.amoeba.mysql.parser.MysqlQueryRouter</className> <property name="ruleConfig">./conf/rule.xml</property> <property name="functionConfig">./conf/functionMap.xml</property> <property name="needParse">true</property> <property name="LRUMapSize">1500</property> <property name="defaultPool">server1</property> <property name="writePool">server1</property> <property name="readPool">server1</property> </queryRouter>

   配置项	是否必选	默认值	说明
   className	是	空	QueryRouter实现类，Amoeba For Mysql（com.meidusa.amoeba.mysql.parser.MysqlQueryRouter）。
   functionConfig	否	空	用于解析sql 函数的配置文件，如果不配置则将不解析包含函数sql或者解析的不完整。
   ruleConfig	否	空	数据切分规则配置文件，如果不配置则sql数据切分功能将不能用
   needParse	否	true	是否对 sql进行parse，如果false 则将不能使用数据切分、读写分离等功能
   defaultPool	是	空	needParse=false、无法解析query、不满足切分规则的、writePool|readPool == null情况。 所有sql 将在默认得dbServer上面执行。(必选)
   writePool	否	空	启用needParse 功能，并且没有匹配到数据切分规则，则 update、insert、delete 语句将在这个pool中执行
   readPool	否	空	启用needParse 功能，并且没有匹配到数据切分规则，则 select 语句将在这个pool中执行
   LRUMapSize	否	1000	statment cache ，存放 sql 解析后得到的statment

3. 如何编写ruleConfig 配置项的 规则文件，具体可以参阅sqlJep
   
   TableRule、Rule、QueryRouter 中返回Pool的优先级别：
   规则中Pool优先级别： Rule > TableRule > QueryRouter
   读、写、默认的Pools优先级别：readPools | writePools > defaultPools
   
   Rule Configuration
   
   1. <?xml version="1.0" encoding="gbk"?>  
   2.   
   3. <ruleList>  
   4.     <tableRule name="ACCOUNT" schema="test" defaultPools="server1,server2,server3" readPools="" writePools="">  
   5.         <rule name="rule1">  
   6.             <parameters>ID</parameters>  
   7.             <expression><![CDATA[ ID <= 1000000]]></expression>  
   8.             <defaultPools>server1</defaultPools>  
   9.             <!--  
   10.             <readPools/>  
   11.             <writePools/>  
   12.             -->  
   13.         </rule>  
   14.           
   15.         <rule name="rule2">  
   16.             <parameters>ID</parameters>  
   17.             <expression><![CDATA[ ID between 1000001 and 2000000 ]]></expression>  
   18.             <defaultPools>server2</defaultPools>  
   19.         </rule>  
   20.           
   21.         <rule name="rule4">  
   22.             <parameters>ID</parameters>  
   23.             <expression><![CDATA[ ID > 20000000 ]]></expression>  
   24.             <defaultPools>server3</defaultPools>  
   25.         </rule>  
   26.     </tableRule>  
   27.       
   28. </ruleList>  
   <?xml version="1.0" encoding="gbk"?> <ruleList> <tableRule name="ACCOUNT" schema="test" defaultPools="server1,server2,server3" readPools="" writePools=""> <rule name="rule1"> <parameters>ID</parameters> <expression><![CDATA[ ID <= 1000000]]></expression> <defaultPools>server1</defaultPools> <!-- <readPools/> <writePools/> --> </rule> <rule name="rule2"> <parameters>ID</parameters> <expression><![CDATA[ ID between 1000001 and 2000000 ]]></expression> <defaultPools>server2</defaultPools> </rule> <rule name="rule4"> <parameters>ID</parameters> <expression><![CDATA[ ID > 20000000 ]]></expression> <defaultPools>server3</defaultPools> </rule> </tableRule> </ruleList>
   Table Rule 参数配置说明：

   配置项	是否必选	默认值	说明
   name	是	空	数据库表名
   schema	是	空	数据库schema
   defaultPools	否	空	假设 Table:test 被切分成2个数据库，那么defaultPools应该写上所有test表所在的Pool，以逗号分割
   readPools	否	空	当您配置了该属性，则相当于启用读写分离规则，多个Pool以逗号分割
   writePools	否	空	当您配置了该属性，则相当于启用读写分离规则，多个Pool以逗号分割

   
   Expression Rule 参数配置说明：

   配置项	是否必选	默认值	说明
   name	是	空	规则名称，唯一
   parameters	否	空	一般是表中的字段。，多个Parameter以逗号分割
   expression	是	空	这条规则的表达式，类似sql，具体可以参阅sqlJep
   defaultPools	否	空	如果sql查询条件与表达式有交集的时候，而且 readPools、writePools 没有被配置，则返回这个值
   readPools	否	空	当您配置了该属性，如果sql查询条件与表达式有交集，而且是select 语句则返回该值
   writePools	否	空	当您配置了该属性，如果sql查询条件与表达式有交集，而且是update、delete、insert 语句则返回该值

4.