Schema.xml文件
<?xml version="1.0"?>
<!DOCTYPE mycat:schema SYSTEM "schema.dtd">
<mycat:schema xmlns:mycat="http://io.mycat/">
<schema name="mycat" checkSQLschema="false" sqlMaxLimit="100">
<table name="user" dataNode="node3306,node3308" rule="auto-sharding-long" />
</schema>
<dataNode name="node3306" dataHost="host3306" database="testdb" />
<dataNode name="node3308" dataHost="host3308" database="testdb" />
<dataHost name="host3306" maxCon="1000" minCon="10" balance="1"
writeType="0" dbType="mysql" dbDriver="native" switchType="1" slaveThreshold="100">
<heartbeat>select user()</heartbeat>
<writeHost host="hostM1" url="47.94.93.93:3306" user="root" password="123456">
<readHost host="hostS2" url="47.94.93.93:3307" user="root" password="123456" />
</writeHost>
</dataHost>
<dataHost name="host3308" maxCon="1000" minCon="10" balance="0"
writeType="0" dbType="mysql" dbDriver="native" switchType="1" slaveThreshold="100">
<heartbeat>select user()</heartbeat>
<writeHost host="hostM1" url="47.94.93.93:3308" user="root"
password="123456">
</writeHost>
</dataHost>
</mycat:schema>
标签及属性详解
1.schema标签
- dataNode该属性用于绑定具体的database到逻辑库上
- sqlMaxLimit当该值设置为某个数值时。每条执行的SQL语句,如果没有加上limit语句,MyCat也会自动的加上所对应的值。
2.Table 标签(定义了MyCat中的逻辑表,所有需要拆分的表都需要在这个标签中定义)
- name属性 定义逻辑表的表名,这个名字就如同我在数据库中执行create table命令指定的名字一样,同个schema标签中定义的名字必须唯一。
- dataNode属性 定义这个逻辑表所属的dataNode, 该属性的值需要和dataNode标签中name属性的值相互对应。
- rule属性 该属性用于指定逻辑表要使用的规则名字,规则名字在rule.xml中定义,必须与tableRule标签中name属性属性值一一对应。
- primaryKey属性 该逻辑表对应真实表的主键
- type属性 该属性定义了逻辑表的类型,目前逻辑表只有“全局表”和”普通表”两种类型。对应的配置:全局表:global。普通表:不指定该值为globla的所有表。
- autoIncrement属性 使用autoIncrement=“true”指定这个表有使用自增长主键,这样mycat才会不抛出分片键找不到的异常。使用autoIncrement=“false” 来禁用这个功能,当然你也可以直接删除掉这个属性。默认就是禁用的。
- needAddLimit属性:指定表是否需要自动的在每个语句后面加上limit限制。这个属性默认为true,你也可以设置成false`禁用掉默认行为。
3. childTable标签(childTable标签用于定义E-R分片的子表。通过标签上的属性与父表进行关联)
- name属性 定义子表的表名。
- joinKey属性 插入子表的时候会使用这个列的值查找父表存储的数据节点。
- parentKey属性 属性指定的值一般为与父表建立关联关系的列名。程序首先获取joinkey的值,再通过parentKey属性指定的列名产生查询语句,通过执行该语句得到父表存储在哪个分片上。从而确定子表存储的位置。
- primaryKey属性 同table标签
- needAddLimit属性 同table标签。
4. dataNode标签
-
dataNode 标签定义了MyCat中的数据节点,也就是我们通常说所的数据分片。一个dataNode 标签就是一个独立的数据分片。例子中所表述的意思为:使用名字为lch3307数据库实例上的db1物理数据库,这就组成一个数据分片,最后,我们使用名字dn1标识这个分片。
-
name属性 定义数据节点的名字,唯一,我们需要在table标签上应用这个名字,来建立表与分片对应的关系。
-
dataHost属性 是引用dataHost标签上定义的name属性。
-
database属性 database是指数据库
5. dataHost标签 作为Schema.xml中直接定义了具体的数据库实例、读写分离配置和心跳语句
-
name属性 唯一标识dataHost标签,供上层的标签使用。
-
maxCon属性 指定每个读写实例连接池的最大连接。
-
minCon属性 指定每个读写实例连接池的最小连接。
-
balance属性 负载均衡类型,目前的取值有4种:
- balance=“0”, 不开启读写分离机制,所有读操作都发送到当前可用的writeHost上。
- balance=“1”,所有读操作都随机的发送到readHost。全部的readHost与stand by writeHost参与select语句的负载均衡,简单的说,当双主双从模式(M1->S1,M2->S2,并且M1与 M2互为主备),正常情况下,M2,S1,S2都参与select语句的负载均衡。
- balance=“2”,所有读操作都随机的在writeHost、readhost上分发。
- balance=“3”,所有读请求随机的分发到wiriterHost对应的readhost执行,writerHost不负担读压力
-
writeType属性 writeType属性负载均衡类型,目前的取值有3种:
- writeType=“0”, 所有写操作发送到配置的第一个writeHost,第一个挂了切到还生存的第二个writeHost,重新启动后已切换后的为准,切换记录在配置文件中:dnindex.properties.
- writeType=“1”,所有写操作都随机的发送到配置的writeHost,1.5以后废弃不推荐。
- writeType=“2”,不执行写操作
-
switchType指的是切换的模式,目前的取值也有4种:
- switchType=’-1’ 表示不自动切换
- switchType='1’默认值,表示自动切换
- switchType=‘2’ 基于MySQL主从同步的状态决定是否切换,心跳语句为 show slave status
- switchType='3’基于mysql galary cluster的切换机制(适合集群)(1.4.1),心跳语句为 show status like ‘wsrep%’。
-
dbType属性 指定后端连接的数据库类型,目前支持二进制的mysql协议,还有其他使用JDBC连接的数据库。例如:MongoDB、Oracle、Spark 等。
6. heartbeat标签(指明用于和后端数据库进行心跳检查的语句)
- Mysql中MYSQL可以使用select user()
- Oracle可以使用select 1 from dual
7. writeHost标签、readHost标签
- writeHost指定写实例、readHost指定读实例,组着这些读写实例来满足系统的要求。在一个dataHost内可以定义多个writeHost和readHost。但是,如果writeHost指定的后端数据库宕机,那么这个writeHost绑定的所有readHost都将不可用。
- host属性 用于标识不同实例,一般writeHost我们使用M1,readHost我们用S1。