Schema.xml作为Mycat中最重要的配置文件之一,管理着Mycat的逻辑库、表、分片规则、DataNode以及DataSource。
1.Schema标签
<schema name="TESTDB" checkSQLschema="false" sqlMaxLimit="100"></schema>
Schema标签用于定义Mycat实例中的逻辑库,Mycat可以有多个逻辑库,每个逻辑库都有自己的相关配置。
标签相关属性:
- dataNode
该属性用天绑定逻辑库到某个具体的database上,1.3版本如果配置了dataNode,则不可以配置分片表,1.4可以配置分片表信息。
1.3版本的配置如下:
<schema name="USERDB" checkSQLschema="false" sqlMaxLimit="100" dataNode="dn1">
<!—schema标签上配置了dataNode,在1.3版本中,这里面不能配置任何表-->
</schema>
1.4及以后的配置如下:
<schema name="USERDB" checkSQLschema="false" sqlMaxLimit="100" dataNode="dn2">
<!—配置需要分片的表-->
<table name=“tuser” dataNode=”dn1”/>
</schema>
那么现在tuser就绑定到dn1所配置的具体database上,可以直接访问这个database,没有配置的表则会走默认节点dn2,这里注意没有配置在分片里面的表工具查看无法显示,但可以正常使用。
- checkSQLschema
当设置成true时,如果sql语句中的表前面加有数据库名 如:select * from TESTDB.tuser,则Mycat会把sql语句中的数据库名去掉修改成:select * from tuser ,一般设置成false。
- sqlMaxLimit
该值为一整数,如:100,则当执行sql:select * from tuser时,和执行select * from tuser limit 100,如果sql语句中显式指定limit大小,以显示指定的大小为准。注意,如果运行的schema为非拆分库的,该属性不会生效。
2.dataNode标签
<dataNode name="dn1" dataHost="lch3307" database="db1" ></dataNode>
dataNode标签定义了Mycat中的数据节点,也就是通常所说的数据分片,一个dataNode标签就是一个独立的数据分片。
dataNode标签相关属性:
- name
定义数据节点的名字,这个名字需要唯一。
- dataHost
定义分片属于哪个数据库实例(一个逻辑名称)。
- database
这个是数据库中的真实数据库名称。
3.dataHost标签
<dataHost name="localhost1" maxCon="1000" minCon="10" balance="0"
writeType="0" dbType="mysql" dbDriver="native" switchType="1" slaveThreshold="100">
<heartbeat>select user()</heartbeat>
<writeHost host="hostM1" url="192.192.16.34:3306" user="root"
password="Falsesoul1207">
<readHost host="hostS2" url="192.192.16.31:3306" user="root" password="Falsesoul1207"/>
</writeHost>
</dataHost>
dataHost标签的相关属性:
- name
唯一标识dataHost标签,供上层的标签使用。
- maxCon
每个读写实例连接池的最大连接数,标签内嵌套的writeHost、readHost标签都会使用这个属性值来实例化出连接池的最大连接数。
- minCon
每个读写实例连接池的最小连接,即初始化连接池的大小。
- balance
负载均衡类型,目前有以下几种取值:
balance="0",不开启读写分离机制,所有读操作都会发送到当前可用的writeHost上。(针对如上配置,所有读请求全落到了writeHost(34)上)
balance="1",全部的readHost与stand by writeHost参与select语句的负载均衡,简单的说,当双主双从模式(M1->S1,M2->S2,并且M1和M2互为主备),正常情况下,M2,S1,S2都参与select语句的负载均衡。(针对如上配置,所有读请求全落到了readHost(31)上)
balance="2",所有读操作都随机的在writeHost、readHost上分发。(针对如上配置,所有读请求全部落到writeHost(34)和readHost(31)上)
balance="3",所有读请求随机的分发到writeHost对应的readHost执行,writeHost不负担读压力,注意balance=3只在1.4及以后的版本才生效。(针对如上配置,所有读请求全落到了readHost(31)上)
- writeType
负载均衡类型,目前的取值有几种:
writeType="0",所有写操作发送到配置的第一个writeHost,第一个挂了切到还生存的第二个writeHost,重新启动后已切换后的为准,切换记录在配置文件中:dnindex.properties,dnindex.properties为本地缓存相关配置,通常用于主从切换记录,记录当前所用的writeHost的index(第一个为0,第二个为1,依次类推),不能删除和擅自修改。
writeType="1",所有写操作都随机的发送到配置的writeHost,1.5以后废弃不推荐。
- dbType
指定后端连接数据库类型,目前支持二进制的mysql协议,还有其他使用JDBC连接的数据库,如:mongodb、oracle、spark等。
- dbDriver
指定连接后端数据库使用的Driver,目前可选的值有native和JDBC。使用native的话,因为这个值执行的是二进制的mysql协议,所以可以使用mysql和maridb。其他类型的数据库则需要使用JDBC驱动来支持,使用JDBC的把对应驱动JAR包放到MYCAT\lib目录下,并检查驱动JAR包中包括如下目录结构的文件:META-INF\services\java.sql.Driver。在这个文件内写上具体的 Driver 类名,例如: com.mysql.jdbc.Driver。
- switchType
-1 表示不自动切换
1 默认值,自动切换
2 基于Mysql主从同步的状态决定不否切换
3 基于Mysql galary cluster的切换机制(适合集群)
心跳语句为 show status like 'wsrep%'
dataHost的子标签如下:
- Heartbeat
这个标签指明用于和后端数据库进行心跳检查的语句。
2.writeHost、readHost
这两个标签都指定后端数据库的相关配置给mycat,用于实例化后端连接池。writeHost指定写实例,readHost指定读实例。在一个dataHost内可以定义多个writeHost和readHost,但是,如果writeHost指定的后端数据库宕机,那么这个writeHost绑定的所有readHost都将不可用,由于这个writeHost宕机系统会自动检测到,并切换到备用的writeHost上去。
- host
用于标示不同实例,一般writeHost我们使用*M1,readHost我们用*S1。
- url
后端数据库连接地址。
- user和password
后端数据库的用户名和密码
- weight
权重,配置在readHost中作为读节点的权重(1.4以后版本支持)
- usingDecrypt
是否对密码加密,默认是0,否。