第115讲：Mycat核心配置文件各项参数的作用以及概念

文章目录

- 1.Mycat配置文件相关概念
- 2.Schema配置文件
- 3.Rule配置文件
- 4.Server配置文件

1.Mycat配置文件相关概念

在Mycat中核心的配置文件有schema.xml和rule.xml以及server.xml三个，其中schema.xml是用来配置数据库、表、读写分离、分片节点、分片规则等信息，rule.xml主要是用来定义拆分表的规则，server.xml包含了mycat的系统配置信息。

Mycat的配置文件都是xml形式的。

2.Schema配置文件

在schema.xml的配置文件中主要包含三组标签：

1）schema标签

<schema name="db_1" checkSQLschema="false" sqlMaxLimit="100" dataNode="sh1"></schema>

schema标签主要用于定义逻辑库的，在一个Mycat实例中，可以配置多个逻辑库，一个逻辑库对应MySQL实例中的一个真实数据库，并且通过Mycat连接后，执行show databases看到的也都是schema中定义的逻辑库列表。

要通过mycat对哪一个数据库处理，就在这里定义该数据库。

schema标签中的重要属性：

name：定义逻辑库的库名，一般和数据库名称保持一致。
checkSQLschema：如果值为flase，当执行的SQL中包含了数据库的名称，执行时会自动去掉数据库名称，必须要进入到该数据库，再执行相应的SQL，一般该值都是true，避免导致SQL无法执行。
sqlMaxLimit：如果在查询SQL时，没有指定分页值，默认引用schema标签中配置的分页大小，避免全表查询。
dataNode：定义逻辑库所属的dataNode，该属性需要与dataNode标签中的name对应，声明逻辑库属于哪一个MySQL节点，多个dataNode逗号分隔。

2）schema标签中的table标签

<table name="TB_ORDER" dataNode="dn1,dn2,dn3" rule="auto-sharding-long" />

table标签用于定义Mycat逻辑库schema下的逻辑表，需要进行特殊处理，如拆分的表都在这里定义。

table标签中的重要属性：

name：定义逻辑表的表名，该表名在逻辑库schema下唯一。
dataNode：定义逻辑表所属的dataNode，该属性需要与dataNode标签中的name对应，声明逻辑表属于哪一个MySQL节点，多个dataNode逗号分隔。
rule：分片规则的名称。
primaryKey：逻辑表对应真实表的主键。
type：
逻辑表的类型，目前逻辑表只有全局表和普通表，如果未配置，就是普通表；全局表，配置为 global。

3）dataNode标签

<dataNode name="sh1" dataHost="mysql-1" database= "db_1" />

dateNode标签是定义数据节点的，schema标签需要与dataNode标签关联，声明逻辑库属于哪个数据库实例上的真实数据库。

dateNode标签中的重要属性：

name：定义数据节点的名称，该名称会被schema标签调用。
dataHost：关联数据库实例主机的名称，引用dataHost标签中的name字段的值。
database：定义后端数据库实例中的真实所在的数据库名称。

3）dataHost标签

在dataHost标签中定义数据库实例信息，读写分离的配置也是在该标签中配置的。

首先为dataHost标签声明一个名称，被dataNode标签调用，然后在dataHost标签中定义writeHost标签，声明写操作路由的数据库实例信息，然后定义readHost标签，定义读操作路由的数据库实例信息。

dataHost标签中的重要属性：

name：定义dataHost标签的名称，要被dataNode标签所关联。
maxCon/minCon：最大连接数（生产环境建议3000以上）/最小连接数。
balance：负载均衡类型。
- 0表示不开启读写分离机制，所有的读操作都发送到当前可用的writeHost上。
- 1表示全部readHost和第一个writeHost参与到select语句的负载均衡中，简单的说，当双主双从的模式下，(M1->S1，M2->S2，并且M1与 M2互为主备)，正常情况下，M2、S1、S2都参与select语句的负载均衡，充当备用的M2不会参与负载均衡。
- 2表示所有的读操作随机在writeHost、readHost上进行分发，MHA一主两从的模式下使用balance=2。
writeType：写操作的分发方式.
- 0表示写操作只转发到第一个writeHost标签的数据库实例，当第一个数据库实例挂掉之后，再换到第二个writeHost标签的数据库实例。
- 1表示随机分发到配置的writeHost标签的数据库实例。
switchType：主从是否切换
- 1表示自动切换，当主库挂掉之后，自动选一个从库作为主库。
- 2表示基于主从同步的状态再决定是否切换。
dbDriver：数据库驱动，支持 native、jdbc

在writeHost标签中也有很多重要的参数，其中readHost标签也是属于writeHost标签内的。

host：定义一个名称。
url：定义数据库的地址。
user：连接数据库的账号。
password：连接数据库的密码。

Schema配置文件的完整关联关系，schema关联dataNode，DataNode关联dataHost。

3.Rule配置文件

在Rule配置文件中主要定义的是分片规则。

在Rule配置文件中主要有两组重要的标签：

<tableRule></tableRule>：在这个标签下定义分片的规则，包括对依据那个字段进行分片，实现这个分片规则要调用哪一个函数来等。
<function></function>：在这个标签下主要定义实现分片规则要用的算法以及分片规则属性。

1）<tableRule></tableRule>标签下重要的参数：

参数	作用
columns	指定分片规则依据的字段
algorithm	指定分片规则实现调用的函数

2）<function></function>标签下重要的参数：

参数	含义
class	指定该分片算法对应的类
mapFile	对应的外部配置文件
type	默认值为0 ; 0 表示Integer , 1 表示String
defaultNode	默认节点默认节点的所用:枚举分片时,如果碰到不识别的枚举值, 就让它路由到默认节点 ; 如果没有默认值,碰到不识别的则报错
count	数据节点的数量
seed	创建murmur_hash对象的种子，默认0
virtualBucketTimes	一个实际的数据库节点被映射为这么多虚拟节点，默认是160倍，也就是虚拟节点数是物理节点数的160倍;virtualBucketTimes*count就是虚拟结点数量
weightMapFile	节点的权重，没有指定权重的节点默认是1。以properties文件的格式填写，以从0开始到count-1的整数值也就是节点索引为key，以节点权重值为值。所有权重值必须是正整数，否则以1代替
bucketMapPath	用于测试时观察各物理节点与虚拟节点的分布情况，如果指定了这个属性，会把虚拟节点的murmur hash值与物理节点的映射按行输出到这个文件，没有默认值，如果不指定，就不会输出任何东西
startIndex	字符子串起始索引
size	字符长度
partitionCount	分区(分片)数量
defaultPartition	默认分片(在分片数量定义时, 字符标示的分片编号不在分片数量内时,使用默认分片)
partitionLength	hash求模基数 ; length*count=1024 (出于性能考虑)
partitionCount	分区数
hashSlice	hash运算位 , 根据子字符串的hash运算 ; 0 代表 str.length(), -1 代表 str.length()-1 , 大于0只代表数字自身 ; 可以理解为substring（start，end），start为0则只表示0
dateFormat	日期格式
sBeginDate	开始日期
sEndDate	结束日期，如果配置了结束日期，则代码数据到达了这个日期的分片后，会重复从开始分片插入
sPartionDay	分区天数，默认值 10 ，从开始日期算起，每个10天一个分区

4.Server配置文件

在server.xml配置文件中主要包含了Mycat的系统配置信息，其中有两个重要的标签：

1）system标签

在system标签中配置的是Mycat的系统属性，包括端口号、SQL统计等等之类的属性。

常用的属性以及含义列表如下。

属性	取值	含义
charset	utf8	设置Mycat的字符集, 字符集需要与MySQL的字符集保持一致
nonePasswordLogin	0,1	0为需要密码登陆、1为不需要密码登陆 ,默认为0，设置为1则需要指定默认账户
useHandshakeV10	0,1	使用该选项主要的目的是为了能够兼容高版本的jdbc驱动, 是否采用HandshakeV10Packet来与client进行通信, 1:是, 0:否
useSqlStat	0,1	开启SQL实时统计, 1 为开启 , 0 为关闭 ; 开启之后, MyCat会自动统计SQL语句的执行情况 ; mysql -h 127.0.0.1 -P 9066 -u root -p 查看MyCat执行的SQL, 执行效率比较低的SQL , SQL的整体执行情况、读写比例等 ; show @@sql ; show @@sql.slow ; show @@sql.sum ;
useGlobleTableCheck	0,1	是否开启全局表的一致性检测。1为开启，0为关闭。
sqlExecuteTimeout	1000	SQL语句执行的超时时间 , 单位为 s ;
sequnceHandlerType	0,1,2	用来指定Mycat全局序列类型，0 为本地文件，1 为数据库方式，2 为时间戳列方式，默认使用本地文件方式，文件方式主要用于测试
sequnceHandlerPattern	正则表达式	必须带有MYCATSEQ或者 mycatseq进入序列匹配流程注意MYCATSEQ_有空格的情况
subqueryRelationshipCheck	true,false	子查询中存在关联查询的情况下,检查关联字段中是否有分片字段 .默认 false
useCompression	0,1	开启mysql压缩协议 , 0 : 关闭, 1 : 开启
fakeMySQLVersion	5.5,5.6	设置模拟的MySQL版本号
defaultSqlParser		由于MyCat的最初版本使用了FoundationDB的SQL解析器, 在MyCat1.3后增加了Druid解析器, 所以要设置defaultSqlParser属性来指定默认的解析器; 解析器有两个 : druidparser 和 fdbparser, 在MyCat1.4之后,默认是druidparser, fdbparser已经废除了
processors	1,2…	指定系统可用的线程数量, 默认值为CPU核心 x 每个核心运行线程数量; processors 会影响processorBufferPool, processorBufferLocalPercent, processorExecutor属性, 所有, 在性能调优时, 可以适当地修改processors值
processorBufferChunk		指定每次分配Socket Direct Buffer默认值为4096字节, 也会影响BufferPool长度, 如果一次性获取字节过多而导致buffer不够用, 则会出现警告, 可以调大该值
processorExecutor		指定NIOProcessor上共享 businessExecutor固定线程池的大小; MyCat把异步任务交给 businessExecutor线程池中, 在新版本的MyCat中这个连接池使用频次不高, 可以适当地把该值调小
packetHeaderSize		指定MySQL协议中的报文头长度, 默认4个字节
maxPacketSize		指定MySQL协议可以携带的数据最大大小, 默认值为16M
idleTimeout	30	指定连接的空闲时间的超时长度;如果超时,将关闭资源并回收, 默认30分钟
txIsolation	1,2,3,4	初始化前端连接的事务隔离级别,默认为 REPEATED_READ , 对应数字为3 READ_UNCOMMITED=1; READ_COMMITTED=2; REPEATED_READ=3; SERIALIZABLE=4;
sqlExecuteTimeout	300	执行SQL的超时时间, 如果SQL语句执行超时,将关闭连接; 默认300秒;
serverPort	8066	定义MyCat的使用端口, 默认8066
managerPort	9066	定义MyCat的管理端口, 默认9066