SUSE12SP3-Mycat(2)Schema.xml配置详解
简介
schema.xml 作为 mycat 中重要的配置文件之一,管理着 mycat 的逻辑库、表、分片规则、datanode 以及 datasource。弄懂这些配置,是正确使用 mycat 的前提。这里就一层层对该文件进行解析。
schema 标签
schema 标签用于定义 mycat 实例中的逻辑库,如:
<schema name="testdb" checksqlschema="false" sqlmaxlimit="100"></schema>
name属性
配置逻辑库的名字(即数据库实例名);
datanode属性
用于配置该逻辑库默认的分片。没有通过table标签配置的表,就会走到默认的分片上。这里注意没有配置在table标签的表,用工具查看是无法显示的,但是可以正常使用。
如果没有配置datanode属性,则没有配置在table标签的表,是无法使用的。注意,dual表在mycat中,也被视为一个表。
另外,通过mycat建表,而该表并没有提前配置table标签,则mycat会找到默认的datanode,并把表建在默认的datanode上。如果没有配置默认datanode,则mycat会报错。
而如果该表有配置table标签,则表会分别在table标签指定的datanode上建表。
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
语句的最好是不带这个字段。
false:会报错
sqlmaxlimit属性
当该值设置为某个数值时。每条执行的 sql 语句,如果没有加上 limit 语句,mycat 也会自动的加上所对应
的值。例如设置值为 100,执行select * from testdb.travelrecord;的效果为和执行select * from
testdb.travelrecord limit 100;相同。
设置该值的话,mycat 默认会把查询到的信息全部都展示出来,造成过多的输出。所以,在正常使用中,还
是建议加上一个值,用于减少过多的数据返回。
72
当然 sql 语句中也显式的指定 limit 的大小,不受该属性的约束。
需要注意的是,如果运行的 schema 为非拆分库的,那么该属性不会生效。需要手动添加 limit 语句。
table 标签
<table name="travelrecord" datanode="dn1,dn2,dn3" rule="auto-sharding-long" ></table>
name 属性
定义逻辑表的表名,这个名字就如同我在数据库中执行 create table 命令指定的名字一样,同个 schema 标 签中定义的名字必须唯一。
datanode 属性
定义这个逻辑表所属的 datanode, 该属性的值需要和 datanode 标签中 name 属性的值相互对应。如果需 要定义的 dn 过多 可以使用如下的方法减少配置: ```xml <table name="travelrecord" datanode="multipledn$0-99,multipledn2$100-199" rule="auto-shardinglong" ></table> <datanode name="multipledn$0-99" datahost="localhost1" database="db$0-99" ></datanode> <datanode name="multipledn2$100-199" datahost="localhost1" database=" db$100-199" ></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()才会返回插入的分片键值。 如果要使用这个功能最好配合使用数据库模式的全局序列。 74 使用 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 name="dn1" datahost="lch3307" database="db1" ></datanode>
datanode 标签定义了 mycat 中的数据节点,也就是我们通常说所的数据分片。一个 datanode 标签就是
一个独立的数据分片。
例子中所表述的意思为:使用名字为 lch3307 数据库实例上的 db1 物理数据库,这就组成一个数据分片,最后,我们使用名字 dn1 标识这个分片。
datanode 标签的相关属性:
属性 | 值 | 数量限制 |
---|---|---|
name | string | (1) |
datahost | string | (1) |
database | string | (1) |
name 属性
定义数据节点的名字,这个名字需要是唯一的,我们需要在 table 标签上应用这个名字,来建立表与分片对应的关系。
datahost 属性
该属性用于定义该分片属于哪个数据库实例的,属性值是引用 datahost 标签上定义的 name 属性。
database 属性
该属性用于定义该分片属性哪个具体数据库实例上的具体库,因为这里使用两个纬度来定义分片,就是:实 例+具体的库。因为每个库上建立的表和表结构是一样的。所以这样做就可以轻松的对表进行水平拆分。
datahost 标签
作为 schema.xml 中最后的一个标签,该标签在 mycat 逻辑库中也是作为最底层的标签存在,直接定义了具体的数据库实例、读写分离配置和心跳语句。现在我们就解析下这个标签。
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 种:
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 以后废弃不推荐。
switchtype 属性
- -1 表示不自动切换。
- 1 默认值,自动切换。
- 2 基于 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 基于 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 属性
用于标识不同实例,一般 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 以后):
推荐阅读
-
centos下fail2ban安装与配置详解
-
RxJava2配置及使用详解
-
Apache 2配置域名绑定的方法详解
-
iPad Pro跑分配置详解 iPad Pro/iPad Air2/MacBook/Surface Pro4跑分对比评测
-
SUSE12SP3-Mycat(2)Schema.xml配置详解
-
Windows server 2008 R2 多用户远程桌面配置详解(超过两个用户)
-
小米平板2樱花粉版多少钱? 小米平板2女神版价格及配置详解
-
小米平板2什么配置 小米平板电脑2配置参数详解
-
Win2008 r2服务器配置VPN服务器教程(图文详解)
-
webpack 2.x配置reactjs基本开发环境详解