这篇文章介绍的是mycat的配置相关内容,不包括原理及部署方法。
log4j.xml配置介绍
要理解mycat的日志输出首先要了解mycat是用java开发的,日志输出是用了log4j2的框架,如果你学过或者使用过log4j2,那么mycat的日志配置对你而言将会非常建单易懂。
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<!-- log4j的appenders配置,每一个appender可以配置日志输出的目标,常见的包括控制台或者日志文件 -->
<Appenders>
<!-- 输出目标为控制台的appender,使用了该appender的日志会将内容输出到控制台上 -->
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d [%-5p][%t] %m %throwable{full} (%C:%F:%L) %n"/>
</Console>
<!-- 输出目标为文件的appender, fileName:输出文件的路径及名称,filePattern:拆分后的日志文件保存的路径及文件名的规则 -->
<RollingFile name="RollingFile" fileName="${sys:MYCAT_HOME}/logs/mycat.log"
filePattern="${sys:MYCAT_HOME}/logs/$${date:yyyy-MM}/mycat-%d{MM-dd}-%i.log.gz">
<PatternLayout>
<Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %5p [%t] (%l) - %m%n</Pattern>
</PatternLayout>
<!-- 当达到何种条件后主输出的文件回被拆分保存,此处配置为文件大小超过250MB时,日志文件会被另外保存 -->
<Policies>
<OnStartupTriggeringPolicy/>
<SizeBasedTriggeringPolicy size="250 MB"/>
<TimeBasedTriggeringPolicy/>
</Policies>
</RollingFile>
</Appenders>
<!-- 配置的输出日志 -->
<Loggers>
<!--<AsyncLogger name="io.mycat" level="info" includeLocation="true" additivity="false">-->
<!--<AppenderRef ref="Console"/>-->
<!--<AppenderRef ref="RollingFile"/>-->
<!--</AsyncLogger>-->
<!-- level:日志输出的等级,等级由低到高:debug<info<warn<Error<Fatal,注:当你把输出等级调至debug的时候你可以看到所有执行的语句,及语句被分配到的dataNode(调试及寻找BUG的时候贼好用) -->
<asyncRoot level="debug" includeLocation="true">
<AppenderRef ref="Console" />
<AppenderRef ref="RollingFile"/>
</asyncRoot>
</Loggers>
</Configuration>
server.xml配置
该配置主要是服务如何部署及mycat服务提供的一系列功能的配置
<?xml version="1.0" encoding="UTF-8"?>
<!-- - - Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License. - You
may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0
- - Unless required by applicable law or agreed to in writing, software -
distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the
License for the specific language governing permissions and - limitations
under the License. -->
<!DOCTYPE mycat:server SYSTEM "server.dtd">
<mycat:server xmlns:mycat="http://io.mycat/">
<system>
<!-- 这个端口是提供服务用的,使用JDBC或者ORM框架链接数据源时的端口 -->
<property name="serverPort">8266</property>
<!-- 貌似是个管理用的端口,每用过,注意别和用过的端口互相占用就行 -->
<property name="managerPort">9266</property>
<property name="useSqlStat">0</property> <!-- 1为开启实时统计、0为关闭 -->
<property name="useGlobleTableCheck">0</property> <!-- 1为开启全表一致性检测、0为关闭 -->
<property name="sequnceHandlerType">2</property>
<!-- <property name="useCompression">1</property>--> <!--1为开启mysql压缩协议-->
<!-- <property name="fakeMySQLVersion">5.6.20</property>--> <!--设置模拟的MySQL版本号-->
<!-- <property name="processorBufferChunk">40960</property> -->
<!--
<property name="processors">1</property>
<property name="processorExecutor">32</property>
-->
<!--默认为type 0: DirectByteBufferPool | type 1 ByteBufferArena-->
<property name="processorBufferPoolType">0</property>
<!--默认是65535 64K 用于sql解析时最大文本长度 -->
<!--<property name="maxStringLiteralLength">65535</property>-->
<!--<property name="sequnceHandlerType">0</property>-->
<!--<property name="backSocketNoDelay">1</property>-->
<!--<property name="frontSocketNoDelay">1</property>-->
<!--<property name="processorExecutor">16</property>-->
<!-- 指定连接的空闲超时时间。某连接在发起空闲检查下,发现距离上次使用超过了空闲时间,
那么这个连接会被回收,就是被直接的关闭掉。默认 30 分钟,单位毫秒。
但是实际测试的时候发现这个配置并没有什么用,mycat还是会用超时的数据库链接来访问数据库导致异常的产生,这个问题可以在配置数据源的时候配置<property name="validationQuery" value="SELECT 1" />解决 -->
<!-- <property name="idleTimeout">300000</property> -->
<!-- 对后端连接进行空闲、超时检查的时间间隔,默认是 300 秒,单位毫秒。 -->
<!-- <property name="dataNodeIdleCheckPeriod">300000</property> -->
<!--
<property name="serverPort">8066</property> <property name="managerPort">9066</property>
<property name="idleTimeout">300000</property> <property name="bindIp">0.0.0.0</property>
<property name="frontWriteQueueSize">4096</property> <property name="processors">32</property> -->
<!--分布式事务开关,0为不过滤分布式事务,1为过滤分布式事务(如果分布式事务内只涉及全局表,则不过滤),2为不过滤分布式事务,但是记录分布式事务日志-->
<property name="handleDistributedTransactions">0</property>
<!--
off heap for merge/order/group/limit 1开启 0关闭
-->
<property name="useOffHeapForMerge">1</property>
<!--
单位为m
-->
<property name="memoryPageSize">1m</property>
<!--
单位为k
-->
<property name="spillsFileBufferSize">1k</property>
<property name="useStreamOutput">0</property>
<!--
单位为m
-->
<property name="systemReserveMemorySize">384m</property>
<!--是否采用zookeeper协调切换 -->
<property name="useZKSwitch">true</property>
</system>
<!-- 全局SQL防火墙设置 -->
<!--
<firewall>
<whitehost>
<host host="127.0.0.1" user="mycat"/>
<host host="127.0.0.2" user="mycat"/>
</whitehost>
<blacklist check="false">
</blacklist>
</firewall>
-->
<!-- 这个用户名密码即为连接mycat的时候用的数据库帐号密码,schemas即为数据库的schema的名字(使用mycat的服务时,你可以把它看作是一个数据库服务) -->
<user name="mycattest">
<property name="password">mycattest</property>
<property name="schemas">mycat</property>
</user>
</mycat:server>
rule.xml配置
这个配置文件配置分库的规则
<?xml version="1.0" encoding="UTF-8"?>
<!-- - - Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License. - You
may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0
- - Unless required by applicable law or agreed to in writing, software -
distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the
License for the specific language governing permissions and - limitations
under the License. -->
<!DOCTYPE mycat:rule SYSTEM "rule.dtd">
<!-- 配置分库规则 -->
<mycat:rule xmlns:mycat="http://io.mycat/">
<!-- 配置一个名称叫id4的分库规则,规则是按表的字段“id”作为参数,调用算法名为“uuid4”的算法的结果作为分库的结果 -->
<tableRule name="id4">
<rule>
<columns>id</columns>
<algorithm>uuid4</algorithm>
</rule>
</tableRule>
<!-- 算法名为uuid4,使用根据String字段来分表的算法 -->
<function name="uuid4"
class="io.mycat.route.function.PartitionByString">
<property name="seed">0</property><!-- 默认是0 -->
<!-- 要分片的数据库节点数量,必须指定,否则没法分片 -->
<property name="partitionCount">4</property>
<!-- 分库的规则,必须满足 partitionCount*partitionLength=1024 -->
<property name="partitionLength">256</property>
<property name="virtualBucketTimes">160</property><!-- 一个实际的数据库节点被映射为这么多虚拟节点,默认是160倍,也就是虚拟节点数是物理节点数的160倍 -->
<!-- <property name="weightMapFile">weightMapFile</property> 节点的权重,没有指定权重的节点默认是1。以properties文件的格式填写,以从0开始到count-1的整数值也就是节点索引为key,以节点权重值为值。所有权重值必须是正整数,否则以1代替 -->
<!-- <property name="bucketMapPath">/etc/mycat/bucketMapPath</property>
用于测试时观察各物理节点与虚拟节点的分布情况,如果指定了这个属性,会把虚拟节点的murmur hash值与物理节点的映射按行输出到这个文件,没有默认值,如果不指定,就不会输出任何东西 -->
</function>
</mycat:rule>
schema.xml配置
配置相关schema及schema内需要分库的表的分库逻辑。
注:若访问表A时,表A并没有在schema中配置分库规则,那么此访问会直接访问主库;若访问表B的语句没有分库字段的条件,那么此语句会在配置好的所有dataNode中执行一次(查询语句会合并汇总结果)。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mycat:schema SYSTEM "schema.dtd">
<mycat:schema xmlns:mycat="http://io.mycat/">
<!-- sqlMaxLimit:当该值设置为某个数值时。每条执行的SQL语句,如果没有加上limit语句,MyCat也会自动的加上所对应的值。如果指定表不需要limit限制,则在指定表的配置中加上 needAddLimit="false" 主分片为“dn1”-->
<schema name="mycat" checkSQLschema="false" sqlMaxLimit="100" dataNode="dn1">
<table name="t_user" primaryKey="ID" dataNode="dn1,dn2,dn3,dn4" rule="id4" needAddLimit="false"/>
</schema>
<!-- 数据节点定义
name属性 定义数据节点的名字,这个名字需要是唯一的,我们需要在table标签上应用这个名字,来建立表与分片对应的关系。
dataHost属性 是引用dataHost标签上定义的name属性。
database属性 database是指数据库schema名称-->
<dataNode name="dn1" dataHost="dh1" database="venus" ></dataNode>
<dataNode name="dn2" dataHost="dh2" database="venus" ></dataNode>
<dataNode name="dn3" dataHost="dh3" database="venus" ></dataNode>
<dataNode name="dn4" dataHost="dh4" database="venus" ></dataNode>
<!-- 数据库实例定义
maxCon属性 指定每个读写实例连接池的最大连接。
minCon属性 指定每个读写实例连接池的最小连接。
balance属性 负载均衡类型,目前的取值有4种:
1. balance="0", 不开启读写分离机制,所有读操作都发送到当前可用的writeHost上。
2. balance="1",所有读操作都随机的发送到readHost。全部的readHost与stand by writeHost参与select语句的负载均衡,简单的说,当双主双从模式(M1->S1,M2->S2,并且M1与 M2互为主备),正常情况下,M2,S1,S2都参与select语句的负载均衡。
3. balance="2",所有读操作都随机的在writeHost、readhost上分发。
4. balance="3",所有读请求随机的分发到wiriterHost对应的readhost执行,writerHost不负担读压力
writeType属性 writeType属性负载均衡类型,目前的取值有3种:
1.writeType="0", 所有写操作发送到配置的第一个writeHost,第一个挂了切到还生存的第二个writeHost,重新启动后已切换后的为准,切换记录在配置文件中:dnindex.properties.
2.writeType="1",所有写操作都随机的发送到配置的writeHost,1.5以后废弃不推荐。
3.writeType="2",不执行写操作
switchType指的是切换的模式,目前的取值也有4种:
1. switchType='-1' 表示不自动切换
2. switchType='1' 默认值,表示自动切换
3. switchType='2' 基于MySQL主从同步的状态决定是否切换,心跳语句为 show slave status
4. switchType='3'基于MySQL galary cluster的切换机制(适合集群)(1.4.1),心跳语句为 show status like 'wsrep%'。-->
<dataHost name="dh1" maxCon="1000" minCon="10" balance="1" writeType="0" dbType="mysql" dbDriver="native" switchType="1" slaveThreshold="100">
<heartbeat>select 1</heartbeat>
<!-- can have multi write hosts
<writeHost host="hostM1" url="localhost:3306" user="root" password="root">
<readHost host="hostS2" url="127.0.0.1:3306" user="root" password="root" />
</writeHost> -->
<!-- 读写的分片 -->
<writeHost host="hostM1" url="192.168.1.231:3406" user="venus" password="venus">
<!-- 只读的子分片 -->
<!-- <readHost host="hostS1" url="192.168.1.230:3306/venustest_e_1" user="root" password="root"/> -->
</writeHost>
</dataHost>
<dataHost name="dh2" maxCon="1000" minCon="10" balance="1" writeType="0" dbType="mysql" dbDriver="native" switchType="1" slaveThreshold="100">
<heartbeat>select 1</heartbeat>
<!-- can have multi write hosts
<writeHost host="hostM1" url="localhost:3306" user="root" password="root">
<readHost host="hostS2" url="127.0.0.1:3306" user="root" password="root" />
</writeHost> -->
<writeHost host="hostM1" url="192.168.1.231:3506" user="venus" password="venus">
<!-- <readHost host="hostS1" url="192.168.1.230:3306/venustest_e_1" user="root" password="root"/> -->
</writeHost>
</dataHost>
<dataHost name="dh3" maxCon="1000" minCon="10" balance="1" writeType="0" dbType="mysql" dbDriver="native" switchType="1" slaveThreshold="100">
<heartbeat>select 1</heartbeat>
<!-- can have multi write hosts
<writeHost host="hostM1" url="localhost:3306" user="root" password="root">
<readHost host="hostS2" url="127.0.0.1:3306" user="root" password="root" />
</writeHost> -->
<writeHost host="hostM1" url="192.168.1.231:3606" user="venus" password="venus">
<!-- <readHost host="hostS1" url="192.168.1.230:3306/venustest_e_1" user="root" password="root"/> -->
</writeHost>
</dataHost>
<dataHost name="dh4" maxCon="1000" minCon="10" balance="1" writeType="0" dbType="mysql" dbDriver="native" switchType="1" slaveThreshold="100">
<heartbeat>select 1</heartbeat>
<!-- can have multi write hosts
<writeHost host="hostM1" url="localhost:3306" user="root" password="root">
<readHost host="hostS2" url="127.0.0.1:3306" user="root" password="root" />
</writeHost> -->
<writeHost host="hostM1" url="192.168.1.231:3706" user="venus" password="venus">
<!-- <readHost host="hostS1" url="192.168.1.230:3306/venustest_e_1" user="root" password="root"/> -->
</writeHost>
</dataHost>
</mycat:schema>