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