05、MyCat 实战 - MyCat 配置 server.xml 详解

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>
        <property name="nonePasswordLogin">0</property> <!-- 0为需要密码登陆、1为不需要密码登陆 ,默认为0,设置为1则需要指定默认账户-->
        <property name="useHandshakeV10">1</property>
        <property name="useSqlStat">0</property>  <!-- 1为开启实时统计、0为关闭 -->
        <property name="useGlobleTableCheck">0</property>  <!-- 1为开启全局表一致性检测 0为关闭 -->
        <property name="sqlExecuteTimeout">300</property>  <!-- SQL 执行超时 单位:秒 默认:300s-->
        <property name="sequnceHandlerType">2</property>  <!-- 全局序列号/ID生成方式。(0:为本地文件方式,1:为数据库方式;2:为时间戳序列方式;3:为ZK生成ID;4:为ZK递增ID生成 -->
        <!-- <property name="sequnceHandlerPattern">(?:(\s*next\s+value\s+for\s*MYCATSEQ_(\w+))(,|\)|\s)*)+</property>-->
        <!--必须带有MYCATSEQ_或者 mycatseq_进入序列匹配流程 注意MYCATSEQ_有空格的情况-->
        <property name="sequnceHandlerPattern">(?:(\s*next\s+value\s+for\s*MYCATSEQ_(\w+))(,|\)|\s)*)+</property>
        <property name="subqueryRelationshipCheck">false</property> <!-- 子查询中存在关联查询的情况下,检查关联字段中是否有分片字段 .默认 false -->
        <!-- <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>  --> <!-- mycat启动后进程数(基于CPU核数进行实例化) -->
        <!-- <property name="processorExecutor">32</property>  --> <!-- 进程里面的线程池有多少,生产环境根据硬件资源进行调优使用,一般情况可以使用默认配置  -->
	
        <!--默认为type 0: DirectByteBufferPool | type 1 ByteBufferArena | type 2 NettyBufferPool -->
        <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>-->
        <!-- <property name="serverPort">8066</property> --> <!-- 定义 mycat 的使用端口,默认值为 8066 -->
        <!-- <property name="managerPort">9066</property> --> <!-- 定义 mycat 的管理端口,默认值为 9066 -->
        <!-- <property name="idleTimeout">300000</property> -->
        <!-- <property name="bindIp">0.0.0.0</property> -->
        <!-- <property name="dataNodeIdleCheckPeriod">300000</property> --> <!-- 连接空闲检查,5 * 60 * 1000L;-->
        <!-- <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">0</property>

        <!-- 单位为m -->
        <property name="memoryPageSize">64k</property>

        <!-- 单位为k -->
        <property name="spillsFileBufferSize">1k</property>

        <property name="useStreamOutput">0</property>

        <!-- 单位为m -->
        <property name="systemReserveMemorySize">384m</property>

        <!--是否采用zookeeper协调切换  -->
        <property name="useZKSwitch">false</property>

        <!-- XA Recovery Log日志路径 -->
        <!--<property name="XARecoveryLogBaseDir">./</property>-->

        <!-- XA Recovery Log日志名称 -->
        <!--<property name="XARecoveryLogBaseName">tmlog</property>-->
        
        <!--如果为 true的话 严格遵守隔离级别,不会在仅仅只有select语句的时候在事务中切换连接-->
        <property name="strictTxIsolation">false</property>
		
    </system>
	
    <!-- 全局SQL防火墙设置 -->
    <!--白名单可以使用通配符%或着*-->
    <!--例如<host host="127.0.0.*" user="root"/>-->
    <!--例如<host host="127.0.*" user="root"/>-->
    <!--例如<host host="127.*" user="root"/>-->
    <!--例如<host host="1*7.*" user="root"/>-->
    <!--这些配置情况下对于127.0.0.1都能以root账户登录-->
    <!--
    <firewall>
        <whitehost>
            <host host="1*7.0.0.*" user="root"/>
        </whitehost>
        <blacklist check="false">
        </blacklist>
    </firewall>
    -->

    <!-- 用户1:root  -->
    <user name="root" defaultAccount="true">
        <property name="password">123456</property>
        <!-- 可访问的逻辑库,可为多个逗号分开 -->
        <property name="schemas">TESTDB</property>
        <!-- 当前端的整体connection数达到基准值是,对来自该账户的请求开始拒绝连接,0或不设表示不限制-->
		<property name="benchmark">11111</property>
        <!-- 是否对密码加密,默认0:否(1:开启) -->
        <proerty name="usingDecrypt">0</property>
        <!-- 表级 DML 权限设置  顺序:IUSD -->
        <!-- 		
        <privileges check="false">
            <schema name="TESTDB" dml="0110" >
                <table name="tb01" dml="0000"></table>
                <table name="tb02" dml="1111"></table>
            </schema>
        </privileges>		
        -->
    </user>

    <!-- 用户2:user -->
    <user name="user">
        <property name="password">user</property>
        <property name="schemas">TESTDB</property>
        <!-- 是否只读 -->
        <property name="readOnly">true</property>
    </user>

</mycat:server>