All Products
Search

This Product

    E-MapReduce:Upgrade the major version of a StarRocks instance

    Document Center

    E-MapReduce:Upgrade the major version of a StarRocks instance

    Last Updated:Mar 24, 2025

    In Alibaba Cloud E-MapReduce (EMR) Serverless StarRocks, versions include major and minor versions. In most cases, major version upgrades include large-scale feature improvement, new feature releases, and architectural change. For example, you can upgrade the major version of an instance from 2.X to 3.X. You can upgrade the major version of an instance with one click to implement seamless version switch.

    Prerequisites

    An EMR Serverless StarRocks instance is created. For more information, see Create an instance.

    Limits

    • The instance is in the Running state.

    • You cannot upgrade a version from 2.5 to 3.1. If you use an instance of V2.5 and want to upgrade the version of the instance to V3.1, you must purchase a new instance. For more information, see Create an instance.

    Precautions

    • Upgrading the major version of a StarRocks instance may lead to incompatibility issues. Before you upgrade the major version of a StarRocks instance, make sure that the relevant content has been thoroughly validated in the testing environment to avoid any impacts on your business.

    • You cannot downgrade the version of an instance after you upgrade the version.

    • During a version upgrade on an instance, you cannot upgrade the configurations of the instance, scale the instance, modify configurations of the instance, or apply for a public endpoint for the instance.

    • During a major version upgrade, the import or query jobs that are running may fail. We recommend that you upgrade the major version during off-peak hours.

    Procedure

    1. Go to the Instance Details tab.

      1. Log on to the EMR console.

      2. In the left-side navigation pane, choose EMR Serverless > StarRocks.

      3. In the top navigation bar, select a region based on your business requirements.

      4. On the page that appears, find the desired instance and click the name of the instance.

    2. In the Version Information section of the Instance Details tab, click Update to the right of the Version parameter.

      If the Update button is dimmed, no version upgrade is available.

    3. In the Confirm Update dialog box, configure the parameters shown in the following table and click OK.

      If the status of the instance changes from Updating to Running, the major version of the instance is upgraded.

      Parameter

      Description

      Select Version

      Select the desired version.

      Restart Mode

      This parameter is available only for StarRocks shared-data instances.

      The restart mode. Valid values:

      • Rolling Restart: All compute nodes (CNs) in a StarRocks instance are restarted in sequence. This ensures that specific nodes are running to maintain service availability. This is the default value. This mode applies to scenarios in which high service continuity is required. This mode can effectively reduce the impact on your business.

      • Quick Restart: All CNs are restarted at a time, and the restart speed is fast. This mode applies to scenarios in which a restart operation needs to be completed as soon as possible. If you select this mode, your service may be interrupted. We recommend that you change the warehouse specifications during off-peak hours.

        Note

        Quick restart is supported only if the minor version of a StarRocks shared-data instance is 1.6.10 or later.

    References

    For more information about minor version updates, see Update the minor version of a StarRocks instance.