tencent cloud

TDSQL-C MySQL 版

文档TDSQL-C MySQL 版操作指南数据库代理管理数据库代理设置单个或多个连接地址

设置单个或多个连接地址

下载
聚焦模式
字号
最后更新时间： 2026-06-09 17:01:04
本文为您介绍如何通过 TDSQL-C MySQL 版控制台设置单个或多个数据库代理连接地址。
数据库代理访问地址独立于原有的数据库访问地址，通过数据库代理地址的请求全部通过代理集群中转访问数据库的读写实例、只读实例，进行读写分离，将读请求转发至只读实例，降低读写实例的负载。

前提条件

设置单个数据库代理连接地址

TDSQL-C MySQL 版在开通数据库代理后默认提供一个数据库代理连接地址，即开通数据库代理后已具备单个数据库代理连接地址，您可对其进行策略配置并挂载只读实例。
1. 登录 TDSQL-C MySQL 版控制台，在集群列表，选择已开启代理的集群，单击集群 ID，进入集群管理页面。
2. 在集群管理 > 集群详情下的拓扑图中，鼠标移动到数据库代理板块，然后单击详情进入数据库代理管理页面。或在集群管理页面直接选择数据库代理页进入数据库代理管理页面。
3. 在连接地址下找到目标访问地址，单击其操作列的调整配置。

4. 在跳转的窗口下，完成具体策略的配置，单击确定。
步骤1：配置策略

参数
说明
读写属性
选择此代理访问地址的读写属性，支持选择读写分离或只读，若选择读写分离，则自动开启读写分离功能。
接入模式
支持均衡分配和就近访问两种接入模式来设置客户端到数据库代理的连接链路，详情请参考 接入模式。
一致性设置
在读写分离属性下提供了最终一致性、会话一致性和全局一致性三种一致性级别，满足您在不同场景下对一致性的要求，详情请参考 一致性级别。
说明：
一致性级别的变更仅针对新连接生效。若您需要立即重置连接让参数生效，可以使用重新负载均衡功能或者重启实例。
超时时间
若一致性设置为会话一致性或全局一致性，您需对读写实例和只读实例之间的数据复制设置超时时间，取值范围：0 - 1000000毫秒，设置为0，则表示若只读实例出现延迟，导致一致性策略不满足，请求将一直等待，设置为非0，如设置1000毫秒，则表示若只读实例出现延迟，超过设置的1000毫秒后，请求将由系统自动转发到主实例。
温馨提示，当前同一云账号下多个数据库代理实例不支持单独设置各自的超时时间，多个数据库代理实例的超时时间只能统一生效一份，单个数据库代理实例修改超时时间，会导致多个数据库代理实例的超时时间都统一修改。
自适应负载均衡
选择是否开启自适应负载均衡功能，开启后可以根据后端的负载情况，将请求路由到负载更低的实例上，以达到数据库实例负载均衡，详情请参见 自适应负载均衡。
连接池状态
连接池功能主要用于减少短连接业务频繁建立新连接带来的实例负载。此项开启，可选择支持的连接池类型，目前支持会话级连接池、事务级连接池。详情请参见 连接池概述。
连接池阈值
当连接池类型选择为“会话级连接池”时，设置连接池阈值，取值范围：0 - 300秒。
事务拆分
设置是否开启，开启后，在一个事务中拆分读和写到不同的实例上去执行，读请求转发到只读实例，降低主实例负载。
故障转移（读写属性为读写分离）
设置是否开启，开启后，数据库代理出现故障时，连接地址将会路由到读写实例。
分析引擎故障转发（读写属性为读写分离）
设置是否开启（数据库代理版本为1.4.5或以上版本才支持设置此项），开启后，当访问的只读分析引擎出现故障时，会自动根据规则转发到其他只读分析引擎，详细故障转发策略请参见 实例故障转发。
自动添加只读实例
设置是否开启，开启后，若您购买新的只读实例或者只读分析引擎，会自动添加到数据库代理中。
当读权重为系统自动分配时，新购只读实例按照规格大小默认权重分配。
当读权重为自定义时，新购只读实例默认加入时权重为0，可通过数据库代理页，连接地址下的调整配置来修改。
步骤2：配置权重

参数
说明
读权重分配
数据库代理需要将读请求分发给不同的实例。通过为各个实例分配不同的读权重，数据库代理可以根据实例的权重值来决定将请求路由到哪个实例。这里支持选择系统自动分配或自定义。
若选择自定义分配，则支持对不同实例访问数据库的权重进行分别配置，以下是读权重分配时，启用和权重相关的说明：
启用：开启启用按钮，表示所选实例会被分配连接，关闭启用按钮，表示所选实例不会被分配连接。
权重：权重值的范围为0 - 100，设置为0表示所选实例会被分配连接且权重最小。数值越大，权重越大，可以接收到更多的读请求。设置完读权重分配，读请求会按比例路由到对应实例。例如分别为实例1、实例2、实例3分配读权重值为3、2、1，表示来源于数据库代理连接地址的读请求，会按照3:2:1的比例分别路由到实例1、实例2、实例3。
说明：
此处的权重是面向读请求（非事务）权重的分配策略。
只读分析引擎不支持权重修改，仅支持使用/*to server 实例 ID*/ 的 hint 语法进行强制指定转发执行。
只读分析引擎的权重说明
数据库代理中包含了只读分析引擎时，默认未指定 Hint 转发的 SQL 不会发送至只读分析引擎中。当存在多个只读分析引擎时，只读分析引擎的权重设置才会生效。
注意：
只有在1.4.5或以上版本的数据库代理中才支持只读分析引擎的权重设置。
统一权重管理
选择是否开启统一权重管理，开启统一权重管理后，未添加转发规则（Hint）的 SQL 会根据权重自动分配 SQL 到只读分析引擎中。此时只读分析引擎与普通的只读实例在一个负载均衡组中进行 SQL 转发。
注意：
只有在1.4.5或以上版本的数据库代理中此项才会显示。

设置多个数据库代理连接地址

说明：
数据库代理连接地址的上限为7个。
开通数据库代理时已默认创建一个连接地址。
1. 登录 TDSQL-C MySQL 版控制台，在集群列表，选择已开启代理的集群，单击集群 ID，进入集群管理页面。
2. 在集群管理 > 集群详情下的拓扑图中，鼠标移动到数据库代理板块，然后单击详情进入数据库代理管理页面。或在集群管理页面直接选择数据库代理页进入数据库代理管理页面。
3. 在数据库代理管理页面，在连接地址后单击新增访问地址。

4. 在新建连接窗口，完成如下配置，单击确定。
步骤1：网络配置

参数
说明
网络类型
选择数据库代理的网络，仅支持私有网络 VPC，支持选择自动分配 IP 或指定 IP。
安全组
默认选择的安全组与主实例保持一致，也可根据需要选择已有安全组或新建安全组，支持多选安全组。
注意：
访问数据库代理需要开通配置安全策略，放通内网访问端口（当前内网端口为：3306），具体详见 安全组配置。
备注
非必填项，可为新增数据库代理连接地址进行备注。
步骤2：配置策略
具体选项和说明请参见 设置单个数据库代理连接地址中的步骤1：配置策略。
步骤3：配置权重
具体选项和说明请参见 设置单个数据库代理连接地址中的步骤2：权重配置。

相关 API

API
描述
本接口（CreateProxyEndPoint）用于创建数据库代理连接点。
上一篇: 修改或删除连接地址下一篇: 查看和修改访问策略

帮助和支持

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

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

文档反馈