文档中心

云数据库 MySQL 版

数据库代理

关闭数据库代理

关闭数据库代理

本文介绍关闭数据库代理功能的操作步骤。

注意事项

关闭数据库代理功能后，连接终端的读写分离策略会失效，取消默认连接终端与只读节点的关联。

使用限制

如果您的实例已超过半年或以上未进行整体升级，可能无法关闭数据库代理。如需关闭数据库代理功能，请提交工单联系技术支持。

多节点实例的数据库代理功能不支持关闭。

前提条件

在关闭数据库代理功能时，云数据库 MySQL 版会对实例进行预检查。如通过检查，可参考本文操作步骤关闭数据库代理功能。如未能通过检查项，可参考以下内容解决。

检查项	检查结果	解决方案
实例版本	当前实例版本不支持开关代理	可通过以下两点进行排查解决。如果实例符合以下两点但仍不能开启或关闭数据库代理功能，请提交工单联系技术支持协助解决。确认实例类型为双节点实例。非双节点类型实例不支持开关数据库代理。确认实例的白名单版本为 v2。通过调用 DescribeDBInstanceDetail 接口、查看 AllowListVersion 字段的返回值，可确认实例的白名单版本。如果白名单版本为 v1，可调用 UpgradeAllowListVersion 接口升级白名单版本到 v2。
实例状态	当前实例状态非运行中不支持开关代理	确认实例状态为运行中。如实例处于非运行中状态，可检查实例当前是否有执行中的操作，待操作完成、实例回到运行中状态后，重新执行开启或关闭数据库代理。
实例状态		存在运行中的网络事件不支持开关代理	确认实例是否存在运行中的网络事件。网络事件包含创建和删除公网地址，创建、编辑和删除终端，修改连接地址的前缀或端口，修改私网地址的解析方式。待运行中的网络事件执行完毕，重新执行开启或关闭数据库代理操作。
白名单限制	白名单绑定 IP 数量超过限制，不支持开关代理	确认实例当前绑定的 IP 地址或 IP 地址段数量是否超过 290 个。如果当前绑定的 IP 地址或 IP 地址段数量超过 290，则需要对绑定的 IP 地址或 IP 地址数量进行调整。调整方法，可参考修改白名单和从实例解绑白名单。
实例配置	当前实例已开启事务级连接池，不支持开关代理	切换实例的连接池模式为直连模式。更多详细信息，请参见切换连接池模式。
		当前实例连接终端状态不支持开关代理	检查并调整实例的自定义连接终端，确保实例的每个自定义只读终端仅关联了一个只读节点，且关联的只读节点仅关联了该自定义只读终端与默认终端。关于调整连接终端关联节点的详细信息，请参见编辑连接终端；如需删除连接终端，请参见删除连接终端。
		当前实例已开启读写分离，不支持开关代理	检查并调整实例的连接终端，确保实例各连接终端的读写分离功能均已关闭。请参考开启或关闭读写分离。
		当前实例自定义终端已开启自动加入新节点，不支持开关代理	检查并调整实例的连接终端，确保实例各连接终端（除默认连接终端外）的自动加入新节点功能均已关闭。关于关闭自动加入新节点功能的详细信息，请参见编辑连接终端。
		当前账号存在自定义访问账号，不支持开关代理	检查实例的账号是否存在自定义访问账号（即按照主机 IP 授权的账号）。如存在自定义访问账号，需参考修改账号权限移除为账号设置的主机 IP，或删除账号。
其他	触发后台系统限制，无法进行开关代理操作	请提交工单联系技术支持协助解决。

操作步骤

登录云数据库 MySQL 版控制台。

在顶部菜单栏选择实例所属的项目和地域。

说明

如未设置实例的所属项目，本操作应选择项目为账号全部资源。

在左侧导航栏单击实例列表。

在实例列表页面，单击目标实例名称，进入实例信息页签。

单击连接管理页签，在数据库代理区域，单击数据库代理右侧的图标。

在弹出的关闭数据库代理窗口中，单击确定，关闭数据库代理。

在关闭数据库代理时，云数据库 MySQL 版会对实例状态进行评估，如评估通过，可单击确定关闭数据库代理功能。如评估不通过，会在关闭数据库代理窗口中列出未通过的检查项和检查结果，您可根据本文前提条件列出的解决方案进行相应的调整或设置，之后在窗口中单击重试，再次进行评估。如评估通过，即可单击确定关闭数据库代理功能；如评估不通过，则需要根据列出的未通过的检查项和检查结果，再次进行调整。

相关 API

API	说明
ModifyDBProxy	调用 ModifyDBProxy 接口开启或关闭数据库代理功能。

最近更新时间：2026.10.16 15:31:05

这个页面对您有帮助吗？

有用

有用

无用

无用