Network Forwarding Feature

Download
Focus Mode
Font Size
Last updated: 2026-05-18 17:31:27
The database proxy for TencentDB for MySQL provides a network forwarding feature. This feature accurately forwards client database requests to target read-only instances/nodes and efficiently returns results through a pure network mode. This enables key capabilities such as a unified access point, reduced access latency, and simplified network architecture, significantly enhancing the availability, performance, and maintainability of the database proxy.
Prerequisites
The instance status is Running.
The instance architecture is two-node, three-node, or cluster edition.
The database proxy has been enabled for the instance.
The instance has read-only instances. To create a new read-only instance, see Create Read-only Instance.
Supported Versions
Two-node and three-node MySQL 5.7 instances (kernel minor version: 20211030 and later).
Two-node and three-node MySQL 8.0 instances (kernel minor version: 20211202 and later).
Cluster edition MySQL 5.7 and MySQL 8.0 instances.
Network Forwarding Feature for Two-Node and Three-Node Deployments
If network forwarding is enabled for a database proxy, the proxy does not support the following features: adaptive load balancing, connection pooling, and transaction splitting.
If the RO group of an instance is a legacy RO group (standard RO group), the RO group can be upgraded to a new RO group (Proxy pure network mode). After the upgrade, the RO group supports adding cross-AZ read-only instances. For the upgrade operation, see Upgrade RO Group.
If the instance has no read-only instances, you can only select the standard RO group type when creating a new read-only instance.
A read-only instance can only connect within a single new RO group (Proxy pure network mode).
Network Forwarding Feature for Cloud Disk Edition
If network forwarding is enabled for a database proxy, the proxy does not support the following features: adaptive load balancing, connection pooling, and transaction splitting.
Only standalone read-only instances under cloud disk edition instances support the Proxy pure network mode.
Operation Steps
Operations for Two-Node and Three-Node Deployments
Operations for Cloud Disk Edition
Upgrading an RO Group
Note:
If an RO group in the same region as the primary instance is not in Proxy pure network mode, you can upgrade it to Proxy pure network mode by performing the following operations.
The private network address of the upgraded RO group remains the same as before the upgrade.
1. Log in to the TencentDB for MySQL console, select a region at the top, and then click the target instance ID to go to the instance management page.
2. On the instance management page, select Read-Only Instance.
3. Locate the target RO group in the read-only instance list, and then click Upgrade after its RO Group ID.
﻿
4. In the pop-up window, verify the comparison between the pre-upgrade and post-upgrade states, and then click OK.
Note:
Upgrade is not supported when instance delay replication is enabled for an RO group. To disable instance delay replication, see Manage Read-Only Instance Delay Replication.
Upgrade is not supported when a public network address is enabled for an RO group. If you need to disable it, you can do so after the RO group's public network address.
5. After the upgrade is completed, a private network address for database proxies in pure network mode is automatically added under Connection Address on the Database Proxy page.
﻿
6. The original RO Group ID is updated to ProxyAddrID.
﻿
Creating a Read-Only Instance and Assigning It to Proxy-Only Network Mode
Note:
If an RO group under the primary instance already has the Proxy pure network mode type, you can create a read-only instance and assign it to the Proxy pure network mode by performing the following operations.
1. Log in to the TencentDB for MySQL console, select a region at the top, and then click the target instance ID to go to the instance management page.
2. On the instance management page, select Read-Only Instance.
3. Click Create to go to the read-only instance creation page.
Note:
You can also locate the target RO group on the Read-Only Instance page, click Add Read-only Node on its right side, and then go to the read-only instance creation page.
﻿
4. After Type Configuration > Type, click Proxy network mode, specify the Proxy pure network address, and then click Buy Now after completing other configurations.
Note:
You can select the same AZ as the primary instance or a different AZ.
For the complete procedure to create a read-only instance, see Create Read-only Instances.
﻿
5. The system automatically assigns the read weight for this read-only instance. After creation, configure the read weight allocation method in the RO group settings.
Configure read weight distribution
﻿
Method 1: You can configure it on the Access Policy page of the database proxy. For the operation procedure, see Viewing and Modifying Access Policies.
Method 2: You can configure it on the configuration page of the RO group with Proxy network mode. For the operation procedure, see Configuring Read-only Instance RO Groups.
Disabling Network Forwarding
﻿
Method 1: You can disable the network forwarding button on the Access Policy page of the database proxy. For the operation procedure, see Viewing and Modifying Access Policies.
Method 2: You can disable the network forwarding button on the configuration page of the RO group with Proxy network mode. For the operation procedure, see Configuring Read-only Instance RO Groups.
Enabling Network Forwarding
1. Log in to the TencentDB for MySQL console, select a region at the top, and then click the target instance ID to go to the instance management page.
2. On the instance management page, choose Database Proxy > Access Policy, locate the target access policy, and click Settings.
Note:
You can also find the target access address under Database Proxy > Overview > Connection Address, and click Adjusting Configurations in the Operation column.
3. On the Adjust Configurations page, enable network forwarding when the read/write attribute is read-only.
﻿
4. Under Assign Read Weight, set the allocation method, enable the required read-only instances, and click OK. For other settings on the configuration page, see Viewing and Modifying Access Policies.
Disabling Network Forwarding
1. Log in to the TencentDB for MySQL console, select a region at the top, and then click the target instance ID to go to the instance management page.
2. On the instance management page, choose Database Proxy > Access Policy, locate the target access policy, and click Settings.
Note:
You can also find the target access address under Database Proxy > Overview > Connection Address, and click Adjusting Configurations in the Operation column.
3. On the Adjust Configurations page, disable the network forwarding button and click OK.