MyCat配置
schema.xml
schema 标签
|
|
这里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 标签
|
|
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 标签
|
|
dataNode
标签定义了 MyCat
中的数据节点,也就是我们通常说所的数据分片。一个 dataNode
标签就是 一个独立的数据分片。
例子中所表述的意思为:使用名字为 lch3307
数据库实例上的 db1
物理数据库,这就组成一个数据分片,最后,我们使用名字 dn1
标识这个分片
name 属性
定义数据节点的名字,这个名字需要是唯一的,我们需要在 table
标签上应用这个名字,来建立表与分片对应的关系。
dataHost 属性
该属性用于定义该分片属于哪个数据库实例的,属性值是引用 dataHost
标签上定义的 name
属性。
database 属性
该属性用于定义该分片属性哪个具体数据库实例上的具体库,因为这里使用两个纬度来定义分片,就是:实例
+具体的库
。因为每个库上建立的表和表结构是一样的。所以这样做就可以轻松的对表进行水平拆分。
dataHost 标签
直接定义了具 体的数据库实例、读写分离配置和心跳语句
|
|
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 以后):
|
|