使用GaussDB(for MySQL)数据库代理实现读写分离

1. 登录管理控制台。
2. 单击管理控制台左上角的，选择区域和项目。
3. 在页面左上角单击，选择“数据库 > 云数据库 GaussDB(for MySQL)”。
4. 在实例管理页面，选择目标GaussDB(for MySQL)实例，单击实例名称，进入实例概览页面。
5. 在左侧导航栏中，单击“数据库代理”，进入数据库代理页面。
6. 单击“新增代理”。
7. 在“新增数据库代理服务”弹框中，设置相关参数。

   表1 数据库代理参数

   参数名称	说明
   代理实例名称	长度在4个到64个字符之间，必须以字母开头，区分大小写，可以包含字母、数字、中划线或下划线，不能包含其他特殊字符。
   代理模式	GaussDB(for MySQL)数据库代理支持读写和只读两种代理模式，可根据业务需要选择合适的代理模式。 读写模式：所有写请求只发往主节点，所有读请求按照读权重配比或者活跃连接数情况分发到已选节点。节点的读权重值默认为100。 只读模式：不接收写请求。所有读请求按照读权重配比或者活跃连接数情况分发到已选只读节点，不会转发到主节点，即使主节点被选为服务节点。 说明： 只读模式仅支持读请求业务，写业务请求会有异常提示。 在只读模式下，不支持DDL、DML操作和临时表操作。
   一致性级别	GaussDB(for MySQL)实例的内核版本为2.0.28.1及以上时支持设置一致性级别。 数据库代理支持如下一致性级别： 最终一致性 开启数据库代理后，同一会话内，连续多次SELECT请求会根据权重配比，路由到不同的数据库节点，由于主节点与读节点之前存在复制时延，并且各个读节点的复制时延大小不一定完全相同，可能会导致每次SELECT请求得到的结果存在差异，因此默认情况下，数据库代理只能保证数据的最终一致。 如果需要减轻主节点压力，让尽量多的读请求路由到只读节点，您可以选择最终一致性。 会话一致性 由于最终一致性可能会导致多次SELECT请求的结果存在差异，数据库代理进一步提供了会话级别的数据一致性，保证了在同一会话内，每次SELECT请求都可以获取到上一次写入操作后，数据库的最新数据。 开启会话一致性需要数据库代理的内核版本为2.7.4.0及以上。
   路由模式	数据库代理支持如下路由模式： 权重负载：根据您设置的读权重比例分发读请求。 负载均衡：根据数据库节点的活跃连接数情况进行读请求分发，将读请求分发到活跃连接数较少的节点上。 负载均衡模式需要保证数据库代理的内核版本为2.22.07.000及以上。 更多关于路由模式的内容请参见修改GaussDB(for MySQL)代理的路由模式。
   代理实例规格	根据实际需要选择代理实例规格。 鲲鹏通用计算增强型：2 vCPUs | 4 GB、4 vCPUs | 8GB、8 vCPUs | 16 GB 通用增强型：2 vCPUs | 4 GB、4 vCPUs | 8 GB、8 vCPUs | 16 GB
   子网	该功能为白名单功能，如需使用，请在管理控制台右上角，选择“工单 > 新建工单”，提交申请。 开通数据库代理时可指定代理实例子网。如果GaussDB(for MySQL)实例所在子网为扩展网段，则不支持跨子网开启数据库代理，需要与GaussDB(for MySQL)实例在同一子网。
   代理实例节点数量	默认为2个节点。最小支持2个节点，最大支持16个节点。 推荐代理实例节点数量 =（主节点CPU核数+所有只读节点CPU核数总和）/（4*代理实例CPU核数），计算结果向上取整。
   新节点自动加入	开启新节点自动加入开关后，新增的只读节点会自动添加到该数据库代理实例中。
   新节点权重	当路由模式为权重负载时，需要设置新节点的读权重。节点的读权重默认为100，读权重越高，处理的读请求越多。
   选择数据库节点	勾选需要加入到数据库代理中处理读请求的节点。 路由模式为负载均衡时，不需要配置读权重。数据库代理会根据节点的活跃连接数情况进行读请求分发，将读请求分发到活跃连接数较少的节点上。 路由模式为权重负载时，需要设置主节点和只读节点的读权重。数据库代理会根据您设置的读权重比例分发读请求。 例如：代理实例已选择1个主节点和2个只读节点，读权重配置为100、200、200。 在读写模式下，主节点和2个只读节点将按照1：2：2的比例处理读请求。即主节点处理20%的读请求，2个只读节点分别处理40%的读请求，写请求自动发往主节点。 在只读模式下，主节点权重在进行读请求处理分配时不生效，由2个只读节点分别处理50%的读请求。

8. 单击“确定”。
9. 查看代理实例及关联的数据库节点。

   数据库代理开通后，在数据库代理页面可查看到已创建成功的代理实例。

   图1 查看创建成功的代理实例
   

   单击左侧导航栏中“实例概览”，进入GaussDB(for MySQL)实例概览页面。单击页面右上方，选择“查看实例拓扑图”，在实例拓扑图中可查看对应代理实例关联的数据库节点。将鼠标悬浮在节点信息处，可查看该节点的详细信息。

   图2 查看代理实例关联节点信息
   

在使用数据库代理连接GaussDB(for MySQL)实例前，需要确保当前数据库账号具有访问数据库代理地址的权限，否则将无法通过数据库代理连接到GaussDB(for MySQL)实例。

您可以通过以下步骤来检查权限并授权该账号访问数据库代理地址的权限。

1. 连接GaussDB(for MySQL)实例。

   具体操作请参见连接实例。

2. 实例连接成功后，执行下列SQL语句，查看当前数据库账号的host是否包含数据库代理地址。

   SELECT user,host FROM mysql.user;

   

   代理地址获取方式：

   单击目标GaussDB(for MySQL)实例，进入基本信息页面。在左侧导航栏单击“数据库代理”，在代理实例列表中查看数据库代理地址。

   图3 查看代理地址
   

3. 如果查询的host不包含数据库代理所在网段，则需要赋予远程访问权限。

   例如：使用root用户想要从192.168.0网段连接到GaussDB(for MySQL)实例，您可以在DAS用户管理界面将当前账号的主机设置为192.168.%。具体操作请参见编辑用户信息。

   图4 设置主机IP
   

确保入方向规则和出方向规则允许数据库代理地址访问，默认端口号为3306。

1. 登录管理控制台。
2. 单击管理控制台左上角的，选择区域和项目。
3. 在页面左上角单击，选择“数据库 > 云数据库 GaussDB(for MySQL)”。
4. 在“实例管理”页面，选择目标实例，单击实例名称，进入实例概览页面。
5. 在“网络信息”模块的“内网安全组”处，单击安全组名称，进入安全组页面。
6. 在入方向规则页签下，默认允许3306端口访问。
   图5 放通3306端口
   

   如果没有该条规则，单击“快速添加规则”，弹框页面中勾选“MySQL（3306）”，单击“确定”。

   图6 快速添加3306端口
   

1. 在GaussDB(for MySQL)控制台查看代理地址和端口。

   单击目标GaussDB(for MySQL)实例，进入实例概览页面。在左侧导航栏单击“数据库代理”，在代理实例列表中查看代理地址和端口号。

   图7 查看代理地址和端口
   

2. 登录弹性云服务器。

   详细内容请参考《弹性云服务器用户指南》。

3. 执行如下命令，通过代理地址连接GaussDB(for MySQL)实例。

   mysql -h <hostIP> -P <port> -u <userName> -p <password>

   表2 参数说明

   参数	说明
   <hostIP>	1中获取到的代理地址。
   <port>	1中获取到的数据库端口。
   <userName>	用户名，即GaussDB(for MySQL)数据库管理员账号，默认为root。
   <password>	GaussDB(for MySQL)数据库管理员账号对应的密码。

您可以在每次执行完对应的读操作后，通过show last route命令来查看本次读操作的路由结果。

以下步骤以一条读操作为例，介绍查看读请求的路由结果。

1. 连接到GaussDB(for MySQL)实例后，执行读操作。

   例如：select 1;

   

2. 执行如下命令，查看1中读操作的路由结果。

   show last route

   图8 结果查询
   
   

   请勿将show last route用于业务代码或包在Multi-Statements中执行。