Mycat配置详解--注释版
 个人随笔
目录
Mycat配置详解--注释版
2020-06-16 21:44:49

Mycat最重要的三个配置文件：
server.xml 定义用户以及系统相关变量，如端口等；
schema.xml 定义逻辑库，表、分片节点等内容；
rule.xml 定义分片规则。

server.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE mycat:server SYSTEM "server.dtd">
  3. <mycat:server xmlns:mycat="http://io.mycat/">
  4.     <system>
  5.     <property name="nonePasswordLogin">0</property> <!-- 0为需要密码登陆、1为不需要密码登陆 ,默认为0，设置为1则需要指定默认账户-->
  6.     <property name="useHandshakeV10">1</property>
  7.     <property name="useSqlStat">0</property>  <!-- 1为开启实时统计、0为关闭 -->
  8.     <property name="useGlobleTableCheck">0</property>  <!-- 1为开启全加班一致性检测、0为关闭 -->
  10.     <property name="sequnceHandlerType">2</property> <!--0 本地文件方式  1 数据库方式  2 时间戳方式-->
  11.     <property name="subqueryRelationshipCheck">false</property> <!-- 子查询中存在关联查询的情况下,检查关联字段中是否有分片字段 .默认 false -->
  12.       <!--  <property name="useCompression">1</property>--> <!--1为开启mysql压缩协议-->
  13.         <!--  <property name="fakeMySQLVersion">5.6.20</property>--> <!--设置模拟的MySQL版本号-->
  14.     <!-- <property name="processorBufferChunk">40960</property> -->
  15.     <!-- 
  16.     <property name="processors">1</property> 
  17.     <property name="processorExecutor">32</property> 
  18.      -->
  19.         <!--默认为type 0: DirectByteBufferPool | type 1 ByteBufferArena | type 2 NettyBufferPool -->
  20.         <property name="processorBufferPoolType">0</property>
  21.         <!--默认是65535 64K 用于sql解析时最大文本长度 -->
  22.         <!--<property name="maxStringLiteralLength">65535</property>-->
  23.         <!--<property name="sequnceHandlerType">0</property>-->
  24.         <!--<property name="backSocketNoDelay">1</property>-->
  25.         <!--<property name="frontSocketNoDelay">1</property>-->
  26.         <!--<property name="processorExecutor">16</property>-->
  27.         <!--
  28.             <property name="serverPort">8066</property> <property name="managerPort">9066</property> 
  29.             <property name="idleTimeout">300000</property> <property name="bindIp">0.0.0.0</property> 
  30.             <property name="frontWriteQueueSize">4096</property> <property name="processors">32</property> -->
  31.         <!--分布式事务开关，0为不过滤分布式事务，1为过滤分布式事务（如果分布式事务内只涉及全局表，则不过滤），2为不过滤分布式事务,但是记录分布式事务日志-->
  32.         <property name="handleDistributedTransactions">0</property>
  34.             <!--
  35.             off heap for merge/order/group/limit      1开启   0关闭
  36.         -->
  37.         <property name="useOffHeapForMerge">1</property>
  39.         <!--
  40.             单位为m
  41.         -->
  42.         <property name="memoryPageSize">64k</property>
  44.         <!--
  45.             单位为k
  46.         -->
  47.         <property name="spillsFileBufferSize">1k</property>
  49.         <property name="useStreamOutput">0</property>
  51.         <!--
  52.             单位为m
  53.         -->
  54.         <property name="systemReserveMemorySize">384m</property>
  57.         <!--是否采用zookeeper协调切换  -->
  58.         <property name="useZKSwitch">false</property>
  60.         <!-- XA Recovery Log日志路径 -->
  61.         <!--<property name="XARecoveryLogBaseDir">./</property>-->
  63.         <!-- XA Recovery Log日志名称 -->
  64.         <!--<property name="XARecoveryLogBaseName">tmlog</property>-->
  65.         <!--如果为 true的话 严格遵守隔离级别,不会在仅仅只有select语句的时候在事务中切换连接-->
  66.         <property name="strictTxIsolation">false</property>
  68.         <property name="useZKSwitch">true</property>
  70.     </system>
  72.     <!-- 全局SQL防火墙设置 -->
  73.     <!--白名单可以使用通配符%或着*-->
  74.     <!--例如<host host="127.0.0.*" user="root"/>-->
  75.     <!--例如<host host="127.0.*" user="root"/>-->
  76.     <!--例如<host host="127.*" user="root"/>-->
  77.     <!--例如<host host="1*7.*" user="root"/>-->
  78.     <!--这些配置情况下对于127.0.0.1都能以root账户登录-->
  79.     <!--
  80.     <firewall>
  81.        <whitehost>
  82.           <host host="1*7.0.0.*" user="root"/>
  83.        </whitehost>
  84.        <blacklist check="false">
  85.        </blacklist>
  86.     </firewall>
  87.     -->
  89.     <!--用户名是mycat-->
  90.     <user name="mycat" defaultAccount="true">
  91.         <!--密码是123456-->
  92.         <property name="password">123456</property>
  93.         <!---可访问的逻辑库有mycatdb-->
  94.         <property name="schemas">mycatdb</property>
  96.         <!-- 表级 DML 权限设置 -->
  97.         <!--        
  98.         <privileges check="false">
  99.             <schema name="TESTDB" dml="0110" >
  100.                 <table name="tb01" dml="0000"></table>
  101.                 <table name="tb02" dml="1111"></table>
  102.             </schema>
  103.         </privileges>       
  104.          -->
  105.     </user>
  107.     <user name="user">
  108.         <property name="password">user</property>
  109.         <property name="schemas">mycatdb</property>
  110.         <!--是否只读-->
  111.         <property name="readOnly">true</property>
  112.     </user>
  114. </mycat:server>

schema.xml

  1. <?xml version="1.0"?>
  2. <!DOCTYPE mycat:schema SYSTEM "schema.dtd">
  3. <mycat:schema xmlns:mycat="http://io.mycat/">
  5.     <!-- checkSQLschema这个属性默认就是false，官方文档的意思就是是否去掉表前面的数据库的名称，
  6.     ”select * from db1.testtable” ，设置为true就会去掉db1。但是如果db1的名称不是schema的名称，那么也不会被去掉，
  7.     因此官方建议不要使用这种语法。同时默认设置为false。-->
  9.     <!-- sqlMaxLimit当该值设置为某个数值时。每条执行的 SQL 语句，如果没有加上 limit 语句，MyCat 也会自动的加上所对应的值。
  10.     例如设置值为 100，执行”select * from test_table”,则效果为“selelct * from test_table limit 100”.
  11.     注意:如果运行的 schema 为非拆分库的，那么该属性不会生效。-->
  12.     <schema name="mycatdb" checkSQLschema="false" sqlMaxLimit="100">
  14.         <!-- name   该属性定义逻辑表的表名 -->
  15.         <!-- dataNode   该属性定义这个逻辑表所属的 dataNode, 该属性的值需要和 dataNode 标签中 name 属性的值相互对应。 -->
  16.         <!-- rule   该属性用于指定逻辑表要使用的规则名字，规则名字在 rule.xml 中定义，必须与 tableRule 标签中 name 属性属性值一一对应 -->
  17.         <!-- ruleRequired   该属性用于指定表是否绑定分片规则，如果配置为 true，但没有配置具体 rule 的话 ，程序会报错。 -->
  18.         <!-- primaryKey 该逻辑表对应真实表的主键， -->
  19.         <!-- type   该属性定义了逻辑表的类型，目前逻辑表只有“全局表”和”普通表”两种类型。全局表定义type=”global”，不定义的就是普通表。 -->
  20.         <!-- autoIncrement  主键是否自增长。 -->
  21.         <!-- subTables  分表，分表目前不支持Join。 -->
  22.         <!-- needAddLimit是否自动添加limit，默认是开启状态。关闭请谨慎。 -->
  24.         <!--rule="mod-long"  指定规则在rule中配置-->
  25.         <table name="users" primaryKey="id" dataNode="dn1"/>
  26.         <table name="orders" primaryKey="id" dataNode="dn1"/>
  29.         <table name="product" primaryKey="id" dataNode="dn2"/>
  30.         <table name="news" primaryKey="id" dataNode="dn2"/>
  33.     </schema>
  35.     <!--  Name  定义数据节点的名字，这个名字需要是唯一的-->
  36.     <!-- dataHost   该属性用于定义该分片属于哪个数据库实例 -->
  37.     <!-- Database   该属性用于定义该分片属性哪个具体数据库实例上的具体库 -->
  38.     <dataNode name="dn1" dataHost="localhost1" database="sharding1" />
  39.     <dataNode name="dn2" dataHost="localhost2" database="sharding2" />
  41.     <!--  name  唯一标识 dataHost 标签，供上层的标签使用-->
  42.     <!-- maxCon 指定每个读写实例连接池的最大连接。 -->
  43.     <!-- minCon 指定每个读写实例连接池的最小连接，初始化连接池的大小。 -->
  44.     <!-- balance    负载均衡类型，目前的取值有4 种： 
  45.     “0”, 不开启读写分离机制，所有读操作都发送到当前可用的 writeHost 上。 
  46.     “1”，全部的 readHost 与 stand by writeHost（非主非从） 参与 select 语句的负载均衡，简单的说，当双主双从模式(M1->S1，M2->S2，并且 M1 与 M2 互为主备)，正常情况下，M2,S1,S2 都参与 select 语句的负载均衡。
  47.     ”2”，所有读操作都随机的在 writeHost、readhost 上分发。
  48.     ”3”，所有读请求随机的分发到 wiriterHost 对应的 readhost 执行，writerHost 不负担读压
  49. -->
  50.     <!--writeType 写入方式，目前支持两种
  51.     1. writeType=”0”, 所有写操作发送到配置的第一个 writeHost，第一个挂了切到还生存的第二个writeHost，重新启动后已切换后的为准，切换记录在配置文件中:dnindex.properties .
  52.     2. writeType=”1”，所有写操作都随机的发送到配置的 writeHost，1.5 以后废弃不推荐。默认0就好了！-->
  53.     <!-- dbType 指定后端连接的数据库类型，目前支持二进制的 mysql 协议，还有其他使用 JDBC 连接的数据库。例如：mongodb、oracle、spark 等. -->
  54.     <!-- dbDriver   指定连接后端数据库使用的 Driver，目前可选的值有 native 和 JDBC。使用 native 的话，因为这个值执行的是二进制的 mysql 协议，所以可以使用 mysql 和 maridb。其他类型的数据库则需要使用 JDBC 驱动来支持。 -->
  55.     <!-- switchType “-1” 表示不自动切换； “1” 默认值，自动切换； 
  56.                     “2” 基于 MySQL 主从同步的状态决定是否切换心跳语句为 show slave status； 
  57.                     “3” 基于 MySQL galary cluster 的切换机制（适合集群）（1.4.1）心跳语句为 show status like ‘wsrep%’.                  
  58.     -->
  59.     <!--slaveThreshold:指定从节点的最大个数-->
  62.     <dataHost name="localhost1" 
  63.               maxCon="1000" 
  64.               minCon="10" 
  65.               balance="0"
  66.               writeType="0" 
  67.               dbType="mysql" 
  68.               dbDriver="native" 
  69.               switchType="1"  
  70.               slaveThreshold="100">
  71.         <heartbeat>select user()</heartbeat>
  73.         <!--host    用于标识不同实例，一般 writeHost 我们使用*M1，readHost 我们用*S1。-->
  74.         <!--url 后端实例连接地址。Native：地址：端口 JDBC：jdbc的url-->
  75.         <!--password    后端存储实例需要的密码-->
  76.         <!--user    后端存储实例需要的用户名字-->
  77.         <!--weight  权重 配置在 readhost 中作为读节点的权重-->
  78.         <!--usingDecrypt    是否对密码加密，默认0。具体加密方法看官方文档。-->
  79.         <writeHost host="hostM1" url="47.94.158.155:3306" user="root"
  80.                    password="TJXtjx_19991007">
  81.         </writeHost>
  82.     </dataHost>
  85.     <dataHost name="localhost2" 
  86.               maxCon="1000" 
  87.               minCon="10" 
  88.               balance="0"
  89.               writeType="0" 
  90.               dbType="mysql" 
  91.               dbDriver="native" 
  92.               switchType="1"  
  93.               slaveThreshold="100">
  94.         <heartbeat>select user()</heartbeat>
  95.         <writeHost host="hostM2" url="47.94.158.155:3306" user="root"
  96.                    password="TJXtjx_19991007">
  97.         </writeHost>
  98.     </dataHost>
  100. </mycat:schema>

rule.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE mycat:rule SYSTEM "rule.dtd">
  3. <mycat:rule xmlns:mycat="http://io.mycat/">
  4.     <tableRule name="rule1">
  5.         <rule>
  6.             <columns>id</columns>
  7.             <algorithm>func1</algorithm>
  8.         </rule>
  9.     </tableRule>
  11.     <tableRule name="rule2">
  12.         <rule>
  13.             <columns>user_id</columns>
  14.             <algorithm>func1</algorithm>
  15.         </rule>
  16.     </tableRule>
  18.     <tableRule name="sharding-by-intfile">
  19.         <rule>
  20.             <columns>sharding_id</columns>
  21.             <algorithm>hash-int</algorithm>
  22.         </rule>
  23.     </tableRule>
  24.     <tableRule name="auto-sharding-long">
  25.         <rule>
  26.             <columns>id</columns>
  27.             <algorithm>rang-long</algorithm>
  28.         </rule>
  29.     </tableRule>
  30.     <tableRule name="mod-long">
  31.         <rule>
  32.             <columns>id</columns>
  33.             <algorithm>mod-long</algorithm>
  34.         </rule>
  35.     </tableRule>
  36.     <tableRule name="sharding-by-murmur">
  37.         <rule>
  38.             <columns>id</columns>
  39.             <algorithm>murmur</algorithm>
  40.         </rule>
  41.     </tableRule>
  42.     <tableRule name="crc32slot">
  43.         <rule>
  44.             <columns>id</columns>
  45.             <algorithm>crc32slot</algorithm>
  46.         </rule>
  47.     </tableRule>
  48.     <tableRule name="sharding-by-month">
  49.         <rule>
  50.             <columns>create_time</columns>
  51.             <algorithm>partbymonth</algorithm>
  52.         </rule>
  53.     </tableRule>
  54.     <tableRule name="latest-month-calldate">
  55.         <rule>
  56.             <columns>calldate</columns>
  57.             <algorithm>latestMonth</algorithm>
  58.         </rule>
  59.     </tableRule>
  61.     <tableRule name="auto-sharding-rang-mod">
  62.         <rule>
  63.             <columns>id</columns>
  64.             <algorithm>rang-mod</algorithm>
  65.         </rule>
  66.     </tableRule>
  68.     <tableRule name="jch">
  69.         <rule>
  70.             <columns>id</columns>
  71.             <algorithm>jump-consistent-hash</algorithm>
  72.         </rule>
  73.     </tableRule>
  75.     <function name="murmur"
  76.         class="io.mycat.route.function.PartitionByMurmurHash">
  77.         <property name="seed">0</property><!-- 默认是0 -->
  78.         <property name="count">2</property><!-- 要分片的数据库节点数量，必须指定，否则没法分片 -->
  79.         <property name="virtualBucketTimes">160</property><!-- 一个实际的数据库节点被映射为这么多虚拟节点，默认是160倍，也就是虚拟节点数是物理节点数的160倍 -->
  80.         <!-- <property name="weightMapFile">weightMapFile</property> 节点的权重，没有指定权重的节点默认是1。以properties文件的格式填写，以从0开始到count-1的整数值也就是节点索引为key，以节点权重值为值。所有权重值必须是正整数，否则以1代替 -->
  81.         <!-- <property name="bucketMapPath">/etc/mycat/bucketMapPath</property> 
  82.             用于测试时观察各物理节点与虚拟节点的分布情况，如果指定了这个属性，会把虚拟节点的murmur hash值与物理节点的映射按行输出到这个文件，没有默认值，如果不指定，就不会输出任何东西 -->
  83.     </function>
  85.     <function name="crc32slot"
  86.               class="io.mycat.route.function.PartitionByCRC32PreSlot">
  87.     </function>
  88.     <function name="hash-int"
  89.         class="io.mycat.route.function.PartitionByFileMap">
  90.         <property name="mapFile">partition-hash-int.txt</property>
  91.     </function>
  92.     <function name="rang-long"
  93.         class="io.mycat.route.function.AutoPartitionByLong">
  94.         <property name="mapFile">autopartition-long.txt</property>
  95.     </function>
  96.     <function name="mod-long" class="io.mycat.route.function.PartitionByMod">
  97.         <!-- how many data nodes -->
  98.         <property name="count">3</property>
  99.     </function>
  101.     <function name="func1" class="io.mycat.route.function.PartitionByLong">
  102.         <property name="partitionCount">8</property>
  103.         <property name="partitionLength">128</property>
  104.     </function>
  105.     <function name="latestMonth"
  106.         class="io.mycat.route.function.LatestMonthPartion">
  107.         <property name="splitOneDay">24</property>
  108.     </function>
  109.     <function name="partbymonth"
  110.         class="io.mycat.route.function.PartitionByMonth">
  111.         <property name="dateFormat">yyyy-MM-dd</property>
  112.         <property name="sBeginDate">2015-01-01</property>
  113.     </function>
  115.     <function name="rang-mod" class="io.mycat.route.function.PartitionByRangeMod">
  116.             <property name="mapFile">partition-range-mod.txt</property>
  117.     </function>
  119.     <function name="jump-consistent-hash" class="io.mycat.route.function.PartitionByJumpConsistentHash">
  120.         <property name="totalBuckets">3</property>
  121.     </function>
  122. </mycat:rule>

server.xml中，节点下配置的属性 指定的是逻辑库，要和schema.xml声明的对应。

参考：https://www.jianshu.com/p/6566fb8f0a1a

 357

啊！这个可能是世界上最丑的留言输入框功能~


当然，也是最丑的留言列表

有疑问发邮件到 : suibibk@qq.com 侵权立删
Copyright : 个人随笔   备案号 : 粤ICP备18099399号-2