All Products
Search
Document Center

Tair (Redis® OSS-Compatible):Set parameters

Last Updated:Nov 20, 2025

Tair (Redis OSS-compatible) lets you customize the values of some parameters. The supported parameters vary based on the engine version and architecture. This topic describes how to set parameters.

Notes

  • If you receive the error message Parameter is not supported for current version when you set instance parameters, it indicates that the minor version of the instance is outdated. You must upgrade the instance to the latest minor version. For more information, see Upgrade minor and proxy versions.

  • Tair (Redis OSS-compatible) does not support setting parameters by running commands directly. For example, if you run the CONFIG SET TIMEOUT 60 command, the system returns OK to ensure compatibility with some integration frameworks, but the setting does not take effect. You can set parameters in the console or by calling the ModifyInstanceConfig API operation.

Procedure

  1. Log on to the console and go to the Instances page. In the top navigation bar, select the region in which the instance that you want to manage resides. Then, find the instance and click the instance ID.

  2. In the navigation pane on the left, click Parameter Settings.

  3. Modify the parameters.

    You can modify parameters in one of the following three ways. For more information, see the Tair Enterprise Edition parameter list or the Redis Open-Source Edition parameter list.

    Warning

    After you submit the modifications for some parameters, the instance is automatically restarted. During the restart, your service may experience a transient disconnection. Proceed with caution. For more information, see the Restart and Take Effect column for the parameter.

    • Modify a single parameter:

      1. Find the target parameter and click Modify in the Actions column.

      2. Click OK.

    • Modify parameters in a batch:

      1. Click Batch Modify.

      2. In theRunning Value column, modify the value for each parameter that you want to change.

      3. After you finish the modifications, click Modify at the bottom of the page.

    • Import from a file:

      You can use this method to apply the parameter configuration from a source instance to the current instance. To do this, go to the Parameter setting page of the source instance and click the 下载参数 icon in the upper-right corner to download the parameter configuration file of the source instance.

      Note

      You must import the parameter configuration file to an instance that has the same version and architecture as the source instance. Otherwise, some parameters may not take effect. For example, the query_cache_enabled parameter is supported only for memory-optimized Tair (Enterprise Edition) instances. If you import this parameter to an instance of another series or a Redis Open-Source Edition instance, the parameter does not take effect.

      1. Click Import from File.

      2. In the Batch Import panel, click the 从文件导入参数 icon to upload the object file.

      3. In the Parameter Details area, confirm and select the parameters that you want to modify.

        Note

        You can enable Display Only Changed Parameters to view only the parameters whose values are different from their current Running Value.

      4. Click Modify.

Related API operations

API operation

Description

DescribeParameters

Queries the configuration parameters and running parameters of an instance.

ModifyInstanceConfig

Modifies the parameter configurations of an instance.

FAQ

  • Q: How do I set the Maxclients parameter for an instance?

    A: Tair (Redis OSS-compatible) does not support setting the Maxclients parameter. The maximum number of connections for an instance depends on its instance type. For example, a Tair memory-optimized 4 GB (tair.rdb.4g) instance supports a maximum of 40,000 connections. For more information, see the Instance Types and FAQ document. You can increase the maximum number of connections for the instance by upgrading the instance type or enabling read/write splitting.