All Products
Search
Document Center

PolarDB:Change specifications

Last Updated:Mar 28, 2026

Change the node specifications of a PolarDB cluster to scale computing capacity up or down based on your workload.

Prerequisites

Before you begin, ensure that:

  • No specification change task is already in progress on the cluster

Scaling dimensions

PolarDB supports three independent scaling dimensions:

  • Computing capacity (vertical): Upgrade or downgrade node specifications. This topic covers this type of scaling.

  • Computing capacity (horizontal): Add or remove read-only nodes. See Add or remove nodes.

  • Storage capacity: Storage scales automatically based on the storage type and billing method. See Manually scale up storage capacity.

Billing

For charges that apply when you change specifications, see Configuration change fees.

Usage notes

  • Centralized clusters (Enterprise Edition or Standard Edition): You can change the specifications of the entire cluster or an individual node.

    Note

    At least one read-only node must have the same specifications as the primary node. You can configure other nodes to different specifications based on your requirements.

  • Distributed clusters: You can only change specifications uniformly across all compute nodes or all data nodes. Changing specifications for a single compute node, data node, primary node, or read-only node on a compute node or data node is not supported.

  • Time to complete: Allow approximately 5 minutes per compute node. For example, a cluster with two compute nodes takes approximately 10 minutes. Database load and the number of tables also affect completion time.

  • Data safety: Data stored in the cluster is not affected during a specification change.

  • Temporary disconnection: Applications disconnect from the cluster for up to 30 seconds during the change. Schedule the change during off-peak hours and make sure your application reconnects automatically.

Change cluster specifications

  1. Log on to the PolarDB console.

  2. In the upper-left corner, select the region where the cluster is deployed.

  3. Go to the Change Configurations page using either of the following methods:

    • In the cluster list, find the cluster and click Change Configurations in the Actions column. image

    • Click the cluster ID, then on the Basic Information page, go to the Database Nodes section and click Change Configurations. Basic information

  4. Select Upgrade or Downgrade, then click OKChange configurations

    Note

    Only subscription clusters support Temporary Upgrade. See Temporary upgrade.

  5. On the Change Configurations page, set the following parameters:

    ParameterDescription
    Specification TypeSelect the new specification type. Dedicated Specifications is selected by default.
    Node SpecificationsSelect the new node specifications. At least one read-only node must match the primary node specifications. You can configure other read-only nodes based on your requirements.
    Switching TimeSelect Switch Now or Switch At. If you select Switch At, choose a point in time within the next 24 hours. The specifications take effect within 30 minutes after the specified time. To view or cancel the scheduled task, go to the Scheduled Tasks page. For more information, see Scheduled tasks.
  6. Read and select Terms of Service, then click Buy Now.

  7. On the Purchase page, confirm the order and click Subscribe.

    Note

    The new specifications take effect within 10 minutes.

API reference

Operation

Description

ModifyDBNodeClassChanges the node specifications of a PolarDB cluster.