From dd63e645cbd6b6775f10108d0f1fc39dde7ede57 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=BD=97=E7=A5=A5?= <1366971433@qq.com>
Date: Fri, 23 Aug 2019 18:01:54 +0800
Subject: [PATCH] mycat

---
 notes/MySQL_Mycat中间件.md  | 310 +++++++++++++++++++++++++++++++++
 notes/MySQL_分库分表.md    |   0
 pictures/mysql-mycat-login.png | Bin 0 -> 21437 bytes
 resources/ec_shop.sql          |  81 +++++++++
 4 files changed, 391 insertions(+)
 create mode 100644 notes/MySQL_Mycat中间件.md
 delete mode 100644 notes/MySQL_分库分表.md
 create mode 100644 pictures/mysql-mycat-login.png
 create mode 100644 resources/ec_shop.sql

diff --git a/notes/MySQL_Mycat中间件.md b/notes/MySQL_Mycat中间件.md
new file mode 100644
index 0000000..afb7d1c
--- /dev/null
+++ b/notes/MySQL_Mycat中间件.md
@@ -0,0 +1,310 @@
+# Mycat 基础
+
+## 一、Mycat 简介
+
+Mycat 是一个开源的数据库中间件，可以解决分布式数据库环境下的大多数问题，如读写分离、分库分表等，除此之外，它还具备以下特性：
+
+- 支持 MySQL、Oracle、DB2、SQL Server、PostgreSQL 等数据库常见的 SQL 语法。
+- 能够基于心跳机制进行自动地故障切换，支持读写分离，支持MySQL主从架构，以及 galera cluster 集群。
+- 支持数据的多片自动路由与聚合，支持 sum，count，max 等常用的聚合函数，支持跨库分页。
+- 支持单库内部任意 join，支持跨库两表 join，也支持基于 caltlet 的多表 join。
+- 支持通过全局表，ER 关系表等分片策略来实现多表 join 查询。
+- 支持XA分布式事务（1.6.5 +）。
+- 支持全局序列号，能够解决分布式环境下的主键生成问题。
+- 支持使用 zookeeper 来协调主从切换、统一管理配置数据以及使用 zookeeper 来生成全局唯一 ID。( 1.6+ )
+- 提供了 Web 监控界面，来对 Mycat、MySQL 以及服务器的状态进行监控。
+
+## 二、Mycat 核心概念
+
+在引入 Mycat 后，所有的客户端请求需要经过中间件进行转发上，此时客户端直接面向的是 Mycat 上的逻辑库或逻辑表：
+
+#### 逻辑库
+
+在 Mycat 的配置文件中进行定义，它对应一个或者多个实际的数据库或数据库集群。
+
+#### 逻辑表
+
+可以对应一张实际的表，也可以表示为多个分片表的集合。按其特性可以分为以下四类：
+
++ **分片表**：表按照指定键进行拆分，并散落到多个数据库实例上，从而可以解决单表过大的问题。
++ **非分片表**：通常情况下，只有大表需要分片，小表并没有分片的必要，所以在 Mycat 中它们也被称为非分片表，主要是为了在概念上与分片表进行区分。
++ **ER 表**：基于实体关系模型进行分片的表，如订单表和订单明细表通常都是大表，此时可以按照订单号进行 ER 分片，从而保证同一单号的订单记录和明细记录都处于同一分片上，进而避免跨分片查询。
++ **全局表**。同样也是用于解决跨分片查询的问题。假设在查询订单明细时需要查询产品所属分类 （如家电产品、生活用品），产品类别表通常是小表，此时可以声明为全局表，之后 Mycat 会将其拷贝到所有分片上，从而避免跨分片查询。
+
+#### 分片节点
+
+将表按照分片键进行分片后，一个表中的所有数据就会被分发到不同的数据库上，这些数据库节点就称为分片节点。
+
+## 三、Mycat 安装
+
+## 四、Mycat 基本配置
+
+在 Mycat 的安装目录的 `conf` 目录下，有以下三个核心配置文件：
+
++ **server.xml**：主要用于定义用户信息，全局 SQL 防火墙、以及与 Mycat 自身相关的配置。
++ **schema.xml**：主要用于定义逻辑库，逻辑表，逻辑数据节点以及实际的物理数据库的信息。
++ **rule.xml**：主要用于定义分片规则，并提供给 schema.xml 标签中的分片表使用。
+
+### 4.1 server.xml
+
+一个 server.xml 的配置示例如下，主要包含以下标签：
+
++ **\<system>** ：定义  Mycat 相关的配置。
++ **\<firewall>**：配置全局 SQL 防火墙，可以在其下通过子标签定义 IP 白名单和黑名单。
++ **\<user>**：用于设置默认账户或普通账户，并为其分配在逻辑库或逻辑表上的权限。权限通过 dml 属性来指定，如  dml="0110" ，四个位置上的数值分别对应 insert，update，select，delete 权限，1 为具有该权限，0 为不具有。
+
+```xml
+<system> 
+    <!-- 0为需要密码登陆、1为不需要密码登陆 ,默认为0，设置为1则需要指定默认账户-->
+    <property name="nonePasswordLogin">0</property> 
+    <property name="charset">utf8</property>
+</system>
+
+<firewall>
+    <whitehost>
+        <host host="1*7.0.0.*" user="root"/>
+    </whitehost>
+    <blacklist check="false">
+    </blacklist>
+</firewall>
+
+<!-- 定义默认账户-->
+<user name="root" defaultAccount="true">
+    <property name="password">123456</property>
+    <property name="schemas">TESTDB</property>
+    <!-- 权限设置 -->
+    <privileges check="true">
+        <schema name="TESTDB" dml="0110" >
+            <table name="tb01" dml="0000"></table>
+            <table name="tb02" dml="1111"></table>
+        </schema>
+    </privileges>
+</user>
+
+<!-- 定义默认账户-->
+<user name="user">
+    <property name="password">123456</property>
+    <property name="schemas">TESTDB</property>
+    <property name="readOnly">true</property>
+</user>
+```
+
+在上面的示例中，用户配置的是明文密码，这样会存在安全隐患，因此 Mycat 也支持对密码进行加密，示例如下：
+
+```shell
+# 该jar包在Mycat安装目录的lib目录下
+shell > java -cp Mycat-server-1.6.7.1-release.jar  io.mycat.util.DecryptUtil 0:root:123456
+GO0bnFVWrAuFgr1JMuMZkvfDNyTpoiGU7n/Wlsa151CirHQnANVk3NzE3FErx8v6pAcO0ctX3xFecmSr+976QA==
+```
+
+可以将明文密码替换为加密密码，但此时还需在对应用户的 user 标签下增加如下配置，代表启用加密功能：
+
+```xml
+<property name="usingDecrypt">1</property> 
+```
+
+### 4.2 schema.xml
+
+下面是一个示例的 schema.xml 配置文件，主要包含以下标签：
+
++ **\<schema>**：主要用于定义逻辑库，checkSQLschema 表明是否检查 schema，当其为 true 时，如果发送 `select * from db.table1` 等查询时，会自动修改为 `select * from table1` 。sqlMaxLimit 用于限制返回数据的行数。
++ **\<table>**：主要用于定义逻辑表。这里以分片表为例，定义了订单表的分片节点及分片规则。
++ **\<dataNode>**：定义逻辑数据节点。下面示例配置中的每个节点分别对应主从复制集群上的一个数据库实例。
++ **\<dataHost>**：实际的单台物理数据库或数据库集群，下面的示例配置中对应的是一个 maser-slave 集群。
+
+```xml
+<schema name="TESTDB" checkSQLschema="false" sqlMaxLimit="100">
+    <!-- mod-long 分片规则在下文的 rule.xml中定义 -->
+    <table name="order" dataNode="dn1,dn2,dn3" rule="mod-long" />
+</schema>
+
+<dataNode name="dn1" dataHost="cluster01" database="order_db" />
+<dataNode name="dn2" dataHost="cluster02" database="order_db" />
+<dataNode name="dn3" dataHost="cluster03" database="order_db" />
+
+<dataHost name="cluster01" maxCon="1000" minCon="10" balance="0"
+          dbType="mysql" dbDriver="native" switchType="1">
+    <!-- 心跳检查 -->
+    <heartbeat>select user()</heartbeat>
+    <writeHost host="master" url="192.168.0.226:3306" user="root"  password="123456">
+        <readHost host="salve" url="192.168.0.227:3306" user="root" password="123456" />
+    </writeHost>
+</dataHost>
+
+...... 省略 cluster02，cluster03
+```
+
+这里解释一下 dataHost 标签的相关属性：maxCon 表示最大连接数，minCon 表示最小连接数，dbType 表示数据库类型 ( 如 mysql、oracle 等)，其他属性都有多个可选值，具体如下：
+
++ **dbDriver**：数据库类型，可选的值有 native 和 JDBC，如果是 mysql，maridb，postgresql 等数据库，直接可以使用 native  即可。其他数据库则需要将对应的驱动包拷贝到 Mycat 安装目录的 lib 目录下，并写上完整的驱动类的类名。
+
++ **switchType**：
+
+  默认值为 1，代表自动切换；
+
+  设置为 2，代表基于 MySQL 主从同步的状态来决定是否切换；
+
+  设置为 3，代表基于 MySQL galary cluster 的切换机制进行切换；
+
+  如果你的集群基于 MMM 或 MHA 等高可用架构实现自动切换，则可以将该值设置为 -1，代表不切换。
+
++ **balance**：
+
+  balance="0" ：不开启读写分离机制，所有读请求都发送到当前可用的 writeHost 上。
+
+  balance="1" ：全部的 readHost 与 stand by writeHost 参与读操作。stand by writeHost 通常指的是双主复制中处于 stand 状态的主节点，即假设集群复制架构为 Master1 -> Slave1，Master2 -> Slave2，并且 M1 与 M2  互为主备 )，此时 Master2 ，Slave1，Slave2 都会参与读的负载。
+
+  balance="2" ：所有读请求随机在 writeHost、 readhost 上进行分发。
+
+  balance="3" ：所有读请求随机分发到 writeHost 对应的 readhost 执行，writerHost 不负担读压力。
+
+### 4.3 rule.xml
+
+rule.xml 文件中定义的是分片规则，主要包含以下标签：
+
++ **\<tableRule>**：定义分片规则的名称，分片键和分片算法。以下分片规则表示对订单 Id 按照取模算法进行分片。
++ **\<function>**：定义分片算法的具体实现类，以及所需要的参数。
+
+```xml
+<tableRule name="mod-long">
+    <rule>
+        <columns>order_id</columns>
+        <algorithm>mod-long</algorithm>
+    </rule>
+</tableRule>
+<function name="mod-long" class="io.mycat.route.function.PartitionByMod">
+    <!-- nodes 节点的数量-->
+    <property name="count">3</property>
+</function>
+```
+
+Mycat 内置支持十几种分片算法，如 取模分片，枚举分片，范围分片，字符串 hash 分片，一致性 hash 分片，日期分片等。关于这些分片算法的详细说明可以参考官方文档：[Mycat 官方指南](http://www.mycat.io/document/mycat-definitive-guide.pdf)
+
+## 五、Mycat 读写分离
+
+
+
+## 六、Mycat 分库分表
+
+```xml
+<system>
+    <property name="fakeMySQLVersion">5.7.20</property>
+</system>
+
+<user name="heibaiying">
+    <property name="password">
+        B+BlA/U17pjyzHslglpDgYUxpgqK8qC62IRt/S74RBW6R7dZFJAXVb5tJDgmhzM4fj14MMhLnNmvKko6D73+iA==
+    </property>
+    <property name="schemas">ec_shop</property>
+    <property name="usingDecrypt">1</property>
+</user>
+```
+
+
+
+```xml
+<?xml version="1.0"?>
+<!DOCTYPE mycat:schema SYSTEM "schema.dtd">
+<mycat:schema xmlns:mycat="http://io.mycat/">
+
+    <schema name="ec_shop" checkSQLschema="false" sqlMaxLimit="100">
+        <table name="customers" primaryKey="customer_id" dataNode="dn01"/>
+        <table name="products" primaryKey="product_id" dataNode="dn02"/>
+        <table name="orders" primaryKey="order_id" dataNode="dn03,dn04" rule="mod-long">
+            <childTable name="order_detail" primaryKey="order_detail_id" joinKey="order_id"
+                        parentKey="order_id"/>
+        </table>
+        <table name="area_info" primaryKey="area_id" type="global" dataNode="dn01,dn02,dn03,dn04"/>
+    </schema>
+
+
+    <dataNode name="dn01" dataHost="host01" database="ec_shop_customer"/>
+    <dataNode name="dn02" dataHost="host02" database="ec_shop_product"/>
+    <dataNode name="dn03" dataHost="host03" database="ec_shop_order"/>
+    <dataNode name="dn04" dataHost="host04" database="ec_shop_order"/>
+
+    <dataHost name="host01" maxCon="1000" minCon="10" balance="0"
+              dbType="mysql" dbDriver="native" switchType="1">
+        <heartbeat>select user()</heartbeat>
+        <writeHost host="master" url="192.168.0.226:3306" user="root" password="123456"/>
+    </dataHost>
+
+    <dataHost name="host02" maxCon="1000" minCon="10" balance="0"
+              dbType="mysql" dbDriver="native" switchType="1">
+        <heartbeat>select user()</heartbeat>
+        <writeHost host="master" url="192.168.0.227:3306" user="root" password="123456"/>
+    </dataHost>
+
+    <dataHost name="host03" maxCon="1000" minCon="10" balance="0"
+              dbType="mysql" dbDriver="native" switchType="1">
+        <heartbeat>select user()</heartbeat>
+        <writeHost host="master" url="192.168.0.228:3306" user="root" password="123456"/>
+    </dataHost>
+
+    <dataHost name="host04" maxCon="1000" minCon="10" balance="0"
+              dbType="mysql" dbDriver="native" switchType="1">
+        <heartbeat>select user()</heartbeat>
+        <writeHost host="master" url="192.168.0.229:3306" user="root" password="123456"/>
+    </dataHost>
+
+</mycat:schema>
+```
+
+
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE mycat:rule SYSTEM "rule.dtd">
+<mycat:rule xmlns:mycat="http://io.mycat/">
+    <tableRule name="mod-long">
+        <rule>
+            <columns>order_id</columns>
+            <algorithm>mod-long</algorithm>
+        </rule>
+    </tableRule>
+    <function name="mod-long" class="io.mycat.route.function.PartitionByMod">
+        <!-- nodes 节点的数量-->
+        <property name="count">2</property>
+    </function>
+</mycat:rule>
+```
+
+
+
+## 七、Mycat 与 MySQL 8.0
+
+```shell
+mysql -uheibaiying -p -h127.0.0.1 -P8066 --default_auth=mysql_native_password
+```
+
+```sql
+ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'xxxx';
+FLUSH PRIVILEGES;
+```
+
+```sql
+mysql> SELECT Host,User,plugin FROM mysql.user;
++---------------+------------------+-----------------------+
+| Host          | User             | plugin                |
++---------------+------------------+-----------------------+
+| %             | root             | mysql_native_password |
+| 192.168.200.% | repl             | mysql_native_password |
+| localhost     | mysql.infoschema | caching_sha2_password |
+| localhost     | mysql.session    | caching_sha2_password |
+| localhost     | mysql.sys        | caching_sha2_password |
+| localhost     | root             | mysql_native_password |
++---------------+------------------+-----------------------+
+```
+
+
+
+## 参考资料
+
+[Mycat 官方指南](http://www.mycat.io/document/mycat-definitive-guide.pdf)
+
+
+
+
+
+
+
diff --git a/notes/MySQL_分库分表.md b/notes/MySQL_分库分表.md
deleted file mode 100644
index e69de29..0000000
diff --git a/pictures/mysql-mycat-login.png b/pictures/mysql-mycat-login.png
new file mode 100644
index 0000000000000000000000000000000000000000..0531e050547f5d19d79690e6a6d5000ed53aa6b7
GIT binary patch
literal 21437
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

literal 0
HcmV?d00001

diff --git a/resources/ec_shop.sql b/resources/ec_shop.sql
new file mode 100644
index 0000000..0e3616a
--- /dev/null
+++ b/resources/ec_shop.sql
@@ -0,0 +1,81 @@
+-- 用户数据库
+CREATE DATABASE ec_shop_customer;
+-- 商品数据库
+CREATE DATABASE ec_shop_product;
+-- 订单数据库
+CREATE DATABASE ec_shop_order;
+
+-- 用户表
+CREATE TABLE IF NOT EXISTS customers
+(
+    customer_id   INT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '用户ID',
+    customer_name VARCHAR(20)  NOT NULL COMMENT '用户姓名',
+    modified_time TIMESTAMP    NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '最后修改时间',
+    PRIMARY KEY pk_customer_id (customer_id)
+) ENGINE = innodb COMMENT '用户信息表';
+
+INSERT INTO customers(customer_name) VALUE ('heibai');
+INSERT INTO customers(customer_name) VALUE ('ying');
+
+
+-- 商品表
+CREATE TABLE products
+(
+    product_id    INT UNSIGNED NOT NULL COMMENT '商品ID',
+    product_name  VARCHAR(20)  NOT NULL COMMENT '商品名称',
+    modified_time TIMESTAMP    NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '最后修改时间',
+    PRIMARY KEY pk_product_id (product_id)
+) ENGINE = innodb COMMENT '商品表';
+
+INSERT INTO products(product_id, product_name) VALUE (1, 'MIX5手机');
+INSERT INTO products(product_id, product_name) VALUE (2, '大熊饼干');
+
+
+-- 订单表
+CREATE TABLE IF NOT EXISTS orders
+(
+    order_id      INT UNSIGNED NOT NULL COMMENT '订单ID',
+    customer_id   INT UNSIGNED NOT NULL COMMENT '购买者ID',
+    modified_time TIMESTAMP    NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '最后修改时间',
+    PRIMARY KEY pk_order_id (order_id)
+) ENGINE = innodb COMMENT '订单表';
+
+INSERT INTO orders(order_id, customer_id) VALUE (1001, 1);
+INSERT INTO orders(order_id, customer_id) VALUE (1002, 2);
+INSERT INTO orders(order_id, customer_id) VALUE (1003, 1);
+INSERT INTO orders(order_id, customer_id) VALUE (1004, 2);
+
+
+-- 订单明细表
+CREATE TABLE IF NOT EXISTS order_detail
+(
+    order_detail_id INT UNSIGNED NOT NULL COMMENT '主键ID',
+    order_id        INT UNSIGNED NOT NULL COMMENT '订单ID',
+    product_id      INT UNSIGNED NOT NULL COMMENT '商品ID',
+    modified_time   TIMESTAMP    NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '最后修改时间',
+    PRIMARY KEY pk_order_detail_id (order_detail_id)
+) ENGINE = innodb COMMENT '订单明细表';
+
+INSERT INTO order_detail(order_detail_id, order_id, product_id) VALUE (15, 1001, 1);
+INSERT INTO order_detail(order_detail_id, order_id, product_id) VALUE (16, 1001, 2);
+INSERT INTO order_detail(order_detail_id, order_id, product_id) VALUE (17, 1002, 1);
+INSERT INTO order_detail(order_detail_id, order_id, product_id) VALUE (18, 1003, 1);
+INSERT INTO order_detail(order_detail_id, order_id, product_id) VALUE (19, 1004, 1);
+INSERT INTO order_detail(order_detail_id, order_id, product_id) VALUE (10, 1004, 2);
+
+-- 地址表
+CREATE TABLE area_info
+(
+    area_id       INT UNSIGNED AUTO_INCREMENT NOT NULL COMMENT '主键ID',
+    code          varchar(6)                  NOT NULL COMMENT '行政单位代码',
+    name          varchar(50)                 NOT NULL COMMENT '行政单位名称',
+    parent_code   varchar(6)                  NOT NULL COMMENT '上一级行政单位代码',
+    modified_time TIMESTAMP                   NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '最后修改时间',
+    PRIMARY KEY pk_id (area_id)
+) ENGINE = innodb COMMENT '地址表';
+
+INSERT INTO area_info(code, name, parent_code)
+VALUES ('110100', '市辖区', '110000');
+INSERT INTO area_info(code, name, parent_code)
+VALUES ('110101', '东城区', '110100');
+