# 读写分离部署文档
### 一、概述
读写分离指的是将某些“只读”的业务功能请求路由到单独配置的读库中，通过读写分离机制，提高系统的整体性能及稳定性。
### 二、前置条件
将需要读写分离的分库搭建好主从环境。
### 三、MC配置
登录MC按照以下步骤进入配置：
> 以下教程的数据库连接信息仅为演示使用，实际配置时请根据实际情况进行调整
#### 3.1 数据库连接配置
功能路径：`组件维护 -> 数据库连接 -> 新增`
需要先将数据库的连接信息添加到数据库连接列表，在后续配置从库时需要用到。
> 读库的host及port必须有一项与主库不同，否则使用时会产生不允许两个写库的错误
填入实际的从库信息后，点击测试连接，无误后保存即可。
#### 3.2 读库配置
功能路径：`苍穹集群列表 -> 租户列表 -> 租户 -> 数据中心`
> 数据中心的更改必须先将该启用按钮置灰，保存后方能进行更改
双击数据中心打开配置卡片，进入后激活`读写分离`按钮
增加读库
> 只读负载因子：该参数请暂时不要修改，未来预留使用
填入实例名，并在所属数据库中选择从库
配置完毕后点击数据中心卡片的左上角保存按钮保存，回到数据中心列表后重新将该数据中心启用后保存。
读库的配置部分到此结束，如需配置多个分库的读库，重复上述步骤即可。
##### 3.3 读写分离功能点配置
功能路径：`基础数据维护 -> 环境公共配置项`
在`prop`的下属节点`db.properties`（没有则增加）中增加配置项：`db.splittingread.whitelist=key1[,key2][,key3][,...]`
例如：`db.splittingread.whitelist=qing`，如果需要配置多个功能点启用读写分离，则使用英文逗号分隔。
为了兼顾不同客户的需求，读写分离的功能点可以按功能点进行配置。目前支持的功能点列表：
| key | 功能描述 |
| -------- | ---------------------------------------------------------- |
| report | 用平台报表框架开发的报表（**不推荐启用**）例如：科目余额表 |
| billlist | F7、单据列表查询 （**不推荐启用**） |
| qing | 轻分析 |
| ksql_query_function | 查询分析器 |
#### 3.4 配置发布
配置完毕后发布配置即可。
### 四、验证
在4.0.14版本的苍穹已经将连接信息与SQL输出优化合并，所以在这两种版本之间验证的方式有所不同。
#### 4.2苍穹4.0.14版本验证方法
1. 在MC配置`db.sql.out=true`
2. 登录**配置读写分离的数据中心**
3. 进入功能路径：`系统服务云 -> 基础资料 -> 公共数据 -> 合作金融机构` 
4. 进入日志系统，搜索readonly关键字，
5. 搜索出类似日志`----sql@sys->sys#con1(readonly)----`代表读写分离配置成功
#### 4.2苍穹4.0.13及之前版本验证方法
上述配置完毕完毕后需要对读写分离的功能进行验证，通过monitor查询日志可判断当前的微服务是否从从库进行数据读取。
> 验证所涉及到的**配置改动需要在验证完毕后还原**
1. 进入功能路径：`基础数据维护 -> 环境公共配置项`
2. 在`db.properties`增加配置`db.splittingread.logconnection=true`
3. 配置完毕后发布
4. 回到苍穹登录页面，登录**配置读写分离的数据中心**
5. 进入功能路径：`系统服务云 -> 基础资料 -> 公共数据 -> 合作金融机构`
6. 进入页面等待2分钟
7. 进入日志界面，在`AccountId`栏目填入上述配置的数据中心`id`，在关键字栏填入关键字：`slave for read`
8. 搜索出日志则代表该数据中心已经成功配置读写分离
