All Products
Search

This Product

    ApsaraDB for SelectDB:Configure parameters

    Document Center

    ApsaraDB for SelectDB:Configure parameters

    Last Updated:Feb 28, 2026

    Modify frontend (FE) and backend (BE) cluster parameters, such as log retention, feature toggles, and access control settings, from the ApsaraDB for SelectDB console.

    Prerequisites

    • The instance runs kernel version 2.4 or later.

    • The target cluster is in the Running state.

    Restart impact

    Some parameters require a cluster restart to take effect. Check the Force Restart column on the Parameter Settings tab. If the value is Yes, the cluster restarts after you apply the change.

    • Scope: Modifying FE cluster parameters restarts only that FE cluster. The same applies to BE clusters.

    • Rolling restart (default): Nodes restart one at a time. The cluster stays available, but transient connections may occur.

    • Parallel restart: All nodes restart simultaneously. The cluster is unavailable for 1 to 5 minutes. Use this option during off-peak hours.

    Modify parameters

    1. Log on to the ApsaraDB for SelectDB console.

    2. In the top navigation bar, select the region of your instance.

    3. In the left-side navigation pane, click Instances. Find the target instance and click its instance ID.

    4. In the left-side pane, click Parameters.

    5. On the Parameter Settings tab, select a cluster from the Select Cluster drop-down list.

    6. Find the parameter to modify and click the edit icon in the Current Value column. Enter a value in the New Value field based on the valid values, then click OK.

      • (Optional) Turn on Show Modified Parameters Only to view parameters changed but not yet submitted.

      • (Optional) Click Undo Current Modification to discard all unsubmitted changes.

    7. Click Apply Changes in the upper-right corner. In the Save Settings dialog box, configure the following parameters.

      Parameter

      Description

      Select Modification Time

      Modify Now: applies the change immediately. Modify Within Maintenance Window: applies the change during your scheduled maintenance window. For details, see Specify a maintenance window.

      Important

      If Force Restart is Yes for any modified parameter, set Select Modification Time to Modify Within Maintenance Window to reduce the restart impact on your workloads.

      Parallel Operation Node

      Controls the restart strategy. Applies only when Force Restart is Yes. Cleared (default): rolling restart -- nodes restart in sequence and the cluster stays available, though transient connections may occur. Selected: parallel restart -- all nodes restart at the same time and the cluster is unavailable for 1 to 5 minutes.

    8. Click OK.

      Note

      After you submit changes, they do not take effect immediately. Go to the Modification History tab and check the Take Effect column to confirm whether each change has been applied.

    View modification history

    1. Log on to the ApsaraDB for SelectDB console.

    2. In the top navigation bar, select the region of your instance.

    3. In the left-side navigation pane, click Instances. Find the target instance and click its instance ID.

    4. In the left-side pane, click Parameters.

    5. Click the Modification History tab and select the cluster from the Select Cluster drop-down list.