All Products
Search
Document Center

Tair (Redis® OSS-Compatible):Configuration parameter list for Tair Enterprise Edition

Last Updated:Mar 28, 2026

Tair (Enterprise Edition) lets you tune instance behavior by adjusting a set of supported parameters. This topic lists all configurable parameters for memory-optimized, persistent memory, and disk-based instances.

For parameters that apply to Redis Open-Source Edition instances, see Supported Redis parameters.

Usage notes

  • Only the parameters listed in this topic can be configured. To learn how to set a parameter, see Set parameters.

  • Some parameters trigger an automatic instance restart when you apply changes. During the restart, the instance may experience a brief disconnection lasting a few seconds. Check the Takes effect upon restart column before applying changes.

  • If you receive the error Parameter is not supported for current version when setting a parameter, upgrade the minor version and try again.

  • Supported parameters vary by engine version and architecture. For architecture details, see Query architecture information.

Table conventions

The tables in this topic use the following symbols:

  • ✔️: Supported

  • ❌: Not supported

Memory-optimized and persistent memory instances

ParameterDescriptionMemory-optimizedPersistent memoryTakes effect upon restart
#no_loose_check-whitelist-alwaysControls whether the instance checks the client IP address against the whitelist after you enable passwordless access for a VPC. Default: no.<br><br>- yes: Requires the client IP to be in the whitelist even after passwordless access is enabled. If the whitelist is not correctly configured, the connection returns (error) ERR illegal address.<br>- no: Skips the whitelist check. Any client in the same VPC can connect after passwordless access is enabled.<br><br>
Note

Only instances using the classic architecture support this parameter. Cloud-native architecture instances always enforce the IP whitelist, regardless of whether passwordless access is enabled.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
#no_loose_disabled-commandsSpecifies commands to disable. Use this to block high-risk or high-latency commands such as FLUSHALL, FLUSHDB, KEYS, HGETALL, EVAL, EVALSHA, and SCRIPT.<br><br>- Enter commands in lowercase, separated by commas.<br>- Disabling FLUSHALL does not affect the Clear Data feature in the console.<br>- Some commands, such as CONFIG, cannot be disabled. See Commands that cannot be disabled.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
#no_loose_high-cost-key-enabled<br>#no_loose_high-cost-key-traffic-bytes-threshold<br>#no_loose_high-cost-key-parse-hashtag<br>#no_loose_high-cost-key-parse-prefix<br>#no_loose_high-cost-key-parse-prefix-delimiters<br>#no_loose_high-cost-key-parse-prefix-find-limit-n<br>#no_loose_high-cost-key-parse-prefix-skip-first-nA group of parameters for monitoring hot keys (keys with high access traffic). After enabling, view results in CloudDBA > Top Key Statistics.<br><br>
Important

Enabling this feature increases CPU usage by more than 5%, proportional to the number of keys.<br><br>- #no_loose_high-cost-key-enabled: Enables the feature. Default: no. Set to yes to enable.<br>- #no_loose_high-cost-key-traffic-bytes-threshold: Access traffic threshold (bytes/s) for reporting a hot key. Valid values: [1024–4294967295]. Default: 1048576 (1 MB/s).<br>- #no_loose_high-cost-key-parse-hashtag: Aggregates keys sharing the same {hashtag}. If their combined traffic exceeds the threshold, the hashtag is reported as a hot key. Default: no.<br> Example: {user}a and {user}b are not individually hot keys, but if their aggregated traffic exceeds the threshold, Top Key Statistics marks {user} as a hot key of the Hashtag type.<br>- #no_loose_high-cost-key-parse-prefix: Aggregates keys sharing the same prefix. Default: no.<br> - #no_loose_high-cost-key-parse-prefix-delimiters: Characters used as separators. Default: empty. Multiple characters (e.g., : _) are each treated as individual separators.<br> - #no_loose_high-cost-key-parse-prefix-skip-first-n: Number of leading separators to skip. Valid values: [0–5]. Default: 0.<br> - #no_loose_high-cost-key-parse-prefix-find-limit-n: Maximum depth (segments) to extract as a prefix. Valid values: [1–5]. Default: 1.<br> Example: For keys service:user:123 and service:user:456 with separator : — if skip-first-n is 1 and find-limit-n is 1, the hot key service:user is captured; if skip-first-n is 0 and find-limit-n is 2, both service and service:user are captured.<br><br>

Note

Requires a cloud-native memory-optimized instance with minor version 25.2.0.0 or later. Hashtag and prefix parsing require minor version 25.9.1.0 or later.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
#no_loose_lua-strict-mode
Enables strict mode for Lua scripts. When enabled, standard architecture instances behave like cluster architecture instances — data keys in Lua scripts must be passed through the KEYS array and cannot be dynamically generated. This allows Lua scripts to use multi-threaded parallel processing, significantly improving performance. Default: no.<br><br>- no: Disabled.<br>- yes: Strict mode enabled (recommended). See Lua script specifications and common errors.<br><br>
Note

Supported only on memory-optimized instances compatible with Redis 6.0 or later.

Standard ✔️<br>Cluster ❌<br>Read/write splitting ❌No
#no_loose_maxmemory-evict-percent-soft-limitSets the memory usage percentage at which background eviction starts, before the instance reaches its Maxmemory limit. This allows early eviction without affecting command performance. Valid values: [50–100]. Default: 100.<br><br>The eviction policy is still governed by maxmemory-policy.<br><br>
Note

Supported only on memory-optimized instances compatible with Redis 6.0 or later, with minor version 25.2.0.0 or later.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
#no_loose_publish-no-wait-result
Improves PUBLISH command throughput by not waiting for subscriber counts. When enabled, PUBLISH always returns 0. Default: no.<br><br>
Note

Supported only on memory-optimized instances compatible with Redis 6.0 or later.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
#no_loose_sentinel-enabledEnables Sentinel-compatible mode for the instance. Default: no.<br><br>- yes: Enabled.<br>- no: Disabled.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ❌Standard ✔️<br>Cluster ✔️<br>Read/write splitting ❌No
#no_loose_sentinel-password-free-accessWhen Sentinel mode is enabled, controls whether Sentinel commands can be executed without a password on any connection. Default: no.<br><br>- yes: Password-free execution of Sentinel commands is allowed. You can also use the SENTINEL command to listen to the +switch-master channel.<br>- no: Disabled.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
#no_loose_sentinel-password-free-commandsWhen Sentinel mode is enabled and #no_loose_sentinel-password-free-access is set to yes, specifies additional commands that can run without a password on any connection. Default: empty.<br><br>
Important

Commands configured here can be run without authentication on any connection. Enter commands in lowercase, separated by commas.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
#no_loose_slow-query-isolation-weight
Sets the threshold (number of sub-members in a key) above which slow query commands are routed to an isolated thread, freeing the main thread for regular commands. The following commands are covered: KEYS, SMEMBERS, HKEYS, HVALS, HGETALL, EXHKEYS, EXHVALS, and EXHGETALL. For the KEYS command, the threshold applies to the number of keys in the current DB. Valid values: [1–999999999999999]. Default: 1000.<br><br>Example: If a Set has more than 1,000 members, SMEMBERS on that key uses the isolated thread. When the isolated thread's pending queue exceeds 500 requests, subsequent commands fall back to regular threads.<br><br>
Note

Avoid setting this threshold too low — excessive pressure on the isolated thread wastes resources. If most requests are slow query commands, consider disabling isolation by setting this parameter to 999999999999999. Supported only on cloud-native memory-optimized instances.

Standard ✔️<br>Direct connection cluster ✔️<br>Proxy cluster ❌<br>Read/write splitting ❌No
#no_loose_tls-min-versionSets the minimum TLS version the instance accepts. Default: TLSv1.<br><br>Valid values: TLSv1, TLSv1.1, TLSv1.2.Standard ❌<br>Cluster ✔️<br>Read/write splitting ✔️No
#no_loose_ts-auto-del-empty-skey-enableControls whether an Skey in a TairTS data structure is automatically deleted when all its data points have expired. Default: yes.<br><br>- yes: The Skey is deleted when all data points expire.<br>- no: The empty Skey is retained.<br><br>
Note

Supported only on memory-optimized instances compatible with Redis 6.0 or later, with minor version 24.7.0.0 or later.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
active-expire-effortControls how aggressively the instance cleans up expired keys in the background. Higher values reduce memory used by expired keys faster but increase CPU usage and latency. Valid values: [1–10]. Default: 1.<br><br>
Note

Supported only on persistent memory instances.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
appendfsyncThe fsync frequency for Append-Only File (AOF) persistence. Takes effect only when appendonly is enabled. Default: everysec (not modifiable).Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
appendonlyEnables or disables AOF persistence on the primary node. Default: yes.<br><br>- yes: AOF persistence enabled.<br>- no: AOF persistence disabled.<br><br>
Note

Redis Database (RDB) persistence runs once per day by default. See Automatic or manual backup.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Yes
bigkey-thresholdThe element count threshold for identifying large keys in Top Key Statistics. Valid values: [500–100000]. Default: 2000.<br><br>
Note

If this parameter is not shown in the parameter settings, upgrade the minor version and try again.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
bigkey-mem-thresholdThe memory size threshold (bytes) for identifying large keys in Top Key Statistics. Valid values: [1048576–1073741824] bytes. Default: 536870912 bytes (512 MB).<br><br>
Note

Supported only on cloud-native memory-optimized instances with minor version 25.6.0.0 or later.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
client-output-buffer-limit pubsub<br>client-output-buffer-limit normalLimits the output buffer for pub/sub clients and normal clients. Format: <hard limit> <soft limit> <soft seconds>.<br><br>- Default for pubsub: 33554432 8388608 60<br>- Default for normal: 524288000 0 0<br><br>When a client's output buffer reaches the hard limit, the connection is immediately closed. When it reaches the soft limit and stays there for the specified number of seconds, the connection is closed.<br><br>
Important

<br>- Only memory-optimized instances compatible with Redis 6.0 or later support client-output-buffer-limit normal.<br>- The client output buffer consumes runtime memory. If too many commands accumulate, it can trigger data eviction or cause an out-of-memory failure. Review your instance's memory specification before adjusting these values.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
dynamic-hzEnables dynamic adjustment of the background task execution frequency. Default: yes.<br><br>- yes: Enabled.<br>- no: Disabled.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
globalvectorindex_enabledEnables or disables the TairVector global index. Default: 0.<br><br>- 0: Disabled.<br>- 1: Enabled.Standard ❌<br>Cluster ✔️<br>Read/write splitting ❌No
hash-max-ziplist-entries<br>hash-max-ziplist-valueFor instances compatible with Redis 6.0 and earlier, a hash object uses ziplist encoding when both conditions are met: the number of key-value pairs is less than hash-max-ziplist-entries, and the string length of all keys and values is less than hash-max-ziplist-value.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
hash-max-listpack-entries<br>hash-max-listpack-valueFor instances compatible with Redis 7.0 and later, a hash object uses listpack encoding when both conditions are met: the number of key-value pairs is less than hash-max-listpack-entries, and the string length of all keys and values is less than hash-max-listpack-value.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
hotkey-thresholdThe QPS threshold for identifying hot keys in Top Key Statistics. Valid values: [100–100000]. Default: 5000.<br><br>
Note

Supported only on cloud-native memory-optimized instances. Minor version requirements:<br>- Redis 5.0–compatible: 5.5.0.50 or later.<br>- Redis 6.0 and 7.0–compatible: 25.2.0.0 or later.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
hzSets how many times per second the instance runs background tasks (such as cleaning up expired keys). Valid values: [1–500]. Default: 10.<br><br>Higher values result in more frequent key cleanup and more precise timeout handling, but increase CPU usage. Avoid values above 100.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
lazyfree-lazy-evictionControls whether eviction uses asynchronous (lazyfree) deletion. Default: no.<br><br>- yes: Enabled.<br>- no: Disabled.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
lazyfree-lazy-expireControls whether expired key deletion uses asynchronous (lazyfree) deletion. Default: yes.<br><br>- yes: Enabled.<br>- no: Disabled.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
lazyfree-lazy-server-delControls whether the DEL command uses asynchronous (lazyfree) deletion. Default: yes.<br><br>- yes: Enabled.<br>- no: Disabled.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
lazyfree-lazy-user-delControls whether the DEL command uses asynchronous (lazyfree) deletion (user-triggered). Default: yes.<br><br>- yes: Enabled.<br>- no: Disabled.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
list-compress-depthSets how many nodes at each end of a list are kept uncompressed. Nodes in the middle are compressed. Valid values: [0–65535]. Default: 0 (no compression).Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
list-max-ziplist-size<br>list-max-listpack-sizeControls the size or length of the ziplist (Redis 6.0 and earlier) or listpack (Redis 7.0 and later) on each quicklist node.<br><br>- Positive values limit by number of data items per node (e.g., 5 means at most 5 items per node).<br>- Negative values limit by byte size:<br> - -1: 4 KB<br> - -2 (default): 8 KB<br> - -3: 16 KB<br> - -4: 32 KB<br> - -5: 64 KBStandard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
maxmemory-policyThe eviction policy applied when the instance reaches its Maxmemory limit. Default: volatile-lru for memory-optimized instances; noeviction for persistent memory instances.<br><br>Notes:<br>- Maxmemory equals the purchased instance size and cannot be changed.<br>- In cluster architecture, eviction triggers per data node when that node hits its Maxmemory limit, even if total cluster memory is not exhausted. Handle data skew proactively. See How do I handle data skew?.<br>- LRU (least recently used), LFU (least frequently used), and volatile-ttl policies use approximate random algorithms.<br><br>Available policies:<br>- volatile-lru: Evicts the least recently used key among keys with an expiration time set.<br>- noeviction: Rejects new writes when memory is full; returns an error.<br>- volatile-lfu: Evicts the least frequently used key among keys with an expiration time set.<br>- volatile-random: Randomly evicts a key with an expiration time set.<br>- volatile-ttl: Evicts the key with the shortest time to live (TTL) among keys with an expiration time set.<br>- allkeys-lru: Evicts the least recently used key from all keys.<br>- allkeys-lfu: Evicts the least frequently used key from all keys.<br>- allkeys-random: Randomly evicts a key from all keys.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
notify-keyspace-eventsConfigures which keyspace event notifications the instance sends. Enabling this consumes additional CPU resources. For details, see Redis keyspace notifications.<br><br>
Important

The value must contain at least K or E; otherwise no notifications are sent.<br><br>Use any combination of the following characters:<br>- K: Keyspace notifications (prefixed with __keyspace@<db>__).<br>- E: Key-event notifications (prefixed with __keyevent@<db>__).<br>- g: Generic commands (DEL, EXPIRE, RENAME, etc.).<br>- $: String commands.<br>- l: List commands.<br>- s: Set commands.<br>- h: Hash commands.<br>- z: Sorted set commands.<br>- x: Expired events (sent when an expired key is deleted).<br>- e: Evicted events (sent when a key is deleted by the eviction policy).<br>- A: Alias for g$lshzxe — subscribes to all of the above.<br><br>Example: To receive expiration events, set this parameter to Ex, then run PSUBSCRIBE __keyevent@0__* on the client to subscribe to key-event notifications for DB0.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
pena_rename_move_compatible_enabledEnables compatible mode for the MOVE and RENAME series of commands. Unlike native Redis (O(1) complexity), these commands have O(n) complexity in Tair — operations on large keys can take considerable time. Default: no.<br><br>- no: Disabled.<br>- yes: Enabled. The commands can be used with the same syntax as native Redis.<br><br>
Note

Supported only on persistent memory instances with version 1.2.4 or later.

Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
set-max-intset-entriesSets the maximum size for a Set that uses intset encoding. A Set uses intset encoding when all its members are base-10 integers within the range of 64-bit signed integers.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
slowlog-log-slower-thanThe execution time threshold for recording a command in the slow query log. Commands that take longer than this value are logged. Unit: microseconds (μs). Valid values: [10000–10000000]. Default: 20000 (20 ms).Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
slowlog-max-lenThe maximum number of entries the slow query log retains. Valid values: [100–10000]. Default: 1024.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
stream-node-max-bytesThe maximum memory (bytes) a single macro node in a Stream can occupy. Valid values: [0–999999999999999]. Default: 4096. Set to 0 for no limit.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
stream-node-max-entriesThe maximum number of entries a single macro node in a Stream can store. Valid values: [0–999999999999999]. Default: 100. Set to 0 for no limit.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
timeoutThe number of idle seconds before the instance closes a client connection. Valid values: [0, 100000]. Default: 0 (connections are never closed due to inactivity).Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
zset-max-ziplist-entries<br>zset-max-ziplist-valueFor instances compatible with Redis 6.0 and earlier, a sorted set uses ziplist encoding when both conditions are met: the number of key-value pairs is less than zset-max-ziplist-entries, and the string length of all keys and values is less than zset-max-ziplist-value.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No
zset-max-listpack-entries<br>zset-max-listpack-valueFor instances compatible with Redis 7.0 and later, a sorted set uses listpack encoding when both conditions are met: the number of key-value pairs is less than zset-max-listpack-entries, and the string length of all keys and values is less than zset-max-listpack-value.Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️No

Disk-based instances

ParameterDescriptionDisk-basedTakes effect upon restart
#no_loose_disabled-commandsSpecifies commands to disable. Use this to block high-risk or high-latency commands such as FLUSHALL, FLUSHDB, KEYS, HGETALL, EVAL, EVALSHA, and SCRIPT.<br><br>- Enter commands in lowercase, separated by commas.<br>- Disabling FLUSHALL does not affect the Clear Data feature in the console.<br>- Some commands, such as CONFIG, cannot be disabled. See Commands that cannot be disabled.Standard ✔️<br>Cluster ✔️No
#no_loose_lua-strict-modeEnables strict mode for Lua scripts. Data keys must be passed through the KEYS array and cannot be dynamically generated. This enables multi-threaded parallel processing for Lua scripts. Default: no.<br><br>- no: Disabled.<br>- yes: Strict mode enabled (recommended). Also requires enabling txn-isolation-lock. See Lua script specifications and common errors.Standard ✔️<br>Cluster ✔️No
batch-scan-count<br>batch-scan-size<br>scan-background-interval-msParameters for the background key polling process, which checks TTL and performs garbage collection.<br><br>- scan-background-interval-ms: Polling interval in milliseconds. Default: 1000 (1 second).<br>- batch-scan-count: Number of keys polled per iteration. Default: 20000.<br>- batch-scan-size: Maximum data polled per iteration in bytes. Default: 2097152 (2 MB).<br><br>The polling loop exits when either batch-scan-count or batch-scan-size is reached, then waits for the next interval.<br><br>
Note

Decreasing scan-background-interval-ms increases garbage collection frequency but also consumes more disk bandwidth. Avoid aggressive changes that could affect user request performance.

Standard ✔️<br>Cluster ✔️No
bigkey-thresholdThe element count threshold for identifying large keys in Top Key Statistics. Valid values: [500–100000]. Default: 2000.<br><br>
Note

Supported only on disk-based instances with version 2.6.0 or later.

Standard ✔️<br>Cluster ✔️No
hotkey-thresholdThe QPS threshold for identifying hot keys in Top Key Statistics. Valid values: [100–100000]. Default: 5000.<br><br>
Note

Supported only on disk-based instances with version 2.6.0 or later.

Standard ✔️<br>Cluster ✔️No
latency-monitor-thresholdThe duration threshold for recording a latency event. Events that exceed this threshold are logged. Unit: milliseconds. Valid values: [0–10000000]. Default: 100.Standard ✔️<br>Cluster ✔️No
max-rename-commit-sizeThe maximum data volume (bytes) of a key that the RENAME command can process. If the actual data exceeds this limit, the operation fails. Valid values: [1024–268435456]. Default: 16777216 (16 MB).Standard ✔️<br>Cluster ✔️No
max-write-batch-sizeThe size limit (bytes) for intermediate in-memory data generated during command execution in disk storage format. Valid values: [0–1073741824]. Default: 0 (no limit).<br><br>
Note

If your workload is likely to produce large intermediate data, set this to 1073741824 (1 GB) to prevent memory overflow.

Standard ✔️<br>Cluster ✔️No
optimise-huge-valueEnables performance optimization for large values. Default: no.<br><br>- no: Disabled.<br>- yes: Enabled. Can double write performance for large values, but reduces range query efficiency (SCAN, HGETALL, ZRANGE) and increases memory usage fluctuations. Enable only when average value sizes exceed 16 KB and write throughput is high.<br><br>
Note

Supported only on disk-based SSD instances with version 2.6.0 or later.

Standard ✔️<br>Cluster ✔️No
slowlog-log-slower-thanThe execution time threshold for recording a command in the slow query log. Unit: microseconds (μs). Valid values: [10000–10000000]. Default: 1000000.Standard ✔️<br>Cluster ✔️No
slowlog-max-lenThe maximum number of entries the slow query log retains. Valid values: [100–10000]. Default: 1024.Standard ✔️<br>Cluster ✔️No
timeoutThe number of idle seconds before the instance closes a client connection. Valid values: [0, 100000]. Default: 0 (connections are never closed due to inactivity).Standard ✔️<br>Cluster ✔️No
txn-isolation-lockEnables transaction locks, allowing disk-based instances to run MULTI, EXEC, and Lua script commands. Enabling this parameter may cause up to 10% performance degradation. Default: no.<br><br>- no: Disabled.<br>- yes: Enabled. These commands work with the same syntax as native Redis.Standard ✔️<br>Cluster ✔️No

Proxy node parameters

These parameters are provided by proxy nodes and apply only to instances using cluster architecture in proxy mode or read/write splitting architecture.

ParameterDescriptionTakes effect upon restart
cluster_compat_enableControls compatibility with native Redis cluster syntax. Default: 1.<br><br>- 0: Disabled.<br>- 1: Enabled. When enabled, READONLY, READWRITE, and CLUSTER class commands are supported. See List of commands supported in proxy mode.No
hello_enabledControls whether the HELLO command can switch between RESP2 and RESP3 protocols. Default: 0.<br><br>- 0: Disabled.<br>- 1: Enabled.<br><br>
Note

Supported only on Proxy version 7.0.9 and later.

No
max_session_processingThe maximum number of in-flight requests per connection. Valid values: [10–10000000]. Default: 1000.<br><br>When a proxy node forwards a request to a data node but has not received a response, that request is in-flight. This parameter limits request accumulation caused by processing speed differences between the proxy frontend and backend, preventing excessive memory growth.No
#no_loose_statistics-ip-enable<br>#no_loose_statistics-cmds<br>#no_loose_statistics-keysA group of parameters for the observability feature. After setting these parameters, also enable the audit log for them to take effect. Statistics are collected in 5-second intervals.<br><br>- #no_loose_statistics-ip-enable: Enables IP address statistics, recording the IP addresses of established connections. Valid values: yes (enable) and no (default, disable).<br>- #no_loose_statistics-cmds: Commands to track. Records the source IP address and frequency for each tracked command. Default: empty (no commands tracked). Separate multiple commands with commas.<br>- #no_loose_statistics-keys: Keys to track. Records the source IP address and frequency for each tracked key. Default: empty (no keys tracked). Separate multiple keys with commas.<br><br>
Note

<br>- Only memory-optimized instances support this group of parameters.<br>- To minimize performance impact, keep the number of tracked commands and keys small. Enable only for troubleshooting or O&M purposes.<br><br>To retrieve statistics, download audit logs from the Simple Log Service console (see Download audit logs) and filter by the following type values:<br>- 7: QPS statistics by IP address<br>- 8: Connection statistics by IP address<br>- 9: Key statistics<br>- 10: Command statistics

No
ptod_enabledControls whether the proxy passes the client's original IP address through to the data node. Default: 1.<br><br>- 0: Disabled. The data node sees proxy node IP addresses instead of client IPs.<br>- 1: Pass-through enabled.No
query_cache_enabled<br>query_cache_expire<br>query_cache_modeParameters for the proxy node query cache feature. When enabled, the proxy caches hot key results and returns cached responses directly without forwarding requests to data shards.<br><br>
Important

Cached key-value data is not updated during the cache validity period. Confirm your workload can tolerate eventual consistency before enabling.<br><br>- query_cache_enabled: Enables the feature. Default: 0 (disabled). Set to 1 to enable.<br>- query_cache_expire: Cache validity period in milliseconds. Valid values: [100–60000]. Default: 1000. A shorter value reduces cache hit rate; a longer value increases the window during which clients read stale data.<br>- query_cache_mode: Working mode.<br> - 0 (default): Caches only hot keys pushed by data shards.<br> - 1: Caches all keys using LRU (least recently used) eviction. Because each proxy thread has a 100 MB cache limit, LRU eviction may reduce hit rate and overall performance.

No
read_request_only_ronode_whenrwsplit_enableControls whether read-only account requests are forwarded exclusively to read replicas. Default: 0.<br><br>- 0: Disabled. Read-only account requests are distributed to all nodes (including the primary) based on weight.<br>- 1: Enabled. Read-only account requests go directly to read replicas, not the primary.No
readonly_lua_route_ronode_enableControls Lua execution mode on read replicas. Default: 0.<br><br>- 0: Disabled. Lua commands are processed by the primary node.<br>- 1: Enabled. Lua scripts containing only read operations are forwarded to read replicas.No
rt_threshold_msThe slow query log threshold for the proxy node. A log entry is generated when the time from when the proxy sends a request to when it receives a response exceeds this value. Unit: milliseconds. Valid values: [30–2000]. Default: 500.No
script_check_enableControls whether the proxy checks Lua scripts before execution. For the list of checks, see Proxy check items for Lua. Default: 1.<br><br>- 0: Checks disabled. Note that read-only accounts always have script checks enabled regardless of this setting.<br>- 1: Checks enabled.No
sentinel_compat_enableEnables Sentinel-compatible mode for the proxy. Default: 0.<br><br>- 0: Disabled.<br>- 1: Enabled.No
transfer_subscrible_to_psubscrible_enableControls whether the proxy converts SUBSCRIBE commands to PSUBSCRIBE. Default: 0.<br><br>- 0: Disabled.<br>- 1: Enabled. Enable this if you cannot receive notifications on a subscribed channel because Lua scripts use PUB/SUB class commands.No