Mycat配置文件schema.xml的详解

schema标签的相关属性

dataNode

该属性用于绑定具体的database到逻辑库上

[html]view plain copy
<schema name="TESTDB" checkSQLschema="false" sqlMaxLimit="100"> 
<table name="users" primaryKey="ID"   dataNode="dn1,dn2" rule="rule1"/> 
</schema> 

sqlMaxLimit

当该值设置为某个数值时。每条执行的SQL语句，如果没有加上limit语句，MyCat也会自动的加上所对应的值。

2. table标签

[html]view plain copy
<table name="travelrecord" dataNode="dn1,dn2,dn3" rule="auto-sharding-long" ></table>  

Table 标签定义了MyCat中的逻辑表，所有需要拆分的表都需要在这个标签中定义。

name属性

定义逻辑表的表名，这个名字就如同我在数据库中执行create table命令指定的名字一样，同个schema标签中定义的名字必须唯一。

dataNode属性

定义这个逻辑表所属的dataNode, 该属性的值需要和dataNode标签中name属性的值相互对应。如果需要定义的dn过多可以使用如下的方法减少配置：

[html]view plain copy
        <schema name="TESTDB" checkSQLschema="false" sqlMaxLimit="100"> 
<table name="users" primaryKey="ID"   dataNode="dn1,dn2" rule="rule1"/> 
</schema>  
<dataNode name="dn1" dataHost="localhost1" database="test" />  
        <dataNode name="dn2" dataHost="localhost1" database="test2" /> 

rule属性

该属性用于指定逻辑表要使用的规则名字，规则名字在rule.xml中定义，必须与tableRule标签中name属性属性值一一对应。

primaryKey属性

该逻辑表对应真实表的主键

type属性

该属性定义了逻辑表的类型，目前逻辑表只有“全局表”和”普通表”两种类型。对应的配置：全局表：global。普通表：不指定该值为globla的所有表。

autoIncrement属性

MySQL对非自增长主键，使用last_insert_id()是不会返回结果的，只会返回0。所以，只有定义了自增长主键的表才可以用last_insert_id()返回主键值。mycat目前提供了自增长主键功能，但是如果对应的mysql节点上数据表，没有定义auto_increment，那么在mycat层调用last_insert_id()也是不会返回结果的。由于insert操作的时候没有带入分片键，mycat会先取下这个表对应的全局序列，然后赋值给分片键。这样才能正常的插入到数据库中，最后使用last_insert_id()才会返回插入的分片键值。如果要使用这个功能最好配合使用数据库模式的全局序列。使用autoIncrement=“true” 指定这个表有使用自增长主键，这样mycat才会不抛出分片键找不到的异常。使用autoIncrement=“false” 来禁用这个功能，当然你也可以直接删除掉这个属性。默认就是禁用的。

needAddLimit属性

指定表是否需要自动的在每个语句后面加上limit限制。这个属性默认为true,你也可以设置成false`禁用掉默认行为。

3. childTable标签

childTable标签用于定义E-R分片的子表。通过标签上的属性与父表进行关联

[html]view plain copy
<table name="customer" primaryKey="ID" dataNode="dn1,dn2"  
    rule="sharding-by-intfile">  
    <childTable name="orders" primaryKey="ID" joinKey="customer_id"  
        parentKey="id">  
        <childTable name="order_items" joinKey="order_id"  
            parentKey="id" />  
    </childTable>  
    <childTable name="customer_addr" primaryKey="ID" joinKey="customer_id"  
        parentKey="id" />  
</table>  

name属性

定义子表的表名。

joinKey属性

插入子表的时候会使用这个列的值查找父表存储的数据节点。

parentKey属性

属性指定的值一般为与父表建立关联关系的列名。程序首先获取joinkey的值，再通过**parentKey**属性指定的列名产生查询语句，通过执行该语句得到父表存储在哪个分片上。从而确定子表存储的位置。

primaryKey属性

同table标签所描述的。

needAddLimit属性

同table标签所描述的。

4. dataNode标签

[html]view plain copy
<dataNode name="dn1" dataHost="lch3307" database="db1" ></dataNode>  

dataNode 标签定义了MyCat中的数据节点，也就是我们通常说所的数据分片。一个**dataNode** 标签就是一个独立的数据分片。例子中所表述的意思为：使用名字为lch3307数据库实例上的db1物理数据库，这就组成一个数据分片，最后，我们使用名字dn1标识这个分片。

name属性

定义数据节点的名字，这个名字需要是唯一的，我们需要在table标签上应用这个名字，来建立表与分片对应的关系。

dataHost属性

是引用dataHost标签上定义的name属性。

database属性

database是指数据库

5. dataHost标签

作为Schema.xml中直接定义了具体的数据库实例、读写分离配置和心跳语句，解析下这个标签：

       <?xml version="1.0"?> 
      
<!DOCTYPE mycat:schema SYSTEM "schema.dtd"> 
      
<mycat:schema xmlns:mycat="http://io.mycat/"> 
      
      <schema name="TESTDB" checkSQLschema="false" sqlMaxLimit="100">  
      
      <table name="users" primaryKey="ID"   dataNode="dn1,dn2" rule="rule1"/> 
      
      <!--<table name="users" primaryKey="ID"  dataNode="dn2,dn3" rule="rule1"/> --> 
      
      </schema>  
      
      <dataNode name="dn1" dataHost="localhost1" database="test" />  
      
      <!--<dataNode name="dn1" dataHost="localhost1" database="dmeo" />--> 
      
    <dataNode name="dn2" dataHost="localhost1" database="test2" />  
      
      <dataHost name="localhost1" maxCon="1000" minCon="10" balance="1" writeType="0" dbType="mysql" dbDriver="native" switchType="1"  slaveThreshold="100"> 
      
      <heartbeat>select user()</heartbeat> 
      
      <!-- can have multi write hosts  
      
      <writeHost host="hostM1" url="localhost:3306" user="root" password="root">  
      
      <readHost host="hostS2" url="127.0.0.1:3306" user="root" password="root" /> 
      
      </writeHost> -->  
      
      <writeHost host="hostM1" url="192.168.100.90:3306" user="root" password="root"> 
      
          <readHost host="hostS1" url="192.168.100.90:3306" user="root" password="root"/> 
      
      </writeHost> 
      
        <writeHost host="hostM2" url="localhost:3306" user="root" password="root"/> 
      
      </dataHost>  
      
</mycat:schema>

name属性

唯一标识dataHost标签，供上层的标签使用。

maxCon属性

指定每个读写实例连接池的最大连接。

minCon属性

指定每个读写实例连接池的最小连接。

balance属性

负载均衡类型，目前的取值有4种：

1. balance="0", 不开启读写分离机制，所有读操作都发送到当前可用的writeHost上。

2. balance="1"，所有读操作都随机的发送到readHost。全部的readHost与stand by writeHost参与select语句的负载均衡，简单的说，当双主双从模式(M1->S1，M2->S2，并且M1与 M2互为主备)，正常情况下，M2,S1,S2都参与select语句的负载均衡。

3. balance="2"，所有读操作都随机的在writeHost、readhost上分发。

4. balance="3"，所有读请求随机的分发到wiriterHost对应的readhost执行，writerHost不负担读压力

writeType属性

writeType属性负载均衡类型，目前的取值有3种：

1.writeType="0", 所有写操作发送到配置的第一个writeHost，第一个挂了切到还生存的第二个writeHost，重新启动后已切换后的为准，切换记录在配置文件中:dnindex.properties.

2.writeType="1"，所有写操作都随机的发送到配置的writeHost，1.5以后废弃不推荐。

3.writeType="2"，不执行写操作

switchType指的是切换的模式，目前的取值也有4种：

1. switchType='-1' 表示不自动切换

2. switchType='1' 默认值，表示自动切换

3. switchType='2' 基于MySQL主从同步的状态决定是否切换,心跳语句为 show slave status

4. switchType='3'基于MySQL galary cluster的切换机制（适合集群）（1.4.1），心跳语句为 show status like 'wsrep%'。

dbType属性

指定后端连接的数据库类型，目前支持二进制的mysql协议，还有其他使用JDBC连接的数据库。例如：MongoDB、Oracle、Spark等。

6. heartbeat标签

这个标签内指明用于和后端数据库进行心跳检查的语句。例如,MYSQL可以使用select user()，oracle可以使用select 1 from dual等。这个标签还有一个connectionInitSql属性，主要是当使用Oracla数据库时，需要执行的初始化SQL语句就这个放到这里面来。例如：alter session set nls_date_format='yyyy-mm-dd hh24:mi:ss'

7. writeHost标签、readHost标签

writeHost指定写实例、readHost指定读实例，组着这些读写实例来满足系统的要求。在一个dataHost内可以定义多个writeHost和readHost。但是，如果writeHost指定的后端数据库宕机，那么这个writeHost绑定的所有readHost都将不可用。

host属性

用于标识不同实例，一般writeHost我们使用*M1，readHost我们用*S1。

参考文章:http://blog.csdn.net/l1028386804/article/details/53385637