1.4 db.xml

db.xml包含具体的数据库组和实例配置,可以配置多组,每组可以配置多个实例

1.4.1 dbGroup配置

  • dbGroup
配置名称 配置内容&示例 可选项/默认值 详细描述
name 节点名称 必需项,无默认值 dbGroup的唯一标识,不允许重复
rwSplitMode 读操作的负载均衡模式 必需项,无默认值,候选值0/1/2/3 在进行读负载均衡的时候会根据这个配置进行
0:不做均衡,直接分发到主实例,从实例将被忽略,不会尝试建立连接池,但会有心跳连接
1:读操作在所有从实例中均衡,当所有从实例都不可用时,下发语句会报错。
2:读操作在所有实例中均衡。
3:读操作在所有从实例中均衡,当所有从实例都不可用时,将语句发往主实例。
具体拓扑结构见负载均衡相关章节
delayThreshold 指定主从延迟阀值,单位秒 默认-1,表示无延迟 1:在进行读取负载均衡的时候会根据最近一次的心跳状态以及读库和主库的延迟进行判断,如果主从复制不工作或者复制延迟超过delayThreshold配置,则认为此节点不适合进行读取,依赖于心跳为show slave status
2:此配置会影响到进行读负载均衡的时候延迟检测的开启,如果delayThreshold=-1那么读负载均衡选取的时候不会进行延迟检测
disableHA 是否禁用该组的高可用切换 可配置true/false,默认false 禁用该组的高可用切换,可能在某些场景下需要
heartbeat 子元素,心跳语句 必选项 该配置会在服务启动时设置的心跳任务里面被使用到,用于进行mysql实例状态的判断.
该配置有以下几种建议值:
1.普通心跳只是用于探活,建议使用select 1
2.使用 select @@read_only 探测结点可用性以及可写性
3.使用show slave status,可以探活,检查复制是否正常,以及延迟检测。如果Seconds_Behind_Master返回的状态有延迟,那么会被记入mysql实例的主从延迟中,影响读请求的路由分发,延迟超过指定限制读写分离会变为只读主库。
dbInstance 子元素,表示组下的实例,可配置多个 具体的物理节点配置
  • heartbeat
配置名称 配置内容&示例 可选项/默认值 详细描述
timeout heartbeat子元素,心跳超时阈值,单位:秒 默认0 心跳超时阈值。前置知识:dble会按照 heartbeatPeriodMillis 的间隔向 dbInstance 发送心跳
心跳发起时候检会查上次心跳是否为不正常的心跳,如果上次心跳尚未返回,并且距离最近的正常心跳的时间大于timeout,则标记该结点不可达。
例如:心跳周期(heartbeatPeriodMillis)2秒,第一次心跳正常,2s后的第二次心跳未返回,4s后第三次心跳发起时候发现上次不正常,不会真的再次下发,而是会根据4s和timeout的大小来确定该节点是否真正超时(该节点使用时候才会真正用到) 如果未超时,则什么也不做,继续下一个周期。如果超时了,则尝试杀掉超时的连接,无论是否杀成功,都会在下一个周期换一个连接继续做心跳,极端情况下会消耗很多连接
2. 心跳连续返回失败后,dble使用该结点时,会检查距离第一次失败的时间差,如果大于timeout,则报该结点不可达。
errorRetryCount heartbeat子元素,心跳失败后的尝试次数 默认1,0表示不重试 心跳失败/心跳连接被关闭后,开始重试errorRetryCount次。
1. 心跳失败重试期间,连接池状态为error状态,一旦重试成功,则标记回OK。(目的:防止网络抖动或者连接异常断开场景)
2. 心跳连接被关闭重试期间,连接池状态为ok状态,只有都重试失败后才会置为error状态
3. 重试期间超时,按照超时逻辑处理。
  • dbInstance
配置名称 配置内容&示例 可选项/默认值 详细描述
name 写节点名称 节点名称作为标识
id id 默认值为name对应的值 id标识
url 写节点地址ip:port 被分成IP和PORT用于连接数据库
user 写节点用户 用于连接数据库
password 写节点用户密码 用于连接数据库
usingDecrypt 是否启用加密password 候选值false/true,默认值false 如果设置为true,password属性值应该为用工具encrypt.sh加密串 1:{name}:{user}:{password} 得到的串
minCon 空闲时,保有的最小后端连接数 必需项 后端连接池中空闲时维持的最小连接数量,即常驻连接数。
实际工作中,minCon不得小于当前dbGroup实际用到的shardingNode的个数(别名 numOfShardingNodes),如果启动时发现minCon小于 numOfShardingNodes 会被调整为 numOfShardingNodes。
maxCon 最大后端连接数 必需项 后端连接池最大允许的连接数量。
实际工作中,maxCon不得小于当前dbGroup实际用到的shardingNode的个数(别名 numOfShardingNodes), 也不得小于 minCon ,如果启动时发现 maxCon 小于 这两个值 会被调整为 这两个值的最大值(即 numOfShardingNodes 和 minCon 当中的最大值)。
如果连接耗尽,将无法下发请求并返回报错。
readWeight 节点权重(负载均衡时候使用) 默认不配置表示所有节点等量负载 负载均衡过程中会查看所有节点的权重是否相等,如果不相等,那么就会根据权重来配置压力。
该值需是大于等于 0 的整数。如果配为0表示该节点不参与读.
需注意,总权重(所有节点权重之和)必须大于 0。
primary 主实例需要配置成true false 用来标识主节点
disabled 标记改实例不可用 false 高可用切换时候可能会用到
property 连接池属性 具体的后端连接池属性

举例如下:

<?xml version="1.0"?>
<dble:db xmlns:dble="http://dble.cloud/">

    <dbGroup name="dbGroup1" rwSplitMode="1" delayThreshold="100">
        <heartbeat errorRetryCount="1" timeout="10">show slave status</heartbeat>
        <dbInstance name="instanceM1" url="ip4:3306" user="your_user" password="your_psw" maxCon="200" minCon="50" primary="true">
            <property name="testOnCreate">false</property>
            <property name="testOnBorrow">false</property>
            <property name="testOnReturn">false</property>
            <property name="testWhileIdle">true</property>
            <property name="connectionTimeout">30000</property>
            <property name="connectionHeartbeatTimeout">20</property>
            <property name="timeBetweenEvictionRunsMillis">30000</property>
            <property name="idleTimeout">600000</property>
            <property name="heartbeatPeriodMillis">10000</property>
            <property name="evictorShutdownTimeoutMillis">10000</property>
        </dbInstance>

        <!-- can have multi read instances -->
        <dbInstance name="instanceS1" url="ip5:3306" user="your_user" password="your_psw" maxCon="200" minCon="50" primary="false">
            <property name="heartbeatPeriodMillis">60000</property>
        </dbInstance>
    </dbGroup>
</dble:db>

1.4.2 MySQL 用户权限声明

为了让 dble 能正常工作,需根据需要,给后端 MySQL 用户开启以下权限。

权限项目 作用
SELECT 数据查询权限
INSERT 新增数据权限
UPDATE 更新数据权限
DELETE 删除数据权限
FILE load data等数据导出导入的权限
CREATE 建库(管理端),建表,建索引权限
DROP 删除表的权限
ALTER 变更表结构的权限
LOCK TABLES lock tables的权限
ALTER ROUTINE (hint)变更/删除存储过程的权限
CREATE ROUTINE (hint)创建存储过程的权限
EXECUTE (hint)执行存储过程的权限
INDEX 建立/删除索引权限
SUPER 用于KILL功能
SHOW DATABASES 部分GUI工具会使用INFORMATION_SCHEMA SCHEMATA表
PROCESS 用于管理端show processlist 功能
REPLICATION CLIENT 可能场景:
1.用于配置了主从关系的数据结点,使用了读写分离
2.使用show slave status作为心跳
3.需要使用show @@binlog_status功能
REFERENCES 外键约束(纯语法支持,无使用意义)

results matching ""

    No results matching ""