文章目录
- 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 |
2）user标签
在user标签中主要是配置那些用户可以登陆到Mycat，该用户必须在数据库中存在，并且可以配置用户针对逻辑库、逻辑表的一些权限，如果同时对逻辑库或者逻辑表都设置了权限，那么逻辑表的权限大于逻辑库的权限。
