1. mycat下载
Mycat-server-1.6.7.4-release-20200105164103-win.tar.gz
2.配置conf/server.xml
<user name="root" defaultAccount="true">
<property name="password">123456</property>
<property name="schemas">TESTDB</property>
<property name="defaultSchema">TESTDB</property>
<property name="readOnly">false</property>
</user>
3.配置conf/schema.xml
<?xml version="1.0"?>
<!DOCTYPE mycat:schema SYSTEM "schema.dtd">
<mycat:schema xmlns:mycat="http://io.mycat/">
<schema name="TESTDB" checkSQLschema="true" sqlMaxLimit="100">
<table name="test" primaryKey="id" dataNode="dn1,dn2" rule="mod-long"/>
</schema>
<dataNode name="dn1" dataHost="localhost" database="lmtest"/>
<dataNode name="dn2" dataHost="remotehost" database="lmtest"/>
<dataHost name="localhost" maxCon="1000" minCon="10" balance="0" writeType="0" dbType="mysql" dbDriver="native" switchType="1" slaveThreshold="100">
<heartbeat>select user()</heartbeat>
<writeHost host="hostM1" url="localhost:3306" user="root" password="root"></writeHost>
</dataHost>
<dataHost name="remotehost" maxCon="1000" minCon="10" balance="0" writeType="0" dbType="mysql" dbDriver="native" switchType="1" slaveThreshold="100">
<heartbeat>select user()</heartbeat>
<writeHost host="hostM1" url="172.16.33.60:3306" user="itsv-manager" password="123456"></writeHost>
</dataHost>
</mycat:schema>
一、<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 属性
writeType="0", 所有写操作发送到配置的第一个 writeHost,第一个挂了切到还生存的第二个 writeHost, 重新启动后已切换后的为准,切换记录在配置文件中:dnindex.properties .
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,同时使用加密程序对密码加密