mycat 配置文件详解

server.xml 包含mycat的系统配置信息，它有两个标签，分别是user和system，掌握system标签的各项配置属性是mycat调优的关键。

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <!-- - - Licensed under the Apache License, Version 2.0 (the "License");   
3.     - you may not use this file except in compliance with the License. - You   
4.     may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0   
5.     - - Unless required by applicable law or agreed to in writing, software -   
6.     distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT   
7.     WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the   
8.     License for the specific language governing permissions and - limitations   
9.     under the License. -->  
10. <!DOCTYPE mycat:server SYSTEM "server.dtd">  
11. <mycat:server xmlns:mycat="http://io.mycat/">  
12.     <system>  
13.     <!-- 配置该属性的时候一定要保证mycat的字符集和mysql 的字符集是一致的 -->      
14.     <property name="charset">utf8</property>    
15.     <!-- 指定每次分配socker direct buffer 的值，默认是4096字节 -->    
16.     <property name="processorBufferChunk">4096/property>     
17.     <!-- 配置系统可用的线程数量，默认值为CPU核心X每个核心运行线程的数量 -->      
18.     <property name="processors">4/property>     
19.       
20.     <!-- 指定BufferPool 的计算比例  默认值为bufferChunkSize(4096)X processors X 1000  
21.     <property name="processorBufferPool">100000000/property> -->     
22.       
23.     <!-- 用来控制ThreadLocalPool 分配Pool的比例大小，默认值为100  
24.     <property name="processorBufferLocalPercent">100/property> -->  
25.   
26.     <!-- 用来指定Mycat全局序列类型，0为本地文件，1为数据库方式，2为时间戳列方式，默认使用本地文件方式，文件方式主要用于测试  
27.     <property name="sequnceHandlerType">0/property> -->  
28.   
29.     <!-- TCP 参 数配置，mycat在每次建立前后端连接时候，都会使用这些参数初始化TCP属性，详细可以查看Java API 文 档：http://docs.oracle.com/javase/7/docs/api/net /StandardSocketOptions.html  
30.     <property name="frontSocketSoRcvbuf">1024*1024/property>  
31.     <property name="frontSocketSoSndbuf">4*1024*1024/property>  
32.     <property name="frontSocketNoDelay">1/property>  
33.     <property name="backSocketSoRcvbuf">4*1024*1024/property>  
34.     <property name="backSocketSoSndbuf">1024*1024/property>  
35.     <property name="backSocketNoDelay">1/property> -->    
36.   
37.     <!-- mysql 连接相关配置 -->  
38.     <!-- <property name="packetHeaderSize">4</property>  指定mysql协议中的报文头长度，默认4个字节-->  
39.     <!-- <property name="maxPacketSize">1024*1024*16</property> 配置可以携带的数据量最大值，默认16M-->  
40.     <!-- <property name="idleTimeout"& gt;1024*1024*16</property> 指定连接的空闲时间超时长度，如果某个连接空闲时间超过该值，则将连接关闭并回收， 单位为毫秒，默认值为30分钟-->  
41.     <!-- <property name="txIsolation">3</property> 初始化前端连接事务的隔离级别有：  
42.         READ_UNCOMMITTED=1  
43.         READ_COMMITTED=2  
44.         REPEATED_READ=3  
45.         SERIALIZABLE=4   
46.       默认为3-->  
47.     <!-- <property name="sqlExecuteTimeout">3</property>执行sql超时时间，默认为300秒-->  
48.   
49.   
50.     <!-- 心跳属性配置 -->  
51.     <!-- <property name="processorCheckPeriod">1000</property>清理前后端空闲、超时、关闭连接的时间间隔，单位为毫秒，默认为1秒-->  
52.     <!-- <property name="dataNodeIdleCheckPeriod">300*1000</property>对后端连接进行空闲，超时检查的时间间隔，单位为毫秒，默认为300秒-->  
53.     <!-- <property name="dataNodeHeartbeatPeriod">10*1000</property>对后端所有读写库发起心跳的间隔时间，单位为毫秒，默认为10秒-->  
54.   
55.     <!-- 服务相关属性 -->  
56.     <!-- <property name="bindIp">0.0.0.0</property>mycat服务监听的ip地址，默认为0.0.0.0-->  
57.     <!-- <property name="serverPort">8066</property>定义mycat使用的端口，默认值为8066-->  
58.     <!-- <property name="managerPort">9066</property>定义mycat管理的端口，默认值为9066-->  
59.   
60.     <!-- 分布式事务开关属性 -->  
61.     <!-- <property name="handleDistributedTransactions"& gt;0</property>0为不过滤分布式事务，1过滤分布式事务，2不过滤分布式事务，但是记录分布式事务日志。主要用户是否允许跨 库事务。mycat 1.6版本开始，支持此属性-->  
62.   
63.    
64.     <!-- <property name="useOffHeapForMerge">1</property>配置是否启用非堆内存跨分片结果集，1为开启，0为关闭，mycat1.6开始支持该属性-->  
65.   
66.     <!-- 全局表一致性检测 -->  
67.     <property name="useGlobleTableCheck">0</property>  <!--通过添加_MYCAT_OP_TIME字段来进行一致性检测，为BIGINT类型 1为开启全加班一致性检测、0为关闭 -->  
68.   
69.     <property name="useSqlStat">0</property>  <!-- 1为开启实时统计、0为关闭 -->  
70.   
71.   
72.       <!--  <property name="useCompression">1</property>--> <!--1为开启mysql压缩协议-->  
73.       <!--  <property name="fakeMySQLVersion">5.6.20</property>--> <!--设置模拟的MySQL版本号-->  
74.        
75.     <!--   
76.     <property name="processors">1</property>   
77.     <property name="processorExecutor">32</property>   
78.      -->  
79.         <!--默认为type 0: DirectByteBufferPool | type 1 ByteBufferArena-->  
80.         <property name="processorBufferPoolType">0</property>  
81.         <!--默认是65535 64K 用于sql解析时最大文本长度 -->  
82.         <!--<property name="maxStringLiteralLength">65535</property>-->  
83.         <!--<property name="processorExecutor">16</property>-->  
84.         <!--  
85.             <property name="serverPort">8066</property> <property name="managerPort">9066</property>   
86.             <property name="idleTimeout">300000</property> <property name="bindIp">0.0.0.0</property>   
87.             <property name="frontWriteQueueSize">4096</property> <property name="processors">32</property> -->  
88.         <!--分布式事务开关，0为不过滤分布式事务，1为过滤分布式事务（如果分布式事务内只涉及全局表，则不过滤），2为不过滤分布式事务,但是记录分布式事务日志-->  
89.         <property name="handleDistributedTransactions">0</property>  
90.           
91.         <!--单位为m-->  
92.         <property name="memoryPageSize">1m</property>  
93.   
94.         <!--单位为k-->  
95.         <property name="spillsFileBufferSize">1k</property>  
96.   
97.         <property name="useStreamOutput">0</property>  
98.   
99.         <!--单位为m-->  
100.         <property name="systemReserveMemorySize">384m</property>  
101.   
102.         <!--是否采用zookeeper协调切换  -->  
103.         <property name="useZKSwitch">true</property>  
104.   
105.     </system>  
106.       
107.     <!-- 全局SQL防火墙设置 -->  
108.     <!--   
109.     <firewall>   
110.        <whitehost>  
111.           <host host="127.0.0.1" user="mycat"/>  
112.           <host host="127.0.0.2" user="mycat"/>  
113.        </whitehost>  
114.        <blacklist check="false">  
115.        </blacklist>  
116.     </firewall>  
117.     -->  
118.     <!-- 定义登录mycat对的用户权限 -->  
119.     <user name="root">  
120.         <property name="password">123456</property>  
121.         <!-- 若要访问TESTDB 必须现在server.xml 中定义，否则无法访问TESTDB-->  
122.         <property name="schemas">TESTDB</property>  
123.         <!-- 配置是否允许只读 -->  
124.         <property name="readOnly">true</property>  
125.         <!-- 定义限制前端整体的连接数，如果其值为0，或者不设置，则表示不限制连接数量 -->  
126.         <property name="benchmark">11111</property>  
127.         <!-- 设置是否开启密码加密功能，默认为0不开启加密，为1则表示开启加密 -->  
128.         <property name="usingDecrypt">1</property>  
129.         <!-- 表级 DML 权限设置 -->  
130.         <!--           
131.         <privileges check="false">  
132.             <schema name="TESTDB" dml="0110" >  
133.                 <table name="tb01" dml="0000"></table>  
134.                 <table name="tb02" dml="1111"></table>  
135.             </schema>  
136.         </privileges>       
137.          -->  
138.     </user>  
139. </mycat:server>