MyCat配置

257
MyCat
  1. schema.xml
    1. schema 标签
    2. table 标签
      1. name 属性
      2. dataNode 属性
      3. rule 属性
      4. ruleRequired 属性
      5. primaryKey 属性
      6. type 属性
    3. childTable 标签
      1. name 属性
      2. joinKey 属性
      3. parentKey 属性
    4. dataNode 标签
      1. name 属性
      2. dataHost 属性
      3. database 属性
    5. dataHost 标签
      1. name 属性
      2. maxCon 属性
      3. minCon 属性
      4. balance 属性
      5. writeType 属性
      6. dbType 属性
      7. dbDriver 属性
      8. switchType 属性
      9. tempReadHostAvailable 属性
    6. heartbeat 标签
      1. writeHost 标签、readHost 标签
      2. host 属性
      3. url 属性
      4. user 属性
      5. password 属性
      6. weight 属性
      7. usingDecrypt 属性

schema.xml

schema 标签

1
<schema name="testdb" checkSQLschema="false" sqlMaxLimit="100" dataNode="dn1">

这里testdb就是我们对外声称的我们有数据库的名称 必须和server.xml中的用户指定的数据库名称一致

  • checkSQLschema
    当该值设置为 true 时，如果我们执行语句select * from TESTDB.travelrecord;则 MyCat 会把语句修改 为select * from travelrecord;。即把表示 schema 的字符去掉，避免发送到后端数据库执行时报(ERROR 1146 (42S02): Table ‘testdb.travelrecord’ doesn’t exist)。不过，即使设置该值为 true ，如果语句所带的是并非是 schema 指定的名字，例如:select * from db1.travelrecord; 那么 MyCat 并不会删除 db1 这个字段，如果没有定义该库的话则会报错，所以在提供 SQL 语句的最好是不带这个字段
  • dataNode
    添加一个dataNode="dn1" 是指定了我们这个库只在dn1上.没有进行分库
  • sqlMaxLimit
    当该值设置为某个数值时。每条执行的 SQL 语句，如果没有加上 limit 语句，MyCat 也会自动的加上所对应 的值。例如设置值为 100,执行select * from TESTDB.travelrecord;的效果为和执行select * from TESTDB.travelrecord limit 100;相同。
    设置该值的话，MyCat 默认会把查询到的信息全部都展示出来，造成过多的输出。所以，在正常使用中，还 是建议加上一个值，用于减少过多的数据返回。
    当然 SQL 语句中也显式的指定 limit 的大小，不受该属性的约束。
    需要注意的是，如果运行的 schema 为非拆分库的，那么该属性不会生效。需要手动添加 limit 语句。

table 标签

1
<table name="travelrecord" dataNode="dn1,dn2,dn3" rule="auto-sharding-long" ></table>

Table 标签定义了 MyCat 中的逻辑表，所有需要拆分的表都需要在这个标签中定义

name 属性

定义逻辑表的表名，这个名字就如同我在数据库中执行 create table 命令指定的名字一样，同个 schema 标 签中定义的名字必须唯一。

dataNode 属性

定义这个逻辑表所属的 dataNode, 该属性的值需要和 dataNode 标签中 name 属性的值相互对应

rule 属性

该属性用于指定逻辑表要使用的规则名字，规则名字在 rule.xml 中定义，必须与 tableRule 标签中 name 属性值一一对应

ruleRequired 属性

该属性用于指定表是否绑定分片规则，如果配置为 true，但没有配置具体 rule 的话 ，程序会报错

primaryKey 属性

该逻辑表对应真实表的主键

例如:分片的规则是使用非主键进行分片的，那么在使用主键查询的时候，就 会发送查询语句到所有配置的 DN 上，如果使用该属性配置真实表的主键。难么 MyCat 会缓存主键与具体 DN 的 信息，那么再次使用非主键进行查询的时候就不会进行广播式的查询，就会直接发送语句给具体的 DN，但是尽管 配置该属性，如果缓存并没有命中的话，还是会发送语句给具体的 DN，来获得数据

type 属性

该属性定义了逻辑表的类型，目前逻辑表只有全局表和普通表两种类型。对应的配置:

  • 全局表:global
  • 普通表:不指定该值为 global 的所有表

childTable 标签

childTable 标签用于定义 E-R 分片的子表。通过标签上的属性与父表进行关联

name 属性

定义子表的表名

joinKey 属性

插入子表的时候会使用这个列的值查找父表存储的数据节点。

parentKey 属性

属性指定的值一般为与父表建立关联关系的列名。程序首先获取 joinkey 的值，再通过 parentKey 属性指定 的列名产生查询语句，通过执行该语句得到父表存储在哪个分片上。从而确定子表存储的位置

dataNode 标签

1
<dataNode name="dn1" dataHost="lch3307" database="db1" ></dataNode>

dataNode 标签定义了 MyCat 中的数据节点，也就是我们通常说所的数据分片。一个 dataNode 标签就是 一个独立的数据分片。
例子中所表述的意思为:使用名字为 lch3307 数据库实例上的 db1 物理数据库，这就组成一个数据分片，最后，我们使用名字 dn1 标识这个分片

name 属性

定义数据节点的名字，这个名字需要是唯一的，我们需要在 table 标签上应用这个名字，来建立表与分片对应的关系。

dataHost 属性

该属性用于定义该分片属于哪个数据库实例的，属性值是引用 dataHost 标签上定义的 name 属性。

database 属性

该属性用于定义该分片属性哪个具体数据库实例上的具体库，因为这里使用两个纬度来定义分片，就是:实例+具体的库。因为每个库上建立的表和表结构是一样的。所以这样做就可以轻松的对表进行水平拆分。

dataHost 标签

直接定义了具 体的数据库实例、读写分离配置和心跳语句

1
<dataHost name="localhost1" maxCon="1000" minCon="10" balance="0" writeType="0" dbType="mysql" dbDriver="native" switchType="1"  slaveThreshold="100">

name 属性

唯一标识 dataHost 标签，供上层的标签使用

maxCon 属性

指定每个读写实例连接池的最大连接。也就是说，标签内嵌套的 writeHost、readHost 标签都会使用这个属性的值来实例化出连接池的最大连接数。

minCon 属性

指定每个读写实例连接池的最小连接，初始化连接池的大小

balance 属性

负载均衡类型，目前的取值有 4 种：

  • balance="0", 不开启读写分离机制，所有读操作都发送到当前可用的 writeHost 上。
  • balance="1"，全部的 readHost 与 stand by writeHost 参与 select 语句的负载均衡，简单的说，当双主双从模式(M1 ->S1 ， M2->S2，并且 M1 与 M2 互为主备)，正常情况下， M2,S1,S2 都参与 select 语句的负载均衡。
  • balance="2"，所有读操作都随机的在 writeHost、 readhost 上分发。
  • balance="3"， 所有读请求随机的分发到 wiriterHost 对应的 readhost 执行,writerHost 不负担读压力，注意 balance=3 只在 1.4 及其以后版本有， 1.3 没有。

writeType 属性

负载均衡类型，目前的取值有 3 种:

  • writeType="0", 所有写操作发送到配置的第一个 writeHost，第一个挂了切到还生存的第二个 writeHost，重新启动后已切换后的为准，切换记录在配置文件中:dnindex.properties
  • writeType="1"，所有写操作都随机的发送到配置的 writeHost，1.5 以后废弃不推荐。
  • -1 表示不自动切换
  • 默认值，自动切换
  • 基于 MySQL 主从同步的状态决定是否切换

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。

switchType 属性

  • -1 表示不自动切换
  • 1 默认值，自动切换
  • 2 基于MySQL主从同步的状态决定是否切换 心跳语句为 show slave status
  • 3 基于MySQLgalarycluster的切换机制(适合集群)(1.4.1) 心跳语句为 show status like ‘wsrep%’

tempReadHostAvailable 属性

如果配置了这个属性 writeHost 下面的 readHost 仍旧可用，默认 0 可配置(0、1)

heartbeat 标签

  • 这个标签内指明用于和后端数据库进行心跳检查的语句。
    例如MYSQL 可以使用 select user()，Oracle 可以使用 select 1 from dual 等。
    这个标签还有一个 connectionInitSql 属性，主要是当使用 Oracla 数据库时，需要执行的初始化 SQL 语句就 这个放到这里面来。例如:alter session set nls_date_format='yyyy-mm-dd hh24:mi:ss'.
  • 主从切换的语句必须是:show slave status

writeHost 标签、readHost 标签

这两个标签都指定后端数据库的相关配置给 mycat，用于实例化后端连接池。唯一不同的是，writeHost 指定写实例、readHost 指定读实例，组着这些读写实例来满足系统的要求。
在一个 dataHost 内可以定义多个 writeHost 和 readHost。但是，如果 writeHost 指定的后端数据库宕机， 那么这个 writeHost 绑定的所有 readHost 都将不可用。另一方面，由于这个 writeHost 宕机系统会自动的检测到，并切换到备用的 writeHost 上去。

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 以后):

1
2
java -cp Mycat-server-1.4.1-dev.jar org.opencloudb.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 名称