一、下载mycat及启动
#linux版
http://dl.mycat.io/1.6.5/Mycat-server-1.6.5-release-20180122220033-linux.tar.gz
#启动命令 进入bin文件夹,最好放在/usr/local/mycat/
cd /usr/local/mycat/bin
./mycat start
#window版
http://dl.mycat.io/1.6.5/Mycat-server-1.6.5-release-20180122220033-win.tar.gz
#启动命令 进入bin文件夹,最好放在盘符根目录,无中文
startup_nowrap.bat
二、配置文件
1、server.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:server SYSTEM "server.dtd">
<mycat:server xmlns:mycat="http://io.mycat/">
<system>
<!-- 字符集 -->
<property name="charset">utf8mb4</property>
<!-- 0为需要密码登陆、1为不需要密码登陆 ,默认为0,设置为1则需要指定默认账户-->
<property name="nonePasswordLogin">0</property>
<property name="useHandshakeV10">1</property>
<!-- 1为开启实时统计、0为关闭 -->
<property name="useSqlStat">0</property>
<!-- 1为开启全加班一致性检测、0为关闭 -->
<property name="useGlobleTableCheck">0</property>
<!-- 全局ID生成方式。(0:为本地文件方式,1:为数据库方式;2:为时间戳序列方式;3:为ZK生成ID;4:为ZK递增ID生成。 -->
<property name="sequnceHandlerType">2</property>
<!-- 子查询中存在关联查询的情况下,检查关联字段中是否有分片字段 .默认 false -->
<property name="subqueryRelationshipCheck">false</property>
<!-- 是否开启mysql压缩协议。1为开启,0为关闭,默认关闭 -->
<!-- <property name="useCompression">1</property>-->
<!-- 设置模拟的MySQL版本号 -->
<!-- <property name="fakeMySQLVersion">5.6.20</property>-->
<!--
这个属性指定每次分配 Socket Direct Buffer 的大小,默认是 4096 个字节。
这个属性也影响 buffer pool 的长度。
如果一次性获取的数过大 buffer 不够用 经常出现警告,则可以适当调大。
-->
<!-- 创建共享buffer需要占用的总空间大小。processorBufferChunk*processors*100。 -->
<!-- <property name="processorBufferChunk">40960</property> -->
<!--
处理线程数量,默认是CPU核心线程数
<property name="processors">1</property>
<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>
-->
<!-- 定义 mycat 的使用端口,默认值为 8066。 -->
<property name="serverPort">8066</property>
<!-- 定义 mycat 的管理端口,默认值为 9066。 -->
<property name="managerPort">9066</property>
<!--
指定连接的空闲超时时间。某连接在发起空闲检查下,
发现距离上次使用超过了空闲时间,
那么这个连接会被回收,就是被直接的关闭掉。默认 30 分钟,单位毫秒。
-->
<!-- <property name="idleTimeout">300000</property> -->
<!-- mycat 服务监听的 IP 地址,默认值为 0.0.0.0 -->
<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">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>-->
</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>
-->
<!--
user 用户配置节点
name 登录的用户名,也就是连接Mycat的用户名
password 登录的密码,也就是连接Mycat的密码
schemas 数据库名,这里会和schema.xml中的配置关联,多个用逗号分开
-->
<user name="test">
<property name="password">test</property>
<property name="schemas">TESTDB1,TESTDB2</property>
<property name="readOnly">true</property>
</user>
<user name="root" defaultAccount="true">
<property name="password">root</property>
<property name="schemas">TESTDB1,TESTDB2</property>
<!-- 表级 DML 权限设置 -->
<!--
check 表示是否开启DML权限检查。默认是关闭
schema的配置。
dml 顺序说明:insert,update,select,delete
TESTDB的权限是update,select。
tb01的权限是啥都不能干。
tb02的权限是insert,update,select,delete。
其他表默认是udpate,select。
-->
<!--
<privileges check="false">
<schema name="TESTDB" dml="0110" >
<table name="tb01" dml="0000"></table>
<table name="tb02" dml="1111"></table>
</schema>
</privileges>
-->
</user>
<user name="dev">
<property name="password">dev</property>
<property name="schemas">TESTDB1,TESTDB2</property>
<property name="readOnly">true</property>
</user>
</mycat:server>
2、schema.xml
<?xml version="1.0"?>
<!DOCTYPE mycat:schema SYSTEM "schema.dtd">
<mycat:schema xmlns:mycat="http://io.mycat/">
<!--
schema标签
name: 逻辑数据库库名称,与数据库中的database相同;对应server.xml用户节点配置的schema对应
dataNode: 该属性用于绑定逻辑库到某个具体的 database 上,
1.3 版本如果配置了 dataNode,则不可以配置分片表,1.4 可以配置默认分片
checkSQLschema: 数据库前缀相关设置,当该值为true时,
例如我们执行语句select * from TESTDB.company 。mycat会把语句修改为 select * from company 去掉TESTDB。
sqlMaxLimit: 该值设置为某个数值时,每条执行的sql语句,如果没有加上limit语句,
Mycat会自动加上对应的值。不写的话,默认返回所有的值。
需要注意的是,如果运行的schema为非拆分库的,那么该属性不会生效。需要自己sql语句加limit。
-->
<!--
table标签
name: 表名,物理数据库中表名
dataNode: 表存储到哪些节点,多个节点用逗号分隔。节点为下文dataNode设置的name
rule: 分片规则名,规则名字在rule.xml中定义
ruleRequired: 该属性用于指定表是否绑定分片规则,如果配置为 true,但没有配置具体 rule 的话 ,程序会报错。
primaryKey: 该逻辑表对应真实表的主键,
type: 逻辑表类型,目前只有全局表和普通表。全局表为global,普通表为不指定的所有表
autoincrement: 使用 autoIncrement=“true” 指定这个表有使用自增长主键
使用 autoIncrement=“false” 来禁用这个功能,当然你也可以直接删除掉这个属性。默认就是禁用的。
subTables: 分表,分表目前不支持Join。
needAddLimit: 指定表是否需要自动的在每个语句后面加上 limit 限制,
这个属性默认为 true,你也可以设置成 false`禁用掉默认行为。
-->
<!--
childTable 标签
name: 子表表名
joinKey: 插入子表的时候会使用这个列的值查找父表存储的数据节点。
parentKey: 属性指定的值一般为与父表建立关联关系的列名。程序首先获取 joinkey 的值,再通过 parentKey 属性指定
的列名产生查询语句,通过执行该语句得到父表存储在哪个分片上。从而确定子表存储的位置。
primaryKey: 同 table 标签所描述的
needAddLimit: 同 table 标签所描述的。
-->
<schema name="TESTDB1" checkSQLschema="false" sqlMaxLimit="100">
<table name="sys_dict" primaryKey="DICT_ID" type="global" dataNode="dn1,dn2,dn3" />
<table name="sys_menu" primaryKey="MENU_ID" dataNode="dn1" />
</schema>
<schema name="TESTDB2" checkSQLschema="false" sqlMaxLimit="100">
<table name="shop" primaryKey="id" dataNode="dn1,dn2,dn3" rule="sharding-by-string-enum" />
</schema>
<!--
dataNode 标签
name: 数据节点名
dataHost: 该属性用于定义该分片属于哪个数据库实例的,属性值是引用 dataHost 标签上定义的 name 属性
database: 该属性用于定义该分片属性哪个具体数据库实例上的具体库,因为这里使用两个纬度来定义分片,就是:实
例+具体的库。因为每个库上建立的表和表结构是一样的。所以这样做就可以轻松的对表进行水平拆分。
-->
<dataNode name="dn1" dataHost="host01" database="db1" />
<dataNode name="dn2" dataHost="host01" database="db2" />
<dataNode name="dn3" dataHost="host01" database="db3" />
<!--
dataHost 标签
name: 唯一标识 dataHost 标签,供上层的标签使用
maxCon: 指定每个读写实例连接池的最大连接。
minCon: 指定每个读写实例连接池的最小连接,初始化连接池的大小。
balance:
负载均衡类型,目前的取值有 3 种:
1. balance="0", 不开启读写分离机制,所有读操作都发送到当前可用的 writeHost 上。
2. balance="1",全部的 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 不负担读压
力,注意 balance=3 只在 1.4 及其以后版本有,1.3 没有。
writeType:
负载均衡类型,目前的取值有 3 种:
1. writeType="0", 所有写操作发送到配置的第一个 writeHost,第一个挂了切到还生存的第二个
writeHost,重新启动后已切换后的为准,切换记录在配置文件中:dnindex.properties .
2. writeType="1",所有写操作都随机的发送到配置的 writeHost,1.5 以后废弃不推荐。
switchType:
-1 表示不自动切换。
1 默认值,自动切换。
2 基于 MySQL 主从同步的状态决定是否切换。
3 基于mysql galary cluster 的切换机制(适合集群)1.4.1 心跳语句为 show status like 'wsrep%'
dbType: 指定后端连接的数据库类型,目前支持二进制的 mysql 协议,还有其他使用 JDBC 连接的数据库。例如:
mongodb、oracle、spark 等
dbDriver: 指定连接后端数据库使用的 Driver,目前可选的值有 native 和 JDBC。使用 native 的话,因为这个值执行的
是二进制的 mysql 协议,所以可以使用 mysql 和 maridb。其他类型的数据库则需要使用 JDBC 驱动来支持。
从 1.6 版本开始支持 postgresql 的 native 原始协议。
如果使用 JDBC 的话需要将符合 JDBC 4 标准的驱动 JAR 包放到 MYCAT\lib 目录下,并检查驱动 JAR 包中包
括如下目录结构的文件:META-INF\services\java.sql.Driver。在这个文件内写上具体的 Driver 类名,例如:
com.mysql.jdbc.Driver
tempReadHostAvailable: 如果配置了这个属性 writeHost 下面的 readHost 仍旧可用,默认 0 可配置(0、1)
-->
<dataHost name="host01" maxCon="1000" minCon="10" balance="3"
writeType="0" dbType="mysql" dbDriver="native" switchType="1" slaveThreshold="100">
<!--
heartbeat 标签
这个标签内指明用于和后端数据库进行心跳检查的语句。
例如,MYSQL 可以使用 select user(),
Oracle 可以使用 select 1 from dual 等。
-->
<!--
writeHost 标签、readHost 标签
host: 用于标识不同实例,一般 writeHost 我们使用*M1,readHost 我们用*S1。
url: 后端实例连接地址,如果是使用 native 的 dbDriver,则一般为 address:port 这种形式。
用 JDBC 或其他的dbDriver,则需要特殊指定。当使用 JDBC 时则可以这么写:jdbc:mysql://localhost:3306/。
user: 后端存储实例需要的用户名
password: 后端存储实例需要的密码。
weight: 权重 配置在 readhost 中作为读节点的权重(1.4 以后)
usingDecrypt: 是否对密码加密默认 0 否 如需要开启配置 1,
同时使用加密程序对密码加密,加密命令为:执行 mycat jar 程序(1.4.1 以后)
java -cp Mycat-server-1.4.1-dev.jar io.mycat.util.DecryptUtil 1:host:user:password
Mycat-server-1.4.1-dev.jar 为 mycat download 下载目录的 jar
1:host:user:password 中 1 为 db 端加密标志,host 为 dataHost 的 host 名称
-->
<heartbeat>select user()</heartbeat>
<!-- can have multi write hosts -->
<writeHost host="hostM0" url="192.168.46.120:4002" user="root"
password="root">
<!-- can have multi read hosts -->
<readHost host="hostS1" url="192.168.46.120:4004" user="root" password="root" />
</writeHost>
</dataHost>
</mycat:schema>
3、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/">
<tableRule name="rule1">
<rule>
<columns>id</columns>
<algorithm>func1</algorithm>
</rule>
</tableRule>
<tableRule name="rule2">
<rule>
<columns>user_id</columns>
<algorithm>func1</algorithm>
</rule>
</tableRule>
<tableRule name="sharding-by-intfile">
<rule>
<columns>sharding_id</columns>
<algorithm>hash-int</algorithm>
</rule>
</tableRule>
<tableRule name="auto-sharding-long">
<rule>
<columns>id</columns>
<algorithm>rang-long</algorithm>
</rule>
</tableRule>
<tableRule name="mod-long">
<rule>
<columns>id</columns>
<algorithm>mod-long</algorithm>
</rule>
</tableRule>
<tableRule name="sharding-by-murmur">
<rule>
<columns>id</columns>
<algorithm>murmur</algorithm>
</rule>
</tableRule>
<tableRule name="crc32slot">
<rule>
<columns>id</columns>
<algorithm>crc32slot</algorithm>
</rule>
</tableRule>
<tableRule name="sharding-by-month">
<rule>
<columns>create_time</columns>
<algorithm>partbymonth</algorithm>
</rule>
</tableRule>
<tableRule name="latest-month-calldate">
<rule>
<columns>calldate</columns>
<algorithm>latestMonth</algorithm>
</rule>
</tableRule>
<tableRule name="auto-sharding-rang-mod">
<rule>
<columns>id</columns>
<algorithm>rang-mod</algorithm>
</rule>
</tableRule>
<tableRule name="jch">
<rule>
<columns>id</columns>
<algorithm>jump-consistent-hash</algorithm>
</rule>
</tableRule>
<tableRule name="sharding-by-string-enum">
<rule>
<columns>province_no</columns>
<algorithm>stringenum</algorithm>
</rule>
</tableRule>
<function name="stringenum" class="io.mycat.route.function.PartitionByFileMap">
<property name="mapFile">partition-by-string-enum.txt</property>
<property name="type">1</property><!-- 默认值为0,0表示整型,非0表示字符串类型,不加type属性会使用默认值0-->
</function>
<function name="murmur"
class="io.mycat.route.function.PartitionByMurmurHash">
<property name="seed">0</property><!-- 默认是0 -->
<property name="count">2</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>
<function name="crc32slot"
class="io.mycat.route.function.PartitionByCRC32PreSlot">
<property name="count">2</property><!-- 要分片的数据库节点数量,必须指定,否则没法分片 -->
</function>
<function name="hash-int"
class="io.mycat.route.function.PartitionByFileMap">
<property name="mapFile">partition-hash-int.txt</property>
</function>
<function name="rang-long"
class="io.mycat.route.function.AutoPartitionByLong">
<property name="mapFile">autopartition-long.txt</property>
</function>
<function name="mod-long" class="io.mycat.route.function.PartitionByMod">
<!-- how many data nodes -->
<property name="count">3</property>
</function>
<function name="func1" class="io.mycat.route.function.PartitionByLong">
<property name="partitionCount">8</property>
<property name="partitionLength">128</property>
</function>
<function name="latestMonth"
class="io.mycat.route.function.LatestMonthPartion">
<property name="splitOneDay">24</property>
</function>
<function name="partbymonth"
class="io.mycat.route.function.PartitionByMonth">
<property name="dateFormat">yyyy-MM-dd</property>
<property name="sBeginDate">2015-01-01</property>
</function>
<function name="rang-mod" class="io.mycat.route.function.PartitionByRangeMod">
<property name="mapFile">partition-range-mod.txt</property>
</function>
<function name="jump-consistent-hash" class="io.mycat.route.function.PartitionByJumpConsistentHash">
<property name="totalBuckets">3</property>
</function>
</mycat:rule>
4、partition-by-string-enum.txt
HUBEI=0
HUNAN=0
GUANGXI=1
GUANGDONG=1
HEILONGJIANG=1
YUNNAN=2
SICHUAN=2
JIANGXI=2
三、准备数据
DDL(数据定义语言)
将新建数据库插入到4002或4004端口中,并将建表语句插入到每个数据库中
CREATE DATABASE db1;
CREATE DATABASE db2;
CREATE DATABASE db3;
DROP TABLE IF EXISTS `shop`;
CREATE TABLE `shop` (
`id` int(11) NOT NULL,
`shop_name` char(18) CHARACTER SET utf8mb4 NOT NULL,
`address` varchar(128) CHARACTER SET utf8mb4 DEFAULT NULL,
`phone_number` varchar(21) CHARACTER SET utf8mb4 DEFAULT NULL,
`province_no` varchar(16) CHARACTER SET utf8mb4 DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
DML(数据操作语言)
将DML插入到8066端口中
INSERT into shop (id,shop_name,address,phone_number,province_no) values (1,'深圳第一连锁店','深圳市南山区科技南五路1号','075584569789','GUANGDONG');
INSERT into shop (id,shop_name,address,phone_number,province_no) values (2,'武汉第一连锁店','武汉市洪山区太平路1号','02784569789','HUBEI');
INSERT into shop (id,shop_name,address,phone_number,province_no) values (3,'武汉第二连锁店','武汉市南山区科技南五路1号','02784569789','HUBEI');
INSERT into shop (id,shop_name,address,phone_number,province_no) values (4,'南昌第一连锁店','南昌市红军路1号','053284569789','JIANGXI');
INSERT into shop (id,shop_name,address,phone_number,province_no) values (5,'岳阳市第一连锁店','岳阳市南和平路1号','073084569789','HUNAN');
INSERT into shop (id,shop_name,address,phone_number,province_no) values (6,'哈尔滨第一连锁店','哈尔滨市沿江路1号','045184569789','HEILONGJIANG');
INSERT into shop (id,shop_name,address,phone_number,province_no) values (7,'成都市第一连锁店','成都市和平路1号','02884569789','SICHUAN');
INSERT into shop (id,shop_name,address,phone_number,province_no) values (8,'深圳第2连锁店','深圳市罗湖区红岗路1号','075584569789','GUANGDONG');
INSERT into shop (id,shop_name,address,phone_number,province_no) values (9,'桂林市第2连锁店','桂林市梅雨路1号','077384569789','GUANGXI');
四、效果
4002/4004每个负载均衡的每个数据库按枚举分片分到不同数据库中
3007,3008,3009,3010,3011 每个节点数据库中也都有相同的数据