schema.xml文件详解

MyCatschema.xml 详解
1.读写分离文件主要为： 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" dataNode="dn1">
		<table name="travelrecord" dataNode="dn1,dn2,dn3" rule="auto-sharding-long" />
		<table name="company" primaryKey="ID" type="global" dataNode="dn1,dn2,dn3" />
		<table name="goods" primaryKey="ID" type="global" dataNode="dn1,dn2" />
		<table name="hotnews" primaryKey="ID" autoIncrement="true" dataNode="dn1,dn2,dn3"
		   rule="mod-long" />
			<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>
		</schema>
	<dataNode name="dn1" dataHost="localhost1" database="db1" />
	<dataNode name="dn2" dataHost="localhost1" database="db2" />
	<dataNode name="dn3" dataHost="localhost1" database="db3" />
	<dataHost name="localhost1" maxCon="1000" minCon="10" balance="0"
			  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="123456">
			<!-- can have multi read hosts -->
			<readHost host="hostS2" url="192.168.1.200:3306" user="root" password="xxx" />
		</writeHost>
		<writeHost host="hostS1" url="localhost:3316" user="root"
				   password="123456" />
		<!-- <writeHost host="hostM2" url="localhost:3316" user="root" password="123456"/> -->
	</dataHost>
	</mycat:schema>

2.上图所示是MyCat1.6版本的schema.xml的配置文件
	一、<schema/>标签解释
		1）name属性是逻辑库，该值需要与server.xml文件中的<property name="schemas">中的值存在
			两者关系是这样的：
				server中的schemas值为登录进mycat时显示的数据库名，如果没有，无法显示，你在命令行中无法使用该数据库，程序语句运行未进行验证，欢迎大佬进行指教，但是如果存在的数据库名，在schema.xml中的<schema/>标签必须存在，如果不存在必定报错，而且此时这种错误无法在命令行显示出来，即便你mycat的启动和重启都不在命令界面报错，因此每次修改mycat文件必须使用mycat console测试，没有报错再进行mycat start 或者mycat restart启动。
		2）checkSQLschema的值是布尔类型，如果是True那么如果是select * from TESTDB.travelrecord;MyCat会把语句修改成select * from db1.travelrecord; 避免数据库报报**（ERROR 1146 (42S02): Table ‘testdb.travelrecord’ doesn’t exist）。
		3）sqlMaxLimit该属性用来设置sql语句的查询条数，类似于limit，如果sql语句中带上了limit，则该属性不小，针对未被拆分的库也无效，需要sql语句手动加入limit。
		4）dataNode对应下面的dataNode标签 属性值必须与dataNode标签的name值一致才能正确选择数据源。
		5）rule该属性用于指定逻辑表要使用的规则名字，规则名字在rule.xml中定义，必须与tableRule标签中name属性属性值一一对应。 
	二、<table/> 
			table定义了mycat的逻辑表，把实体表拆分之后进行重新定义。
			<table name="travelrecord" dataNode="dn1,dn2,dn3" rule="auto-sharding-long" ></table> 
		1）name属性就是逻辑库中的逻辑表名，和create table中的table一致，必须要全库唯一。
		2）dataNode对应下面的dataNode标签 属性值必须与dataNode标签的name值一致才能正确选择数据源。
		3）该属性用于指定逻辑表要使用的规则名字规则名字在rule.xml中定义，必须与tableRule标签中name属性属性值一一对应。
		4）ruleRequired该属性用来判断逻辑表是否绑定分片规则，如果该属性值为True，如果未绑定分片规则则会报错。
		5）primaryKey值对应了真实表的主键，
		6）type属性 分为全局表和非全局表。
			全局表指大多数节点的相同名字表，修改会全部进行修改，非全局表，type值未global时，该表就是全局表。
		7）autoincrement属性
			mysql对于非自然增长的主键，使用select  last_insert_id()；结果会等于0，如果需要这个需要在这个表上加上自增主键，因此可以在table标签内加入autoincrement，属性值为True。
		8）needAddLimit 属性 
			指定表是否需要linmit语句，默认为True。
	三、<dataNode/>标签
		dataNode 标签定义了MyCat中的数据节点，也就是我们通常说所的数据分片。一个dataNode标签就是一个独立的数据分片。 
		1）name 属性 
			定义了数据节点的名字，该属性必须唯一。
		2）dataHost 属性 
			该属性用于定义该分片属于哪个数据库实例的，属性值是引用 dataHost 标签上定义的 name 属性。 
		3）database 属性 
			该属性用于定义该分片属性哪个具体数据库实例上的具体库，因为这里使用两个纬度来定义分片，就是：实例+具体的库。因为每个库上建立的表和表结构是一样的。所以这样做就可以轻松的对表进行水平拆分。 
	四：dataHost 标签 
		作为 Schema.xml中最后的一个标签，该标签在mycat逻辑库中也是作为最底层的标签存在，直接定义了具体的数据库实例、读写分离配置和心跳语句
		1）name 属性 
			唯一标识 dataHost 标签，供上层的标签使用。 
		2）maxCon 属性 
			指定每个读写实例连接池的最大连接。也就是说，标签内嵌套的 writeHost、readHost 标签都会使用这个属性的值来实例化出连接池的最大连接数。
		3）minCon 属性 
			指定每个读写实例连接池的最小连接，初始化连接池的大小。 
		4）balance 属性 
			1）.balance="0",不开启读写分离机制，所有读操作都发送到当前可用的writeHost上。
			2）balance="1",全部的readHost与stand by writeHost参与select语句的负载均衡，简单的说，当双主双从模式（M1->S1，M2->S2，并且M1与M2互为主备），正常情况下，M2，S1，S2都参加select语句的负载均衡。
			3).balance="2".所有读操作都随机的在writeHost，readHost上分发。
			4).balance="3"，所有读请求随机的分发到readhost执行，writeHost不负担读压力。
		5）writeType 属性 
			1. writeType="0", 所有写操作发送到配置的第一个 writeHost，第一个挂了切到还生存的第二个 writeHost， 重新启动后已切换后的为准，切换记录在配置文件中:dnindex.properties . 
			2. writeType="1"，所有写操作都随机的发送到配置的 writeHost，1.5 以后废弃不推。switchType 属 性 
			- -1 表示不自动切换。 
			- 1 默认值，自动切换。 
			- 2 基于 MySQL 主从同步的状态决定是否切换。 
		6）dbType 属性 
			指定后端连接的数据库类型，目前支持二进制的 mysql 协议，还有其他使用 JDBC 连接的数据库。例如： mongodb、oracle、spark 等。 
		7）dbDriver 属性 
			指定连接后端数据库使用的 Driver，目前可选的值有 native 和 JDBC。
		8）switchType 属性 
			-1 表示不自动切换 
			1 默认值，自动切换 
			2 基于 MySQL 主从同步的状态决定是否切换
			心跳语句为 show slave status 
			3 基于 MySQL galary cluster 的切换机制（适合集群）（1.4.1） 
			心跳语句为 show status like ‘wsrep%
		9）tempReadHostAvailable 属性 
			如果配置了这个属性 writeHost 下面的 readHost 仍旧可用，默认 0 可配置（0、1）。 

	五：heartbeat 标签 
		这个标签内指明用于和后端数据库进行心跳检查的语句。例如,MYSQL 可以使用 select user()，Oracle 可以 使用 select 1 from dual 等
		主从切换的语句必须是：show slave status 
	六：writeHost 标签、readHost 标签 
		这两个标签都指定后端数据库的相关配置给 mycat，用于实例化后端连接池。唯一不同的是，writeHost 指 定写实例、readHost 指定读实例，组着这些读写实例来满足系统的要求。 
		在一个 dataHost 内可以定义多个 writeHost 和 readHost。但是，如果 writeHost 指定的后端数据库宕机， 那么这个 writeHost 绑定的所有 readHost 都将不可用。另一方面，由于这个 writeHost 宕机系统会自动的检测 到，并切换到备用的 writeHost 上去。 
		1）host 属性 
			用于标识不同实例，一般 writeHost 我们使用*M1，readHost 我们用*S1。 
		2）url 属性 
			后端实例连接地址，如果是使用 native 的 dbDriver，则一般为 address:port 这种形式。用 JDBC 或其他的 dbDriver，则需要特殊指定。当使用 JDBC 时则可以这么写：jdbc:mysql://localhost:3306/。 
		3）user 属性 
			后端存储实例需要的用户名字
		4）password 属性 
			后端存储实例需要的密码。 
		5）weight 属性 
			权重 配置在 readhost 中作为读节点的权重
		6）usingDecrypt 属性 
			是否对密码加密默认 0 否 如需要开启配置 1，同时使用加密程序对密码加密