tencent cloud


Creating Read-Only Instance

Last updated: 2022-05-27 15:10:06


    TencentDB for MySQL allows you to create one or more read-only instances, which are suitable for read/write separation and one-source-multiple-replica application scenarios and capable of greatly enhancing the read load capacity of your database.
    Unified read/write separation addresses (i.e., read and write requests are separated automatically) are not supported currently. Read-only instances need to be accessed with separate IPs and ports.


    • For read-only instance pricing, see Product Pricing.
    • You can enable the dedicated private network address for read-only instances and change the private IP and port on the instance details page.


    • RO group: It consists of one or more load balancing-enabled read-only instances. If there are multiple read-only instances in one RO group, read request volume can be evenly distributed among the instances. RO groups provide IPs and ports for access to databases.
    • Read-only instance: A single-node (with no replica) instance that supports read requests. It cannot exist independently; it must be in an RO group.


    The MySQL source-replica binlog sync feature is adopted for read-only instances, which can sync the changes in the source instance (source database) to all read-only instances. Given the single-node architecture (without a replica) of read-only instances, repeated attempts to restore a failing read-only instance will be made. Therefore, we recommend you choose an RO group over a read-only instance for higher availability.

    Feature Limits

    • Read-only instances can be purchased only for two-node or three-node source instances on MySQL 5.6 or later with the InnoDB engine at a specification of 1 GB memory and 50 GB disk capacity or above. If your source instance is below this specification, upgrade it first.
    • The minimum specification of a read-only instance is 1 GB memory and 50 GB disk capacity and must be greater than or equal to the storage capacity purchased for the source instance.
    • A source instance can create up to five read-only instances.
    • Backup and rollback features are not supported.
    • Data cannot be migrated to a read-only instance.
    • Database creation/deletion is not supported and neither is phpMyAdmin (PMA).
    • Operations including account creation/deletion/authorization and account name/password modification are not supported.


    • There is no need to maintain account and database for read-only instances, which will be synced with those of the source instance.
    • If the MySQL version is 5.6 but GTID is not enabled, you need to enable GTID in the console first before creating a read-only instance.
      The operation takes a long time, and the instance will be disconnected for several seconds. We recommend you do so during off-peak hours and add a reconnection mechanism in the programs that access the database.
    • Read-only instances only support the InnoDB engine.
    • Data inconsistency between multiple read-only instances may occur due to the delay in data sync between the read-only instances and the source instance. You can check the delay in the console.
    • The specification of a read-only instance can be different from that of the source instance, which makes it easier for you to upgrade the read-only instance according to the load. We recommend you keep the same specifications of read-only instances in the same RO group.


    1. Log in to the TencentDB for MySQL console. In the instance list, click an instance ID or Manage in the Operation column to access the instance details page.
    2. Click Add Read-Only Instance in the Instance Architecture Diagram section on the Instance Details tab or click Create on the Read-Only Instance tab.
    3. On the displayed purchase page, specify the following read-only instance configurations, confirm that everything is correct, and click Buy Now.

      If you need to unify the expiration time of the source and read-only instances, you can set the collective expiration date in the Renewal Management console as instructed in Renewal Management.

    • Specify RO Group: You can use the RO group automatically assigned by the system allocation, create one, or select an existing one.
      • Assigned by system: If multiple instances are purchased at a time, each of them will be assigned to an independent RO group, and their weights will be automatically assigned by the system by default.
      • Create RO group: Create an RO group. If multiple instances are purchased at a time, all of them will be assigned to this new RO group, and their weights will be allocated by the system automatically by default.
      • Existing RO group: Specify an existing RO group. If multiple read-only instances are purchased at a time, all of them will be assigned to the RO group.
        Their weights will be allocated as configured in the RO group. If assignment by the system is set for the RO group, the instances will be added to the group automatically according to the purchased specifications. If custom allocation is set, their weights will be zero by default.
        As the same private IP is shared within an RO group, if a VPC is used, the same security group settings will be shared. If an RO group is specified, it is not possible to customize any security group when instances are purchased.
    • Remove Delayed RO Instances: This option indicates whether to enable the removal policy. If a read-only instance is removed when its delay exceeds the threshold, it will become inactive, its weight will be set to 0 automatically, and warning notifications will be sent out (for more information on how to configure the read-only instance removal alarm and recipients, see Alarm Policies (Cloud Monitor)). The instance will be put back into the RO group when its delay falls below the threshold. No matter whether this option is enabled, a read-only instance that is removed due to instance failure will rejoin the RO group when it is repaired.
    1. After the purchase is completed, you will be redirected to the instance list. After the status of the read-only instance is displayed as Running, it can be used normally.


    What are the rules for removing read-only instances?

    After Remove Delayed RO Instances is enabled, the RO group will determine the removal rule based on the delay threshold and "Least RO Instances" value. If the delay of a read-only instance reaches the threshold, it will be removed and made inactive, with its weight set to 0 and an alarm sent to user. When its delay falls below the threshold, it will be returned to the RO group.

    • Delay Threshold: This sets a delay threshold for the read-only instance. When the threshold is exceeded, the instance will be removed from the RO group.
    • Least RO Instances: This is the minimum number of instances that should be retained in the RO group. When there are fewer instances in the RO group, even if an instance exceeds the delay threshold, it will not be removed.

    If read-only instances are terminated or returned, how will the source instance be affected?

    The termination and return of read-only instances has no impact on the source instance.

    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support