schema.xml配置文件
schema.xml 做为 MyCat 中重要的配置文件之一,管理着 MyCat 的逻辑库、表、分片规则、DataNode 以及 DataSource。java
<一>schema 标签
schema 标签用于定义 MyCat 实例中的逻辑库,MyCat 能够有多个逻辑库,每一个逻辑库都有本身的相关配置。可使用 schema 标签来划分这些不一样的逻辑库。
若是不配置 schema 标签,全部的表配置,会属于同一个默认的逻辑库。python
<schema name="TESTDB" checkSQLschema="false" sqlMaxLimit="100"> <table name="travelrecord" dataNode="dn1,dn2,dn3" rule="auto-sharding-long" ></table> </schema> <schema name="USERDB" checkSQLschema="false" sqlMaxLimit="100"> <table name="company" dataNode="dn10,dn11,dn12" rule="auto-sharding-long" ></table> </schema>
如上所示的配置就配置了两个不一样的逻辑库,逻辑库的概念和 MYSQL 数据库中 Database 的概念相同,咱们在查询这两个不一样的逻辑库中表的时候须要切换到该逻辑库下才能够查询到所须要的表。mysql
schema 标签的相关属性:sql
属性名 值 数量限制
dataNode 任意String (0..1)
checkSQLschema Boolean (1)
sqlMaxLimit Integer (1)mongodb
dataNode属性:
该属性用于绑定逻辑库到某个具体的 database 上,1.3 版本若是配置了 dataNode,则不能够配置分片表,1.4 能够配置默认分片,只须要配置须要分片的表便可,具体以下配置:
1.3 配置:
<schema name="USERDB" checkSQLschema="false" sqlMaxLimit="100" dataNode="dn1">
<!—里面不能配置任何表-->
</schema>数据库1.4 配置:
<schema name="USERDB" checkSQLschema="false" sqlMaxLimit="100" dataNode="dn2">
<!—配置须要分片的表-->
<table name=“tuser” dataNode=”dn1”/>
</schema>后端那么如今 tuser 就绑定到 dn1 所配置的具体 database 上,能够直接访问这个 database,没有配置的表则会走
默认节点 dn2,这里注意没有配置在分片里面的表工具查看没法显示,可是能够正常使用。缓存
checkSQLschema属性:
当该值设置为 true 时,若是咱们执行语句 select * from TESTDB.travelrecord;,
则 MyCat 会把语句修改成 select * from travelrecord;。即把表示 schema 的字符去掉,避免发送到后端数据库执行时报
(ERROR1146 (42S02): Table ‘testdb.travelrecord’ doesn’t exist)。
不过,即便设置该值为 true ,若是语句所带的是并不是是 schema 指定的名字,例如:select * from db1.travelrecord; 那么 MyCat 并不会删除 db1 这个字段,若是没有定义该库的话则会报错。
因此在提供 SQL语句的最好是不带这个字段。 session
sqlMaxLimit属性:
当该值设置为某个数值时。每条执行的 SQL 语句,若是没有加上 limit 语句,MyCat 也会自动的加上所对应的值。例如设置值为 100,
执行 select * from TESTDB.travelrecord; 的效果为和执行 select * from TESTDB.travelrecord limit 100;相同。
不设置该值的话,MyCat 默认会把查询到的信息所有都展现出来,形成过多的输出。因此,在正常使用中,仍是建议加上一个值,用于减小过多的数据返回。
固然 SQL 语句中也显式的指定 limit 的大小,不受该属性的约束。
须要注意的是,若是运行的 schema 为非拆分库的,那么该属性不会生效。须要手动添加 limit 语句。 oracle
<二>table 标签
Table 标签订义了 MyCat 中的逻辑表,全部须要拆分的表都须要在这个标签中定义。
<table name="travelrecord" dataNode="dn1,dn2,dn3" rule="auto-sharding-long" ></table>
属性名 值 数量限制
name String (1)
dataNode String (1..*)
rule String (0..1)
ruleRequired boolean (0..1)
primaryKey String (1)
type String (0..1)
autoIncrement boolean (0..1)
subTables String (1)
needAddLimit boolean (0..1)
name 属性:
定义逻辑表的表名,这个名字就如同我在数据库中执行 create table 命令指定的名字同样,同个 schema 标签中定义的名字必须惟一。
dataNode 属性:
定义这个逻辑表所属的 dataNode, 该属性的值须要和 dataNode 标签中 name 属性的值相互对应。若是须要定义的 dn 过多可使用以下的方法减小配置:<table name="travelrecord" dataNode="multipleDn$0-99,multipleDn2$100-199" rule="auto-sharding-long" ></table> <dataNode name="multipleDn" dataHost="localhost1" database="db$0-99" ></dataNode> <dataNode name="multipleDn2" dataHost="localhost1" database=" db$0-99" ></dataNode> ##这里须要注意的是 database 属性所指定的真实 database name 须要在后面添加一个,例如上面的例子中,我须要在真实的 mysql 上创建名称为 dbs0 到 dbs99 的 database。
rule 属性:
该属性用于指定逻辑表要使用的规则名字,规则名字在 rule.xml 中定义,必须与 tableRule 标签中 name 属性属性值一一对ruleRequired 属性:
该属性用于指定表是否绑定分片规则,若是配置为 true,但没有配置具体 rule 的话 ,程序会报错。
primaryKey 属性:
该逻辑表对应真实表的主键,例如:分片的规则是使用非主键进行分片的,那么在使用主键查询的时候,就会发送查询语句到全部配置的 DN 上;若是使用该属性配置真实表的主键,那么 MyCat 会缓存主键与具体 DN 的信息,那么再次使用主键进行查询的时候就不会进行广播式的查询,就会直接发送语句给具体的 DN,可是尽管配置该属性,若是缓存并无命中的话,仍是会发送语句给具体的 DN,来得到数据。
type 属性:该属性定义了逻辑表的类型,目前逻辑表只有“全局表”和”普通表”两种类型。
对应的配置:
全局表:global。
普通表:不指定该值为 globla 的全部表。
autoIncrement 属性:
mysql 对非自增加主键,使用 last_insert_id()是不会返回结果的,只会返回 0。因此,只有定义了自增加主键的表才能够用 last_insert_id()返回主键值。mycat 目前提供了自增加主键功能,可是若是对应的 mysql 节点上数据表,没有定义 auto_increment,那么在 mycat 层调用 last_insert_id()也是不会返回结果的。
因为 insert 操做的时候没有带入分片键,mycat 会先取下这个表对应的全局序列,而后赋值给分片键。这样才能正常的插入到数据库中,最后使用 last_insert_id()才会返回插入的分片键值。
若是要使用这个功能最好配合使用数据库模式的全局序列。
使用 autoIncrement=“true” 指定这个表有使用自增加主键,这样 mycat 才会不抛出分片键找不到的异常。
使用 autoIncrement=“false” 来禁用这个功能,固然你也能够直接删除掉这个属性。默认就是禁用的。
subTables 属性:
使用方式添加 subTables="t_order$1-2,t_order3"目前分表 1.6 之后开始支持 而且 dataNode 在分表条件下只能配置一个,分表条件下不支持各类条件的join 语句。
needAddLimit 属性:
指定表是否须要自动的在每一个语句后面加上 limit 限制。因为使用了分库分表,数据量有时会特别巨大。这时候执行查询语句,若是恰巧又忘记了加上数量限制的话。
那么查询全部的数据出来,也够等上一小会儿的。因此,mycat 就自动的为咱们加上 LIMIT 100。固然,若是语句中有 limit,就不会在次添加了。
这个属性默认为 true,你也能够设置成 false 禁用掉默认行为。
<三>childTable 标签
childTable 标签用于定义 E-R 分片的子表。经过标签上的属性与父表进行关联。
childTable 标签的相关属性:
属性名 值 数量限制
name String (1)
joinKey String (1)
parentKey String (1)
primaryKey String (0..1)
needAddLimit boolean (0..1)
name 属性:
定义子表的表名。joinKey 属性:
插入子表的时候会使用这个列的值查找父表存储的数据节点。parentKey 属性:
属性指定的值通常为与父表创建关联关系的列名。程序首先获取 joinkey 的值,再经过 parentKey 属性指定的列名产生查询语句,经过执行该语句获得父表存储在哪一个分片上。从而肯定子表存储的位置。primaryKey 属性:
同 table 标签所描述的。needAddLimit 属性:
同 table 标签所描述的。
<四>dataNode 标签
dataNode 标签订义了 MyCat 中的数据节点,也就是咱们一般说所的数据分片。一个 dataNode 标签就是一个独立的数据分片。
<dataNode name="dn1" dataHost="lch3307" database="db1" ></dataNode> ##例子中所表述的意思为:使用名字为 lch3307 数据库实例上的 db1 物理数据库,这就组成一个数据分片,最后,咱们使用名字 dn1 标识这个分片。
dataNode 标签的相关属性:
属性名 值 数量限制
name String (1)
dataHost String (1)
database String (1)
name 属性:
定义数据节点的名字,这个名字须要是惟一的,咱们须要在 table 标签上应用这个名字,来创建表与分片对应的关系。dataHost 属性:
该属性用于定义该分片属于哪一个数据库实例的,属性值是引用 dataHost 标签上定义的 name 属性。database 属性:
该属性用于定义该分片属性哪一个具体数据库实例上的具体库,由于这里使用两个纬度来定义分片,就是:实例+具体的库。由于每一个库上创建的表和表结构是同样的。因此这样作就能够轻松的对表进行水平拆分。
<五>dataHost 标签
该标签在 mycat 逻辑库中也是做为最底层的标签存在,直接定义了具体的数据库实例、读写分离配置和心跳语句。如今咱们就解析下这个标签。
<dataHost name="localhost1" maxCon="1000" minCon="10" balance="0" writeType="0" dbType="mysql" dbDriver="native"> <heartbeat>select user()</heartbeat> <writeHost host="hostM1" url="localhost:3306" user="root" password="123456"> <readHost host="hostS1" url="localhost:3306" user="root" password="123456"/> </writeHost> <writeHost host="hostM2" url="localhost:3316" user="root" password="123456"/> </dataHost>
dataHost 标签的相关属性:
属性名 值 数量限制
name String (1)
maxCon Integer (1)
minCon Integer (1)
balance Integer (1)
writeType Integer (1)
dbType String (1)
dbDriver String (1)
name 属性:
惟一标识 dataHost 标签,供上层的标签使用。maxCon 属性:
指定每一个读写实例链接池的最大链接。也就是说,标签内嵌套的 writeHost、readHost 标签都会使用这个属性的值来实例化出链接池的最大链接数。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 之后废弃不推荐。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 基于 MySQL galary cluster 的切换机制(适合集群)(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'
1.4 主从切换的语句必须是:show slave status
<七>writeHost 标签
readHost 标签
这两个标签都指定后端数据库的相关配置给 mycat,用于实例化后端链接池。惟一不一样的是,writeHost 指定写实例、readHost 指定读实例,组着这些读写实例来知足系统的要求。
在一个 dataHost 内能够定义多个 writeHost 和 readHost。可是,若是 writeHost 指定的后端数据库宕机,那么这个 writeHost 绑定的全部 readHost 都将不可用。另外一方面,因为这个 writeHost 宕机系统会自动的检测到,并切换到备用的 writeHost 上去。
这两个标签的属性相同,这里就一块儿介绍。
属性名 值 数量限制
host String (1)
url String (1)
password String (1)
user String (1)
weight String (1)
usingDecrypt String (1)
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 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 名称