All Products
Search
Document Center

ApsaraDB RDS:Disable a database proxy

Last Updated:Mar 30, 2026

Disable the database proxy feature when your RDS instance has few read requests or you no longer need the proxy. After disabling, the proxy endpoint is released and all existing connections through it are interrupted.

Prerequisites

Before you begin, make sure that you have:

Potential impacts

Disabling the database proxy feature has the following effects:

  • Proxy endpoint released: The proxy endpoint is released. Any internal or public endpoint associated with the proxy endpoint becomes unavailable, and all active connections through those endpoints are immediately interrupted. The original RDS instance endpoints are not affected. If you re-enable the database proxy feature, new proxy endpoints are assigned.

  • Read/write splitting disabled: All read and write requests are routed to the primary RDS instance. The proxy can no longer forward read requests to read-only instances, which may increase the load on the primary instance.

  • Connections: If you use the database proxy endpoint to connect your application to an RDS instance, the application and the RDS instance are disconnected after you disable the database proxy feature.

  • Connection management: Connection pool management and persistent connections provided by the proxy are no longer available. You must manage database connections directly in your application, which may increase the overheads to establish and destroy connections.

  • Security: The database proxy feature helps ensure data security through access control and security policy configuration. If you disable the feature, your RDS instance is exposed and can be exploited by attackers.

  • O&M: After you disable the feature, you may need to use other methods for monitoring, log collection, and fault detection. This increases the O&M complexity and workload.

  • Performance: Query caching and connection reuse become unavailable, which negatively affects performance in high-concurrency scenarios. However, a direct database connection shortens the network link and improves communication efficiency within specific areas.

  • Compatibility: If your application relies on special capabilities or protocol translations provided by the database proxy feature, direct database connections may cause compatibility issues.

  • Failover and high availability: In specific scenarios, the database proxy feature can be used for fault detection and automatic failover. If you disable the feature, you must manually perform these operations, which affects service availability.

  • Re-enabling changes endpoints: If you re-enable the database proxy feature later, new proxy endpoints are assigned. Update your application connection strings accordingly.

Disable the proxy

  1. Go to the Instances page. In the top navigation bar, select the region where the RDS instance resides, then find the RDS instance and click the instance ID.

  2. In the left-side navigation pane, click Database Proxy.

  3. In the upper-right corner, click Disable Database Proxy.

  4. In the dialog box that appears, click OK.

What's next

API reference

Operation Description
ModifyDBProxy Disables the database proxy feature. Set ConfigDBProxyService to Shutdown and configure other parameters based on your business requirements.
DescribeDBProxy Queries the details of a database proxy.