MyCat 基础 - 核心配置 - schema

一时失言乱红尘 2023-05-30 15:58 81阅读 0赞

## 前言 ##

本章主要整理 MyCat核心配置说明

## 核心配置文件说明 ##

<table> 
 <thead> 
  <tr> 
   <th>文件名</th> 
   <th>说明</th> 
   <th>功能</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>server.xml</td> 
   <td>虚拟MySQL</td> 
   <td>配置系统相关参数<br>配置用户访问权限<br>配置SQL防火墙及SQL拦截功能</td> 
  </tr> 
  <tr> 
   <td>schema.xml</td> 
   <td>数据库配置</td> 
   <td>配置逻辑库及逻辑表<br>配置逻辑表所存储的数据节点<br>配置数据节点所对应的物理数据库服务信息</td> 
  </tr> 
  <tr> 
   <td>rule.xml</td> 
   <td>切片规则</td> 
   <td>配置水平分片的分片规则<br>配置分片规则所对应的分片函数</td> 
  </tr> 
  <tr> 
   <td>log4j2.xml</td> 
   <td>日志文件</td> 
   <td>配置输出日志的格式<br>配置输出日志的级别</td> 
  </tr> 
 </tbody> 
</table>

## 核心文件 - schema.xml ##

查看完整配置，建议从下往上看，否则你会一脸懵

<?xml version="1.0"?>
    <!DOCTYPE mycat:schema SYSTEM "schema.dtd">
    <mycat:schema xmlns:mycat="http://io.mycat/">
    
    	<schema name="book_db" checkSQLschema="false" sqlMaxLimit="100">
    		<table name="custom_login" primaryKey="custom_id" 
    			dataNode ="loginDb01,loginDb02" rule="custom_login"/>
    	</schema>
    
    	<dataNode name="loginDb01" dataHost="mysql0103" database="login_db01" />
    	<dataNode name="loginDb02" dataHost="mysql0103" database="login_db02" />
    
    	<dataHost name="mysql0103" maxCon="1000" minCon="10" balance="1" writeType="0" dbType="mysql" dbDriver="native" switchType="1">
        
    		<heartbeat>select user()</heartbeat>
        
    		<writeHost host="192.168.1.3" url="192.168.1.3:3306" user="admin" password="123456">
    			<readHost host="192.168.1.4" url="192.168.1.4:3306" user="admin" password="123456" />
    		</writeHost>
        
    		<writeHost host="192.168.1.4" url="192.168.1.4:3306" user="admin" password="123456"/>
    	</dataHost>
    </mycat:schema>

标签说明

<table> 
 <thead> 
  <tr> 
   <th>标签</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>&lt;scheme&gt;</code></td> 
   <td>定义逻辑库</td> 
  </tr> 
  <tr> 
   <td><code>&lt;table&gt;</code></td> 
   <td>定义逻辑表</td> 
  </tr> 
  <tr> 
   <td><code>&lt;dataNode&gt;</code></td> 
   <td>定义逻辑表存储的物理数据库</td> 
  </tr> 
  <tr> 
   <td><code>&lt;dataHost&gt;</code></td> 
   <td>定义后端数据库主机信息</td> 
  </tr> 
  <tr> 
   <td><code>&lt;heartbeat&gt;</code></td> 
   <td>健康检测，表示如何检查后端数据库是否可用</td> 
  </tr> 
  <tr> 
   <td><code>&lt;writeHost&gt;</code></td> 
   <td>写主机， 根据<code>balance</code>定义是否参与select语句的负载均衡</td> 
  </tr> 
  <tr> 
   <td><code>&lt;readHost&gt;</code></td> 
   <td>读主机</td> 
  </tr> 
 </tbody> 
</table>

定义逻辑库 `<scheme>`

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>name</td> 
   <td>属性定义逻辑库的名字（与物理库不一样）</td> 
  </tr> 
  <tr> 
   <td>sqlMaxLimit</td> 
   <td>限制返回结果集的函数，-1表示关闭limit限制。<br>(标签中配置优先级 &gt; 系统配置)</td> 
  </tr> 
  <tr> 
   <td>checkSQLschema</td> 
   <td>属性判断是否检查发送MyCat的SQL是否包含库名</td> 
  </tr> 
 </tbody> 
</table>

定义逻辑表 `<table>`

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>name</td> 
   <td>属性定义逻辑表的名字（需要与物理表名字一致）</td> 
  </tr> 
  <tr> 
   <td>primaryKey</td> 
   <td>定义逻辑表的主键</td> 
  </tr> 
  <tr> 
   <td>dataNode</td> 
   <td>定义表数据所存储的数据节点</td> 
  </tr> 
  <tr> 
   <td>rule</td> 
   <td>定义逻辑表分片规则，对应 rule.xml 中的 <code>&lt;tableRule&gt;</code> （不需要分片可以不写）</td> 
  </tr> 
 </tbody> 
</table>

定义逻辑表存储的物理数据库 `<dataNode>`

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>name</td> 
   <td>属性定义数据节点的名称，必须唯一</td> 
  </tr> 
  <tr> 
   <td>dataHost</td> 
   <td>属性定义分片所在的物理主机</td> 
  </tr> 
  <tr> 
   <td>database</td> 
   <td>属性定义物理数据库名称</td> 
  </tr> 
 </tbody> 
</table>

定义后端数据库主机信息 `<dataHost>`

<dataHost ....>
      <heartbeat>select user()</heartbeat>
      <writeHost ...>
        <readHost />
      </writeHost>
    </dataHost>

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>name</td> 
   <td>按照自己的命名规则就好，但要确保唯一</td> 
  </tr> 
  <tr> 
   <td>maxCon</td> 
   <td>连接池最大连接数</td> 
  </tr> 
  <tr> 
   <td>minCon</td> 
   <td>连接池最小连接数</td> 
  </tr> 
  <tr> 
   <td>balance</td> 
   <td>负载均衡的工作方式，读写分离等</td> 
  </tr> 
  <tr> 
   <td>writeType</td> 
   <td>对目标数据库写操作的类型</td> 
  </tr> 
  <tr> 
   <td>dbType、dbDriver</td> 
   <td>数据库类型、数据库驱动</td> 
  </tr> 
  <tr> 
   <td>switchType</td> 
   <td>决定写数据库如何进行高可用的切换</td> 
  </tr> 
 </tbody> 
</table>

balance - 负载均衡的工作方式，读写分离等

`stand by writeHost 说明 (保留一个写节点，其他写节点是要参与读请求的)`

<table> 
 <thead> 
  <tr> 
   <th>值</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>0</td> 
   <td>不开启读写分离机制</td> 
  </tr> 
  <tr> 
   <td>1</td> 
   <td>全部的readHost 与 stand by writeHost 参与 select语句的负载均衡</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>全部的readHost 与 writeHost 都参与select语句的负载均衡</td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td>全部的readHost 参与 select 语句的负载均衡</td> 
  </tr> 
 </tbody> 
</table>

writeType - 对目标数据库写操作的类型

<table> 
 <thead> 
  <tr> 
   <th>值</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>0</td> 
   <td>所有写操作都是第一个写主机负责，如果第一个主机挂了就切换到其他（适合主从架构）</td> 
  </tr> 
  <tr> 
   <td>1</td> 
   <td>所有的写操作都随机发送到写主机上执行（适合 pxc 架构）</td> 
  </tr> 
 </tbody> 
</table>

switchType - 决定写数据库如何进行高可用的切换

<table> 
 <thead> 
  <tr> 
   <th>值</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-1</td> 
   <td>关闭自动切换功能</td> 
  </tr> 
  <tr> 
   <td>1</td> 
   <td>默认值，自动切换（一个writehost不可访问时，都会切换第二个指定写服务器）</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>基于 MySQL 主从同步的状态决定是否切换<br>心跳语句为 <code>show slave status</code></td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td>基于 MySQL galary cluster 的切换机制（适合集群）<br>心跳语句为 <code>show status like ‘wsrep%’</code></td> 
  </tr> 
 </tbody> 
</table>

表示如何检查后端数据库是否可用 `<heartbeat>`

<heartbeat>select user()</heartbeat>

定义写主机 `<writeHost>`

*  定义一组主从数据库，`<readHost>` 依赖于 `<writeHost>`
 *  user 和 password 为后端数据库中的用户
 *  writeHost 指 定写实例、readHost 指定读实例，组着这些读写实例来满足系统的要求。
 *  由于这个 writeHost 宕机系统会自动的检测 到，并切换到备用的 writeHost 上去。