设置数据库代理连接地址

下载

聚焦模式

字号

最后更新时间： 2026-06-22 10:02:53

本文为您介绍通过云数据库 MySQL 控制台设置数据库代理连接地址。
数据库代理连接地址独立于原有的数据库连接地址，通过数据库代理地址的请求全部通过代理集群中转访问数据库的主从节点，进行读写分离，将读请求转发至只读实例，降低主库的负载。
云数据库 MySQL 在开通数据库代理后默认提供一个数据库代理连接地址，您也可以额外新增数据库代理连接地址、修改数据库代理连接地址或删除数据库代理连接地址。
前提条件
已 开通数据库代理。
修改数据库代理连接地址
1. 登录 MySQL 控制台，在实例列表，选择已开启代理的主实例，单击实例 ID 或操作列的管理，进入实例管理页面。
2. 在实例管理页面，选择数据库代理页，在连接地址的对应内网访问地址后单击
﻿
图标。
﻿
3. 在弹出的对话框，修改代理地址后，单击确定。
注意：
修改内网地址会影响正在访问的数据库业务，建议在低峰期修改，请确保业务具备重连机制。
﻿
新增数据库代理连接地址
说明：
数据库代理连接地址上限为7个。
开通数据库代理时已默认创建一个连接地址。
1. 登录 MySQL 控制台，在实例列表，选择已开启代理的主实例，单击实例 ID 或操作列的管理，进入实例管理页面。
2. 在实例管理页面，选择数据库代理页，在连接地址后单击新增访问地址。
3. 在新建连接窗口，完成如下配置，单击确定。
步骤1：网络配置
参数
说明
私有网络
选择数据库代理的网络，仅支持私有网络 VPC。如果通过云服务器访问实例，请选择与云服务器相同的私有网络。
选择子网
选择子网，选择范围为所选私有网络下存在的子网。
安全组
默认选择的安全组与主实例保持一致，也可根据需要选择已有安全组或新建安全组，支持多选安全组。
注意：
访问数据库代理需要开通配置安全策略，放通内网访问端口（当前内网端口为：3306），具体详见 MySQL 安全组配置。
备注
非必填项，可为新增数据库代理连接地址进行备注。
步骤2：配置策略
新建连接的读写属性支持选择读写分离或者只读，所选的读写属性不同，配置选项也不同。请参考以下说明，根据实际情况进行配置。
读写分离
只读
参数
说明
读写属性
选择此代理访问地址的读写属性，这里选择读写分离。
接入模式
支持均衡分配和就近访问两种接入模式来设置客户端到数据库代理的连接链路，详情请参见 接入模式。
只读实例延迟剔除
设置只读实例延迟剔除策略，此项开启时，可设置延迟剔除阈值和只读实例最小保留数。无论此项是否启用，只读实例故障时均会尝试剔除和恢复。
延迟剔除阈值：输入大于或等于1的整数，单位为秒。
只读实例最小保留数：数量与主实例拥有只读实例数相关，设置为0时，当只读节点全部被剔除后，所有访问会转发到主实例上，直至只读实例重新加入。
自适应负载均衡
选择是否开启自适应负载均衡功能，开启后可以根据后端的负载情况，将请求路由到负载更低的实例上，以达到数据库实例负载均衡，详情请参见 自适应负载均衡功能。
连接池状态
连接池功能主要用于减少短连接业务频繁建立新连接带来的实例负载。此项开启，可选择支持的连接池类型，目前支持会话级别连接池、事务级别连接池（数据库代理版本1.4.1或以上）。
事务拆分
设置是否开启，开启后，能够将事务内第一个写请求之前的读请求转发到只读实例上去执行，以降低主实例的负载。
读权重分配
支持选择系统自动分配或自定义，如开通数据库代理时配置了多个可用区，则支持对通过不同可用区下的代理节点访问数据库的权重进行分别配置。
说明：
此处的权重是面向读请求（非事务）权重的分配策略。
统一权重管理
若当前主实例下存在只读分析引擎，则此项支持设置，设置为开启后，只读分析引擎可在“无 Hint”场景下接受代理转发的查询语句。
故障转移
设置是否开启，开启后，数据库代理出现故障时，连接地址将会路由到主实例。
分析引擎故障转发
设置是否开启，开启后，当访问的只读分析引擎出现故障时，会自动根据规则转发到其他只读分析引擎，详细故障转发策略请参见 实例故障转发。
自动添加只读实例
设置是否开启，开启后，若您购买新的只读实例，会自动添加到数据库代理中。
当读权重为系统自动分配时，新购只读实例按照规格大小默认权重分配。
当读权重为自定义时，新购只读实例默认加入时权重为0，可通过数据库代理页，连接地址下的调整配置来修改。
参数
说明
读写属性
选择此代理访问地址的读写属性，这里选择只读。
网络转发
设置是否启用网络转发，启用后表示使用纯网络的方式进行 SQL 分发。双节点、三节点或云盘版架构的实例支持网络转发模式，详情请参见 网络转发功能。
接入模式
支持均衡分配和就近访问两种接入模式来设置客户端到数据库代理的连接链路，详情请参见 接入模式。
只读实例延迟剔除
设置只读实例延迟剔除策略，此项开启时，可设置延迟剔除阈值和只读实例最小保留数。无论此项是否启用，只读实例故障时均会尝试剔除和恢复。
延迟剔除阈值：输入大于或等于1的整数，单位为秒。
只读实例最小保留数：数量与主实例拥有只读实例数相关，设置为0时，当只读节点全部被剔除后，所有访问会转发到主实例上，直至只读实例重新加入。
自适应负载均衡
选择是否开启自适应负载均衡功能，未启用网络转发时，此项才支持开启，开启后可以根据后端的负载情况，将请求路由到负载更低的实例上，以达到数据库实例负载均衡，详情请参见 自适应负载均衡功能。
连接池状态
连接池功能主要用于减少短连接业务频繁建立新连接带来的实例负载。未启用网络转发时，此项才支持开启。此项开启时，可选择支持的连接池类型，目前支持会话级别连接池、事务级别连接池（数据库代理版本1.4.1或以上）。
事务拆分
设置是否开启，未启用网络转发时，此项才支持开启，开启后，能够将事务内第一个写请求之前的读请求转发到只读实例上去执行，以降低主实例的负载。
读权重分配
支持选择系统自动分配或自定义，如开通数据库代理时配置了多个可用区，则支持对通过不同可用区下的代理节点访问数据库的权重进行分别配置。
说明：
此处的权重是面向读请求（非事务）权重的分配策略。
统一权重管理
若当前主实例下存在只读分析引擎，则此项支持设置，设置为开启后，只读分析引擎可在“无 Hint”场景下接受代理转发的查询语句。
分析引擎故障转发
设置是否开启，开启后，当访问的只读分析引擎出现故障时，会自动根据规则转发到其他只读分析引擎，详细故障转发策略请参见 实例故障转发。
自动添加只读实例
设置是否开启，未启用网络转发时，此项才支持开启，开启后，若您购买新的只读实例，会自动添加到数据库代理中。
当读权重为系统自动分配时，新购只读实例按照规格大小默认权重分配。
当读权重为自定义时，新购只读实例默认加入时权重为0，可通过数据库代理页，连接地址下的调整配置来修改。
删除数据库代理连接地址
说明：
当数据库代理下有多个代理连接地址时，支持删除不需要的连接地址，但最后一个地址不支持删除。
1. 登录 MySQL 控制台，在实例列表，选择已开启代理的主实例，单击实例 ID 或操作列的管理，进入实例管理页面。
2. 在实例管理页面，选择数据库代理页，在连接地址下找到目标地址，单击关闭。
﻿
3. 在弹出的对话框单击确定。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

参数	说明
私有网络	选择数据库代理的网络，仅支持私有网络 VPC。如果通过云服务器访问实例，请选择与云服务器相同的私有网络。
选择子网	选择子网，选择范围为所选私有网络下存在的子网。
安全组	默认选择的安全组与主实例保持一致，也可根据需要选择已有安全组或新建安全组，支持多选安全组。注意：访问数据库代理需要开通配置安全策略，放通内网访问端口（当前内网端口为：3306），具体详见 MySQL 安全组配置。
备注	非必填项，可为新增数据库代理连接地址进行备注。

参数	说明
读写属性	选择此代理访问地址的读写属性，这里选择读写分离。
接入模式	支持均衡分配和就近访问两种接入模式来设置客户端到数据库代理的连接链路，详情请参见接入模式。
只读实例延迟剔除	设置只读实例延迟剔除策略，此项开启时，可设置延迟剔除阈值和只读实例最小保留数。无论此项是否启用，只读实例故障时均会尝试剔除和恢复。延迟剔除阈值：输入大于或等于1的整数，单位为秒。只读实例最小保留数：数量与主实例拥有只读实例数相关，设置为0时，当只读节点全部被剔除后，所有访问会转发到主实例上，直至只读实例重新加入。
自适应负载均衡	选择是否开启自适应负载均衡功能，开启后可以根据后端的负载情况，将请求路由到负载更低的实例上，以达到数据库实例负载均衡，详情请参见自适应负载均衡功能。
连接池状态	连接池功能主要用于减少短连接业务频繁建立新连接带来的实例负载。此项开启，可选择支持的连接池类型，目前支持会话级别连接池、事务级别连接池（数据库代理版本1.4.1或以上）。
事务拆分	设置是否开启，开启后，能够将事务内第一个写请求之前的读请求转发到只读实例上去执行，以降低主实例的负载。
读权重分配	支持选择系统自动分配或自定义，如开通数据库代理时配置了多个可用区，则支持对通过不同可用区下的代理节点访问数据库的权重进行分别配置。说明：此处的权重是面向读请求（非事务）权重的分配策略。
统一权重管理	若当前主实例下存在只读分析引擎，则此项支持设置，设置为开启后，只读分析引擎可在“无 Hint”场景下接受代理转发的查询语句。
故障转移	设置是否开启，开启后，数据库代理出现故障时，连接地址将会路由到主实例。
分析引擎故障转发	设置是否开启，开启后，当访问的只读分析引擎出现故障时，会自动根据规则转发到其他只读分析引擎，详细故障转发策略请参见实例故障转发。
自动添加只读实例	设置是否开启，开启后，若您购买新的只读实例，会自动添加到数据库代理中。当读权重为系统自动分配时，新购只读实例按照规格大小默认权重分配。当读权重为自定义时，新购只读实例默认加入时权重为0，可通过数据库代理页，连接地址下的调整配置来修改。

tencent cloud

云数据库 MySQL

设置数据库代理连接地址

前提条件

修改数据库代理连接地址

新增数据库代理连接地址

删除数据库代理连接地址

帮助和支持