02.mycat 配置详解 · 初心（学习笔记）

>[info] mycat 配置详解 **三个配置文件：（/usr/local/mycat/conf）** * schema.xml 逻辑库、表、分片节点等内容 * rule.xml 分片规则文件 * server.xml 用户及系统相关变量，如端口等 ### **1. schema.xml 配置** #### **1.1 schema 标签** 用来定义mycat实例中的逻辑库，mycat可以有多个逻辑库，每个逻辑库都有自己的相关配置。可以使用schema标签来划分这些不同的逻辑库。如果不配置schema标签，所有表的配置会属于同一个默认的逻辑库。逻辑库的概念和MySql的database的概念一样，我们在查询两个不同逻辑库中的表的时候，需要切换到该逻辑库下进行查询。 ~~~ <schema name="TESTDB" checkSQLschema="true" sqlMaxLimit="100"> ~~~ **name：** 逻辑库的名字，配置完成以后！用mycat身份登录以后，查看的数据库就名字就是`name`定义的`TESTDB` **checkSQLschema：** 当该值为true时，例如我们执行语句select * from TESTDB.company 。mycat会把语句修改为 select * from company 去掉TESTDB **sqlMaxLimit：** 该值设置为某个数值时，每条执行的sql语句，如果没有加上limit语句，Mycat会自动加上对应的值。不写的话，默认返回所有的值。需要注意的是，如果运行的schema为非拆分库的，那么该属性不会生效。需要自己sql语句加limit。 ***** #### **1.2 table 标签** table标签定义了mycat中的逻辑表，所有需要拆分的表都需要在这个标签中定义。 ~~~ <table name="travelrecord" dataNode="dn1,dn2,dn3" rule="auto-sharding-long" /> <table name="company" primaryKey="ID" type="global" dataNode="dn1,dn2,dn3" /> ~~~ **name：** name属性代表了逻辑表的表名，同一个schema中name标签中定义的名字必须唯一。如同我们在数据库执行create table 命令指定的名字一样。 **dataNode：** 表，存储再哪个数据库的节点中，多个用`“,”`隔开，该属性的值需要和dataNode标签中的name值相对应。 **rule：** 该属性指定逻辑表使用的规则名字，规则名字在rule.xml中定义，必须与tableRule标签中name属性对应。 **ruleRequired：** 该属性用于指定是否绑定分片规则，如果配置为true，但是没有配置具体rule时候，就会报错 **primaryKey：** 该属性代表了，逻辑表对应真实表的主键。例如：分片的规则是使用非主键进行分片的，那么在使用主键查询的时候，就会发送查询语句到所有配置的DN上，如果使用该属性配置真实表的主键，那么mycat会缓存主键与具体DN的信息，那么再次使用非主键进行查询的时候就不会进行广播式的查询，就会直接发送语句给具体的DN，但是尽管配置该属性，如果缓存并没有命中的话，还是会发送语句给具体的DN 来获取数据。 **type：** 该属性定义了逻辑表的类型，目前逻辑表只有全局表和普通表 ***** #### **1.4 childTable 标签** childTable 标签用于定义 E-R 分片的子表，通过标签上的属性与父表进行关联。 ~~~ <table name="customer" primaryKey="ID" dataNode="dn1,dn2" rule="sharding-by-intfile"> <childTable name="c_a" primaryKey="ID" joinKey="customer_id" parentKey="id" /> </table> ~~~ **name：** 子表的名称 **joinKey：** 子表中字段的名称 **parentKey：** 父表中字段名称 **primaryKey：** 同Table **needAddLimit** 同Table ***** #### **1.5 dataNode 标签** datanode标签定义了mycat中的数据节点，也就是我们所说的数据分片。一个datanode标签就是一个独立的数据分片。 ~~~ <dataNode name="dn1" dataHost="localhost1" database="mytest1" /> <dataNode name="dn2" dataHost="localhost1" database="mytest2" /> <dataNode name="dn3" dataHost="localhost1" database="mytest3" /> ~~~ 例子中的表述的意思为，使用名字为localhost1数据库实例上的mytest物理数据库，这就组成一个数据分片，最后我们用dn1来标示这个分片。 **name：** 定义数据节点的名字，这个名字需要唯一。我们在table标签上用这个名字来建立表与分片对应的关系 **dataHost：** 用于定义该分片属于哪个数据库实例，属性与datahost标签上定义的name对应 **database：** 用于定义该分片属于数据库实例上的具体库。（该分片上真实的数据库的名字） ***** #### **1.6 dataHost 标签** 这个标签直接定义了具体数据库实例，读写分离配置和心跳语句。 ~~~ <dataHost name="localhost1" maxCon="1000" minCon="10" balance="0" writeType="0" dbType="mysql" dbDriver="native" switchType="1" slaveThreshold="100"> <heartbeat>select user()</heartbeat>  <writeHost host="hostM1" url="localhost:3306" user="root" password="123456">  <readHost host="hostS2" url="192.168.1.200:3306" user="root" password="xxx" /> </writeHost> <writeHost host="hostS1" url="localhost:3316" user="root" password="123456" />  </dataHost> ~~~ **name：** 唯一标示dataHost标签，供上层使用 **maxCon：** 指定每个读写实例连接池的最大连接。 **minCon：** 指定每个读写实例连接池的最小连接，初始化连接池的大小 **balance：负载均称类型:** ~~~ 0：不开启读写分离机制，所有读操作都发送到当前可用的writeHost上 1：全部的readHost与stand by writeHost参与select语句的负载均衡，简单的说，当双主双从模式（M1-S1，M2-S2 并且M1 M2互为主备），正常情况下，M2,S1,S2都参与select语句的负载均衡。 2：所有读操作都随机的在writeHost、readHost上分发 3：所有读请求随机的分发到writeHst对应的readHost执行，writeHost不负担读写压力。 ~~~ **writeType：负载均衡类型。** ~~~ 0：所有的写操作发送到配置的第一个writeHost，第一个挂了切换到第二个。切换记录在文件dnindex.properties 1：所有的鞋操作都随机的发送到配置的writeHost，1.5以后版本废弃不推荐。 ~~~ **dbType：** 指定后端链接的数据库类型目前支持二进制的mysql协议，还有其他使用jdbc链接的数据库，例如：mongodb，oracle，spark等 **dbDriver：** 指定连接后段数据库使用的driver，目前可选的值有native和JDBC。使用native的话，因为这个值执行的是二进制的mysql协议，所以可以使用mysql和maridb，其他类型的则需要使用JDBC驱动来支持。如果使用JDBC的话需要符合JDBC4标准的驱动jar 放到mycat\\lib目录下，并检查驱动jar包中包括如下目录结构文件 META-INF\\services\\java.sql.Driver。在这个文件写上具体的driver类名，例如com.mysql.jdbc.DriverwriteHost readHost 指定后端数据库的相关配置给mycat，用于实例化后端连接池。 **switchType：** ~~~ -1不自动切换 1 默认值自动切换 2 基于MySql主从同步的状态决定是否切换（心跳语句为 show slave status） 3 基于mysql galary cluster 的切换机制（适合集群）1.4.1心跳语句为 show status like 'wsrep%' ~~~ **slaveThreshold：** 用于控制从库（Slave）与主库（Master）之间同步延迟的阈值。当从库的同步延迟超过这个阈值时，`mycat`会认为从库的数据与主库不一致，从而避免将读请求发送到该从库，以保证数据的一致性。这个参数的具体设置需要根据实际的业务需求和系统性能进行调整。需要注意的是，`slaveThreshold`参数只是`mycat`中的一个配置选项，要实现读写分离和主从同步，还需要结合其他参数和配置进行设置。同时，也需要根据具体的业务场景和需求来选择合适的读写分离和主从同步策略。 ***** #### **1.7 heartbeat 标签** 这个标签内指明用于和后端数据库进行心跳检查的语句。例如：MYSQL 可以使用`select user()`，Oracle 可以使用`select 1 from dual`等。 ***** #### **1.8 writeHost /readHost 标签** 这两个标签都指定后端数据库的相关配置，用于实例化后端连接池。唯一不同的是，writeHost 指定写实例、readHost 指定读实例。在一个 dataHost 内可以定义多个 writeHost 和 readHost。但是，如果 writeHost 指定的后端数据库宕机，那么这个 writeHost 绑定的所有 readHost 都将不可用。另一方面，由于这个 writeHost 宕机，系统会自动的检测到，并切换到备用的 writeHost 上去。这两个标签的属性相同，这里就一起介绍。 * `host`：用于标识不同实例，一般 writeHost 我们使用*M1，readHost 我们用*S1。 * `url`：后端实例连接地址。Native：地址：端口 JDBC：jdbc的url * `password`：后端存储实例需要的密码 * `user`：后端存储实例需要的用户名字 * `weight`：权重配置在 readhost 中作为读节点的权重 * `usingDecrypt`：是否对密码加密，默认0。具体加密方法看官方文档。 ***** ### **2. server.xml 配置** ***** ### **3. rule.xml 配置**