Mycat–实践–05–schema.xml配置
1、位置
{MYCAT_HOME}/conf/schema.xml
2、schema:逻辑库
<schema name="TESTDB" checkSQLschema="false" sqlMaxLimit="100">
2.1、属性说明
name
逻辑库的名字
checkSQLschema
- 数据库前缀设置
- 当该值为true时,例如我们执行语句select * from TESTDB.company,mycat会把语句修改为 select * from company
sqlMaxLimit
- 查询限制条数
- 当该值设置为某个数值时,每条执行的sql语句,如果没有加上limit语句,Mycat会自动加上对应的值。
- 不写的话,默认返回所有的值。
- 需要注意的是,如果运行的schema为非拆分库的,那么该属性不会生效。需要自己sql语句加limit。
3、table:逻辑表
<table name="company" primaryKey="ID" type="global" dataNode="dn1,dn2,dn3" />
3.1、属性说明
name
- 表名
- 物理数据库中的表名(真实表)
dataNode
- 表存储到哪些节点
- 多个节点用逗号分隔。
primaryKey
- 主键字段名
- 分片规则
- 能不用主键做分片规则的话,尽量不用(提高性能方案)
autoIncrement
- 是否自增
- mysql 对非自增长主键,使用last_insert_id()是不会返回结果的,只会返回0。所以,只有定义了自增长主键的表,才可以用last_insert_id()返回主键值。
- MyCat 提供了自增长主键功能,但是对应到 mysql 节点上数据表,没有auto_increment,那么在 MyCat 层调用last_insert_id() 也是不会返回结果的。
rule
- 分片规则名
type
- 该属性定义了逻辑表的类型
- 目前逻辑表只有全局表和普通表。
- 全局表: global
- 普通表:无
needAddLimit
- 指定表是否需要自动的在每个语句后面加上limit限制
- 由于使用了分库分表,数据量有时候会特别庞大,这时候执行查询语句,忘记加上limt就会等好久,所以mycat自动为我们加上了limit 100
- 这个属性默认为true,可以自己设置为false禁用。
- 如果使用这个功能,最好配合使用数据库模式的全局序列。
subTables 分表
分表目前不支持Join。
4、childTable:ER 分片的子表
<!-- 逻辑表--ER表:childTable -->
<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>
childTable
- 标签用于定义 E-R 分片的子表
- 通过标签上的属性与父表进行关联。
name
子表的名称
joinKey
子表中字段的名称(与父表关联字表键值)
parentKey
父表中字段名称(与子表关联父表键值)
primaryKey
同 < table > 标签
needAddLimit
同 < table > 标签
5、dataNode:数据节点
- 定义了 MyCat 中的数据节点,也就是我们所说的数据分片。
- 一个 dataNode 就是一个独立的数据分片
<dataNode name="dn1" dataHost="localhost1" database="db1" />
5.1、属性说明
name
- 节点名称
- 这个名字需要唯一。
- 属性与 < table > 标签上定义的 dataNode 对应
dataHost
- 数据库主机名
- 属性与 < dataHost > 标签上定义的 name 对应
database
数据库名
6、dataHost:数据节点
<dataHost name="localhost1" maxCon="1000" minCon="10" balance="0"
writeType="0" dbType="mysql" dbDriver="native" switchType="1" slaveThreshold="100">
<!-- 心跳检测语句 -->
<heartbeat>select user()</heartbeat>
<!-- M1主节点 -->
<writeHost host="M1" url="192.168.187.130:3307" user="root"
password="root">
<!-- 从节点 -->
<readHost host="M1S1" url="192.168.187.130:3308" user="root" password="root" />
<readHost host="M1S2" url="192.168.187.130:3309" user="root" password="root" />
</writeHost>
<!-- M2 主节点 -->
<writeHost host="M2" url="192.168.187.130:3310" user="root"
password="root">
<!-- 从节点 -->
<readHost host="M2S1" url="192.168.187.130:3311" user="root" password="root" />
</writeHost>
</dataHost>
6.1、属性说明
maxCon:每个读写实例连接池的最大连接数
minCon:每个读写实例连接池的最小连接数
balance:负载均衡类型
-
balance=“0”
- 不开启读写分离机制,所有读操作都发送到当前可用的writeHost上
-
balance=“1”
- 全部的readHost与stand by writeHost参与select语句的负载均衡,简单的说,当双主双从模式(M1-S1,M2-S2 并且M1 M2互为主备),正常情况下,M2,S1,S2都参与select语句的负载均衡。
-
balance=“2”
- 所有读操作都随机的在writeHost、readHost上分发
-
balance=“3”:
- 所有读请求随机的分发到writeHst对应的readHost执行
- writeHost不负担读写压力。(1.4之后版本有)
writeType:负载均衡类型(一般指定0即可)
-
writeType=“0”
- 所有写操作发送到配置的第一个 writeHost,第一个挂了切到还生存的第二个writeHost,重新启动后以切换后的为准,切换记录在配置文件中:dnindex.properties。
-
writeType=“1”
- 所有写操作都随机的发送到配置的 writeHost。
- 1.5以后版本废弃,不推荐。
dbType:指定后端连接的数据库类型
- 目前支持二进制的mysql协议,还有其他使用 JDBC 连接的数据库
- mysql
- mongodb
- oracle
- sqlserver
- spark
dbDriver:指定连接后端数据库使用的driver
-
目前可选的值有 native 和 JDBC 。
-
使用 native 的话,因为这个值执行的是二进制的 mysql 协议,所以可以使用 mysql 和 maridb,其他类型的则需要使用JDBC驱动来支持。可以理解为
- mysql 使用 native
- 其他的使用 JDBC
-
如果使用 JDBC 的话需要符合 JDBC4 标准的驱动 jar 放到 mycat\lib 目录下,并检查驱动jar包中包括如下目录结构文件 META-INF\services\java.sql.Driver。 在这个文件写上具体的driver类名,例如 com.mysql.jdbc.Driver。
switchType:主从切换策略 (schema.xml 可以配置多主多从)
- switchType="-1"
- 不自动切换
- switchType=“1”
- 默认值
- 自动切换
- switchType=“2”
- 基于 MySql 主从同步(是否延时)的状态决定是否切换,
- 心跳语句为:show slave status
- 备注:
- switchType=2、slaveThreshold=“100”(设置延时时间)、心跳语句 show slave status 三者结合,从应用层方面来解决主从延时,进行切换操作
- 基于 MySql 主从同步(是否延时)的状态决定是否切换,
7、heartbeat
- 指明用于和后端数据库进行心跳检查的语句。
- MYSQL 可以使用 select user()
- Oracle 可以使用 select 1 from dual
<heartbeat>select user()</heartbeat>
8、writeHost,readHost
<!-- M1主节点 -->
<writeHost host="M1" url="192.168.187.130:3307" user="root"
password="root">
<!-- 从节点 -->
<readHost host="M1S1" url="192.168.187.130:3308" user="root" password="root" />
<readHost host="M1S2" url="192.168.187.130:3309" user="root" password="root" />
</writeHost>
- 指定后端数据库的相关配置,用于实例化后端连接池。
- writeHost 指定写实例
- readHost 指定读实例。
- 在一个 dataHost 内可以定义多个 writeHost 和 readHost。
- 注意:
- 如果 writeHost 指定的后端数据库宕机,那么这个 writeHost 绑定的所有 readHost 都将不可用。
- 如果 writeHost 指定的后端数据库宕机,系统会自动的检测到,并切换到备用的 writeHost 上去。
8.1、属性说明
host
- 用于标识不同实例
- 一般命名
- writeHost 我们使用*M1
- readHost 我们用*S1。
url:物理库URL地址
password:物理库密码
user :物理库用户名
weight:权重
- 配置在 readhost 中作为读节点的权重
usingDecrypt
- 是否对密码加密
- 默认0。
9、schema.xml 配置文件,基于该配置进行介绍
<?xml version="1.0"?>
<!DOCTYPE mycat:schema SYSTEM "schema.dtd">
<mycat:schema xmlns:mycat="http://io.mycat/">
<!-- 逻辑库 TESTDB-->
<schema name="TESTDB" checkSQLschema="false" sqlMaxLimit="100">
<!-- 逻辑表--分片表 rule="auto-sharding-long"-->
<table name="travelrecord" dataNode="dn1,dn2,dn3" rule="auto-sharding-long" />
<!-- 逻辑表--全局表:type="global" -->
<table name="company" primaryKey="ID" type="global" dataNode="dn1,dn2,dn3" />
<table name="goods" primaryKey="ID" type="global" dataNode="dn1" />
<!-- random sharding using mod sharind rule -->
<table name="hotnews" primaryKey="ID" autoIncrement="true" dataNode="dn1,dn2,dn3"
rule="mod-long" />
<table name="employee" primaryKey="ID" dataNode="dn1,dn2"
rule="sharding-by-intfile" />
<!-- 逻辑表--ER表:childTable -->
<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" />
<dataHost name="localhost1" maxCon="1000" minCon="10" balance="0"
writeType="0" dbType="mysql" dbDriver="native" switchType="1" slaveThreshold="100">
<!-- 心跳检测语句 -->
<heartbeat>select user()</heartbeat>
<!-- M1主节点 -->
<writeHost host="M1" url="192.168.187.130:3307" user="root"
password="root">
<!-- 从节点 -->
<readHost host="M1S1" url="192.168.187.130:3308" user="root" password="root" />
<readHost host="M1S2" url="192.168.187.130:3309" user="root" password="root" />
</writeHost>
<!-- M2 主节点 -->
<writeHost host="M2" url="192.168.187.130:3310" user="root"
password="root">
<!-- 从节点 -->
<readHost host="M2S1" url="192.168.187.130:3311" user="root" password="root" />
</writeHost>
</dataHost>
</mycat:schema>