Manage configurations
EMR Serverless lets you use the console to query or modify parameters for StarRocks components like BE and FE, and view the configuration change history.
Restarting an instance temporarily stops it, which can cause business interruptions. Perform this operation during off-peak hours. To prevent service disruptions, ensure your client applications have a retry mechanism.
Prerequisites
You have created an EMR Serverless instance. For more information, see Create an instance.
Query configurations
-
Go to the E-MapReduce Serverless StarRocks instance list page.
-
Log on to the E-MapReduce console.
-
In the navigation pane on the left, choose .
-
In the top menu bar, select the required region.
-
-
On the Instances page, click the name of the desired instance.
-
Click the Parameter Configuration tab.
You can filter parameters by type, name, read-only status, or whether they have been modified.
Modify configurations
-
On the Parameter Configuration page, find the parameter that you want to modify.
You can search by parameter type or name.
-
After you modify the parameter value, click Submit Parameters.
-
In the dialog box, enter a Reason, select a Restart Mode, and click OK.
The Restart Mode option is displayed only when a configuration change requires the instance to be restarted. The following restart modes are supported:
-
Rolling Restart (Default): This method restarts nodes sequentially, ensuring high availability by keeping some nodes operational at all times. This mode is ideal for minimizing user impact.
-
Quick Restart: This mode restarts the instance as quickly as possible.
-
Do Not Restart: Applies the configuration change without restarting the instance. You can perform the restart later, potentially combined with other operations, to reduce downtime.
If the modification requires a restart, the instance restarts and enters the Updating Configuration state. The change is also recorded on the Operation History tab.
-
Add a parameter
-
On the Parameter Configuration page, click Add Configuration Item.
-
In the dialog box, add the required parameters, and then click OK.
You can add multiple parameters at a time.
Parameter
Description
Configuration File
The target file for the new parameter.
Key
The parameter name.
Value
The parameter value.
Actions
Allows you to delete the parameter.
-
Click Submit Parameters.
-
In the dialog box, enter a Reason, select a Restart Mode, and click OK.
-
Rolling Restart (Default): This method restarts nodes sequentially, ensuring high availability by keeping some nodes operational at all times. This mode is ideal for minimizing user impact.
-
Quick Restart: This mode restarts the instance as quickly as possible.
-
Do Not Restart: Applies the configuration change without restarting the instance. You can perform the restart later, potentially combined with other operations, to reduce downtime.
After the configuration items are added, the instance restarts and enters the Updating Configuration state. The change is also recorded on the Operation History tab.
-
View operation history
You can filter the operation history by date range.
-
Click the Operation History tab.
-
Click View Details in the Actions column to compare the parameter values before and after the change.
Related documents
For detailed descriptions of the parameters, see Parameter Configuration.