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 versionwhen 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
| Parameter | Description | Memory-optimized | Persistent memory | Takes effect upon restart |
|---|---|---|---|---|
#no_loose_check-whitelist-always | Controls 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-commands | Specifies 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-n | A 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>- 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-limit | Sets 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-enabled | Enables 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-access | When 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-commands | When 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 | Standard ✔️<br>Direct connection cluster ✔️<br>Proxy cluster ❌<br>Read/write splitting ❌ | ❌ | No | |
#no_loose_tls-min-version | Sets 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-enable | Controls 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-effort | Controls 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 |
appendfsync | The 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 |
appendonly | Enables 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-threshold | The 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-threshold | The 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 normal | Limits 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 | Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️ | Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️ | No |
dynamic-hz | Enables 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_enabled | Enables 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-value | For 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-value | For 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-threshold | The 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 |
hz | Sets 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-eviction | Controls 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-expire | Controls 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-del | Controls 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-del | Controls 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-depth | Sets 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-size | Controls 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 KB | Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️ | Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️ | No |
maxmemory-policy | The 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-events | Configures 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 | Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️ | Standard ✔️<br>Cluster ✔️<br>Read/write splitting ✔️ | No |
pena_rename_move_compatible_enabled | Enables 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-entries | Sets 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-than | The 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-len | The 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-bytes | The 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-entries | The 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 |
timeout | The 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-value | For 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-value | For 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
| Parameter | Description | Disk-based | Takes effect upon restart |
|---|---|---|---|
#no_loose_disabled-commands | Specifies 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-mode | Enables 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-ms | Parameters 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 | Standard ✔️<br>Cluster ✔️ | No |
bigkey-threshold | The 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-threshold | The 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-threshold | The 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-size | The 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-size | The 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 | Standard ✔️<br>Cluster ✔️ | No |
optimise-huge-value | Enables 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-than | The 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-len | The maximum number of entries the slow query log retains. Valid values: [100–10000]. Default: 1024. | Standard ✔️<br>Cluster ✔️ | No |
timeout | The 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-lock | Enables 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.
| Parameter | Description | Takes effect upon restart |
|---|---|---|
cluster_compat_enable | Controls 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_enabled | Controls 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_processing | The 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-keys | A 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 | No |
ptod_enabled | Controls 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_mode | Parameters 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>- | No |
read_request_only_ronode_whenrwsplit_enable | Controls 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_enable | Controls 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_ms | The 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_enable | Controls 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_enable | Enables Sentinel-compatible mode for the proxy. Default: 0.<br><br>- 0: Disabled.<br>- 1: Enabled. | No |
transfer_subscrible_to_psubscrible_enable | Controls 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 |