Mycat配置文件Schema.xml详解

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种：

  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中MYSQL可以使用select user()
• Oracle可以使用select 1 from dual

7. writeHost标签、readHost标签

• writeHost指定写实例、readHost指定读实例，组着这些读写实例来满足系统的要求。在一个dataHost内可以定义多个writeHost和readHost。但是，如果writeHost指定的后端数据库宕机，那么这个writeHost绑定的所有readHost都将不可用。
• host属性 用于标识不同实例，一般writeHost我们使用M1，readHost我们用S1。