Tair (Redis® OSS-Compatible):Tair Enterprise Edition の設定パラメーター一覧

パラメーター

説明

メモリ最適化

永続メモリ

[再起動後に有効]

#no_loose_check-whitelist-always

VPC のパスワードレスアクセスを有効にした後、インスタンスがクライアントの IP アドレスをホワイトリストと照合するかどうかを制御します。デフォルト： no。

• yes： パスワードレスアクセスが有効になった後でも、クライアント IP がホワイトリストに含まれている必要があります。ホワイトリストが正しく設定されていない場合、接続は (error) ERR illegal address を返します。

• no： ホワイトリストのチェックをスキップします。パスワードレスアクセスが有効になると、同じ VPC 内のどのクライアントでも接続できます。

標準： 対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

#no_loose_disabled-commands

無効にするコマンドを指定します。これを使用して、FLUSHALL、FLUSHDB、KEYS、HGETALL、EVAL、EVALSHA、SCRIPT などの高リスクまたは高レイテンシーのコマンドをブロックします。

• コマンドは小文字で入力し、コンマで区切ります。

• FLUSHALL を無効にしても、コンソールの [Clear Data] 機能には影響しません。

• CONFIG など、一部のコマンドは無効にできません。詳細については、「無効にできないコマンド」をご参照ください。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

#no_loose_high-cost-key-enabled

#no_loose_high-cost-key-traffic-bytes-threshold

#no_loose_high-cost-key-parse-hashtag

#no_loose_high-cost-key-parse-prefix

#no_loose_high-cost-key-parse-prefix-delimiters

#no_loose_high-cost-key-parse-prefix-find-limit-n

#no_loose_high-cost-key-parse-prefix-skip-first-n

ホットキー (アクセス量の多いキー) を監視するための一連のパラメーターです。この機能を有効にすると、検出されたホットキーを [CloudDBA] > [Top Key Statistics] で表示できます。

• #no_loose_high-cost-key-enabled： この機能のスイッチです。デフォルト： no (無効)。yes に設定すると有効になります。

• #no_loose_high-cost-key-traffic-bytes-threshold： ホットキーを報告するためのアクセス量のしきい値 (バイト/秒)。有効な値： 1024～4294967295。デフォルト： 1048576 (1 MB/s)。

• #no_loose_high-cost-key-parse-hashtag： 同じ {hashtag} を共有するキーを集約します。これらのキーの合計トラフィックがしきい値を超えた場合、ハッシュタグはホットキーとして報告されます。デフォルト： no。

  たとえば、{user}a と {user}b は個々にはホットキーではありません。ただし、これらの集計されたトラフィックがしきい値を超えると、[Top Key Statistics] は {user} を Hashtag タイプのホットキーとしてマークします。

• #no_loose_high-cost-key-parse-prefix： 同じプレフィックスを共有するキーを集約します。デフォルト： no。このパラメーターが有効な場合にのみ、次の 3 つのパラメーターが有効になります：

  • #no_loose_high-cost-key-parse-prefix-delimiters： 区切り文字として使用される文字。デフォルト： 空。複数の文字 (例： : _) を指定すると、各文字は個別の区切り文字として扱われます。

  • #no_loose_high-cost-key-parse-prefix-skip-first-n： スキップする先頭の区切り文字の数。有効な値： 0～5。デフォルト： 0。

  • #no_loose_high-cost-key-parse-prefix-find-limit-n： プレフィックスとして抽出するセグメントの最大数。有効な値： 1～5。デフォルト： 1。

  たとえば、区切り文字が : のキー service:user:123 と service:user:456 を考えます。skip-first-n が 1 で find-limit-n が 1 の場合、ホットキー service:user がキャプチャされます。skip-first-n が 0 で find-limit-n が 2 の場合、service と service:user の両方がキャプチャされます。

標準： 対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

#no_loose_lua-strict-mode

Lua スクリプトの厳格モードを有効にします。有効にすると、標準アーキテクチャのインスタンスはクラスターアーキテクチャのインスタンスのように動作します： Lua スクリプトのデータキーは KEYS 配列を介して渡す必要があり、動的に生成することはできません。これにより、Lua スクリプトはマルチスレッドの並列処理を使用できるようになり、パフォーマンスが大幅に向上します。デフォルト： no。

• no： 無効。

• yes： 厳格モード有効 (推奨)。詳細については、「Lua スクリプトの仕様と一般的なエラー」をご参照ください。

標準： 対応

クラスター： 非対応

読み書き分離： 非対応

非対応

いいえ

#no_loose_maxmemory-evict-percent-soft-limit

インスタンスが Maxmemory 制限に達する前に、バックグラウンドでのエビクションが開始されるメモリ使用率を設定します。これにより、コマンドのパフォーマンスに影響を与えることなく、早期のエビクションが可能になります。有効な値： 50～100。デフォルト： 100。

エビクションポリシーは、引き続き maxmemory-policy によって管理されます。

標準： 対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

#no_loose_publish-no-wait-result

サブスクライバー数を待機しないことで、PUBLISH コマンドのスループットを向上させます。有効にすると、PUBLISH は常に 0 を返します。デフォルト： no。

標準： 対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

#no_loose_qps-limit-dim

#no_loose_qps-limit

インスタンスへのアクセスを制御できる QPS スロットリングのための一連のパラメーターです。有効にすると、インスタンスへのリクエスト数が設定されたしきい値に達した場合、インスタンスは新しいリクエストを拒否し、-THROTTLED エラーを返します。

• #no_loose_qps-limit-dim： スロットリングのディメンション。有効な値：

  • read (デフォルト)： 読み取りリクエストをスロットリングします。

  • write： 書き込みリクエストをスロットリングします。

  • rw： 読み取りと書き込みの両方のリクエストをスロットリングします。

  • all： すべてのコマンドをスロットリングします。

  • other： INFO や PING などのその他のコマンドをスロットリングします。

• #no_loose_qps-limit： QPS の上限値。有効な値： 0～1000000000。デフォルト値は 0 で、スロットリングを無効にします。このパラメーターが 0 に設定されている場合、#no_loose_qps-limit-dim パラメーターは有効になりません。

標準： 対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

#no_loose_sentinel-enabled

インスタンスの Sentinel 互換モードを有効にします。デフォルト： no。

• yes： 有効。

• no： 無効。

標準： 対応

クラスター： 対応

読み書き分離： 非対応

標準： 対応

クラスター： 対応

読み書き分離： 非対応

いいえ

#no_loose_sentinel-password-free-access

Sentinel モードが有効な場合、このパラメーターは、任意の接続で Sentinel コマンドをパスワードなしで実行できるかどうかを制御します。デフォルト： no。

• yes： Sentinel コマンドのパスワードなしでの実行が許可されます。また、SENTINEL コマンドを使用して +switch-master チャネルをリッスンすることもできます。

• no： 無効。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

#no_loose_sentinel-password-free-commands

Sentinel モードが有効で、#no_loose_sentinel-password-free-access が yes に設定されている場合、このパラメーターは、任意の接続でパスワードなしで実行できる追加のコマンドを指定します。デフォルト： 空。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

#no_loose_slow-query-isolation-weight

低速クエリコマンドが分離されたスレッドにルーティングされるしきい値 (キー内のサブメンバーの数) を設定し、メインスレッドを通常のコマンド用に解放します。対象となるコマンドは以下のとおりです： KEYS、SMEMBERS、HKEYS、HVALS、HGETALL、EXHKEYS、EXHVALS、および EXHGETALL。KEYS コマンドの場合、しきい値は現在の DB 内のキーの数に適用されます。有効な値： 1～999999999999999。デフォルト： 1000。

たとえば、Set に 1,000 を超えるメンバーがある場合、そのキーに対する SMEMBERS は分離されたスレッドを使用します。分離されたスレッドの保留キューが 500 リクエストを超えると、後続のコマンドは通常のスレッドにフォールバックします。

標準： 対応

ダイレクト接続クラスター： 対応

プロキシクラスター： 非対応

読み書き分離： 非対応

非対応

いいえ

#no_loose_tsync-repl-mode

プライマリノードとセカンダリノード間の同期モード。有効な値：

• async (デフォルト)： ネイティブ Redis の非同期レプリケーションを使用します。

• semisync： 準同期モード。有効にすると、プライマリノードはクライアントに応答を返す前に、セカンダリノードに更新操作をレプリケートします。このモードでは、書き込みレイテンシーが約 0.5 ms から 3 ms 増加します。高いデータ一貫性を必要とし、ある程度の書き込みパフォーマンスの低下を許容できるシナリオに適しています。

  セカンダリノードが利用できない場合、またはプライマリノードとセカンダリノード間でネットワーク例外が発生した場合、準同期モードは非同期モードにダウングレードします。

標準： 対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

#no_loose_tsync-semisync-wait-timeout-ms

このパラメーターを調整する前に、まず準同期モードを有効にする必要があります (#no_loose_tsync-repl-mode を semisync に設定)。

このパラメーターは、準同期モードのタイムアウトを設定します。書き込みリクエストがプライマリ-セカンダリ同期を待機する時間がこのしきい値を超えた場合、リクエストはまだセカンダリノードにレプリケートされていなくても、直ちにクライアントに返されます。単位： ミリ秒。有効な値： 1～7200000。デフォルト： 100。

標準： 対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

#no_loose_tls-min-version

インスタンスが受け入れる最小の TLS バージョンを設定します。デフォルト： TLSv1。

有効な値： TLSv1、TLSv1.1、TLSv1.2。

標準： 非対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

#no_loose_ts-auto-del-empty-skey-enable

TairTS データ構造内の Skey のすべてのデータポイントが期限切れになったときに、その Skey を自動的に削除するかどうかを制御します。デフォルト： yes。

• yes： すべてのデータポイントが期限切れになると Skey は削除されます。

• no： 空の Skey は保持されます。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

active-expire-effort

インスタンスがバックグラウンドで期限切れのキーをどの程度積極的にクリーンアップするかを制御します。値が高いほど、期限切れのキーが使用するメモリはより速く削減されますが、CPU 使用率とレイテンシーは増加します。有効な値： 1～10。デフォルト： 1。

非対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

appendfsync

AOF (Append-Only File) 永続化の fsync 頻度。appendonly が有効な場合にのみ有効になります。デフォルト： everysec (変更不可)。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

appendonly

プライマリノードで AOF 永続化を有効または無効にします。デフォルト： yes。

• yes： AOF 永続化が有効になります。

• no： AOF 永続化が無効になります。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

はい

bigkey-threshold

[Top Key Statistics] で大きなキー (多くの要素を持つキー) を識別するための要素数のしきい値。有効な値： 500～100000。デフォルト： 2000。

標準： 対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

bigkey-mem-threshold

[Top Key Statistics] で大きなキー (大量のメモリを消費するキー) を識別するためのメモリサイズのしきい値。単位： バイト。有効な値： 1048576～1073741824 (1 MB～1 GB)。デフォルト： 536870912 バイト (512 MB)。

標準： 対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

bigkey-field-mem-threshold

[Top Key Statistics] で大きなキー (大量のメモリを消費するキー) を識別するためのサブ要素ごとの平均メモリサイズのしきい値。単位： バイト。有効な値： 1024～1073741824 (1 KB～1 GB)。デフォルト： 1048576 バイト (1 MB)。

標準： 対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

client-output-buffer-limit pubsub

client-output-buffer-limit normal

pub/sub クライアントと通常クライアントの出力バッファを制限します。フォーマット： <hard limit> <soft limit> <soft seconds>。

• pubsub のデフォルト： 33554432 8388608 60

• normal のデフォルト： 524288000 0 0

クライアントの出力バッファがハードリミットに達すると、接続は直ちに閉じられます。バッファがソフトリミットに達し、指定された秒数間その状態が続くと、接続は閉じられます。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

dynamic-hz

バックグラウンドタスクの実行頻度の動的調整を有効にします。デフォルト： yes。

• yes： 有効。

• no： 無効。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

globalvectorindex_enabled

TairVector グローバルインデックスを有効または無効にします。デフォルト： 0。

• 0： 無効。

• 1： 有効。

標準： 非対応

クラスター： 対応

読み書き分離： 非対応

非対応

いいえ

hash-max-ziplist-entries

hash-max-ziplist-value

Redis 6.0 以前と互換性のあるインスタンスでは、キーと値のペアの数が hash-max-ziplist-entries 未満で、かつすべてのキーと値の文字列長が hash-max-ziplist-value 未満である場合、ハッシュオブジェクトは ziplist エンコーディングを使用します。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

hash-max-listpack-entries

hash-max-listpack-value

Redis 7.0 以降と互換性のあるインスタンスでは、キーと値のペアの数が hash-max-listpack-entries 未満で、かつすべてのキーと値の文字列長が hash-max-listpack-value 未満である場合、ハッシュオブジェクトは listpack エンコーディングを使用します。

標準： 対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

hotkey-threshold

[Top Key Statistics] でホットキーを識別するための QPS のしきい値。有効な値： 100～100000。デフォルト： 5000。

標準： 対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

hz

インスタンスが期限切れキーのクリーンアップなどのバックグラウンドタスクを 1 秒あたりに実行する回数を設定します。有効な値： 1～500。デフォルト： 10。

値が高いほど、キーのクリーンアップが頻繁になり、タイムアウトの処理がより正確になりますが、CPU 使用率も増加します。100 を超える値は避けてください。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

lazyfree-lazy-eviction

エビクションで非同期 (lazyfree) 削除を使用するかどうかを制御します。デフォルト： no。

• yes： 有効。

• no： 無効。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

lazyfree-lazy-expire

期限切れキーの削除で非同期 (lazyfree) 削除を使用するかどうかを制御します。デフォルト： yes。

• yes： 有効。

• no： 無効。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

lazyfree-lazy-server-del

DEL コマンドで非同期 (lazyfree) 削除を使用するかどうかを制御します。デフォルト： yes。

• yes： 有効。

• no： 無効。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

lazyfree-lazy-user-del

ユーザーがトリガーした DEL コマンドで非同期 (lazyfree) 削除を使用するかどうかを制御します。デフォルト： yes。

• yes： 有効。

• no： 無効。

非対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

list-compress-depth

リストの両端で非圧縮のまま保持されるノードの数を設定します。中間のノードは圧縮されます。有効な値： 0～65535。デフォルト： 0 (圧縮なし)。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

list-max-ziplist-size

list-max-listpack-size

各 quicklist ノード上の ziplist (Redis 6.0 以前) または listpack (Redis 7.0 以降) のサイズまたは長さを制御します。

• 正の値は、ノードごとのデータ項目数で制限します。たとえば、5 はノードごとに最大 5 項目を意味します。

• 負の値は、バイトサイズで制限します：

  • -1： 4 KB

  • -2 (デフォルト)： 8 KB

  • -3： 16 KB

  • -4： 32 KB

  • -5： 64 KB

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

maxmemory-policy

インスタンスが Maxmemory 制限に達したときに適用されるエビクションポリシー。デフォルト： メモリ最適化インスタンスでは volatile-lru、永続メモリインスタンスでは noeviction。

注意事項：

• Maxmemory は購入したインスタンスサイズと等しく、変更できません。

• クラスターアーキテクチャでは、クラスター全体のメモリが枯渇していなくても、データノードがその Maxmemory 制限に達すると、そのノードでエビクションがトリガーされます。データスキューに積極的に対処してください。詳細については、「データスキューの対処方法」をご参照ください。

• LRU (最近最も使用されていない)、LFU (最も使用頻度が低い)、および volatile-ttl ポリシーは、近似ランダムアルゴリズムを使用します。

利用可能なポリシー：

• volatile-lru： 有効期限が設定されているキーの中から、最近最も使用されていないキーを削除します。

• noeviction： メモリがフルの場合、新しい書き込みを拒否し、エラーを返します。

• volatile-lfu： 有効期限が設定されているキーの中から、最も使用頻度の低いキーを削除します。

• volatile-random： 有効期限が設定されているキーをランダムに削除します。

• volatile-ttl： 有効期限が設定されているキーの中から、TTL (Time-To-Live) が最も短いキーを削除します。

• allkeys-lru： すべてのキーの中から、最近最も使用されていないキーを削除します。

• allkeys-lfu： すべてのキーの中から、最も使用頻度の低いキーを削除します。

• allkeys-random： すべてのキーの中からランダムにキーを削除します。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

notify-keyspace-events

インスタンスが送信するキースペースイベント通知を設定します。これを有効にすると、追加の CPU リソースが消費されます。詳細については、「Redis キースペース通知」をご参照ください。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

pena_rename_move_compatible_enabled

MOVE および RENAME シリーズのコマンドの互換モードを有効にします。ネイティブ Redis (O(1) の複雑さ) とは異なり、これらのコマンドは Tair では O(n) の複雑さを持ちます。そのため、大きなキーに対する操作にはかなりの時間がかかることがあります。デフォルト： no。

• no： 無効。

• yes： 有効。コマンドはネイティブ Redis と同じ構文で使用できます。

非対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

set-max-intset-entries

intset エンコーディングを使用する Set の最大サイズを設定します。Set のすべてのメンバーが 64 ビット符号付き整数の範囲内の 10 進整数である場合、Set は intset エンコーディングを使用します。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

slowlog-log-slower-than

低速クエリログにコマンドを記録するための実行時間のしきい値。この値よりも時間がかかったコマンドがログに記録されます。単位： マイクロ秒。有効な値： 10000～10000000。デフォルト： 20000 (20 ms)。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

slowlog-max-len

低速クエリログが保持するエントリの最大数。有効な値： 100～10000。デフォルト： 1024。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

stream-node-max-bytes

Stream 内の単一のマクロノードが消費できるメモリの最大量。単位： バイト。有効な値： 0～999999999999999。デフォルト： 4096。0 に設定すると制限なしになります。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

stream-node-max-entries

Stream 内の単一のマクロノードが格納できるエントリの最大数。有効な値： 0～999999999999999。デフォルト： 100。0 に設定すると制限なしになります。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

timeout

インスタンスがクライアント接続を閉じるまでのアイドル秒数。有効な値： 0～100000。デフォルト： 0 (アイドル状態では接続が閉じられることはありません)。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

zset-max-ziplist-entries

zset-max-ziplist-value

Redis 6.0 以前と互換性のあるインスタンスでは、キーと値のペアの数が zset-max-ziplist-entries 未満で、かつすべてのキーと値の文字列長が zset-max-ziplist-value 未満である場合、ソート済みセットは ziplist エンコーディングを使用します。

標準： 対応

クラスター： 対応

読み書き分離： 対応

標準： 対応

クラスター： 対応

読み書き分離： 対応

いいえ

zset-max-listpack-entries

zset-max-listpack-value

Redis 7.0 以降と互換性のあるインスタンスでは、キーと値のペアの数が zset-max-listpack-entries 未満で、かつすべてのキーと値の文字列長が zset-max-listpack-value 未満である場合、ソート済みセットは listpack エンコーディングを使用します。

標準： 対応

クラスター： 対応

読み書き分離： 対応

非対応

いいえ

パラメーター

説明

ディスクベース

[再起動後に有効]

#no_loose_disabled-commands

無効にするコマンドを指定します。FLUSHALL、FLUSHDB、KEYS、HGETALL、EVAL、EVALSHA、SCRIPT などの高リスクまたは高レイテンシーのコマンドをブロックできます。

• コマンドは小文字で入力し、コンマで区切ります。

• FLUSHALL を無効にしても、コンソールの [Clear Data] 機能には影響しません。

• CONFIG など、一部のコマンドは無効にできません。詳細については、「無効にできないコマンド」をご参照ください。

標準：対応

クラスター：対応

いいえ

#no_loose_lua-strict-mode

Lua スクリプトのストリクトモードを有効にします。データキーは KEYS 配列を介して渡す必要があり、動的に生成することはできません。これにより、Lua スクリプトのマルチスレッド並列処理が可能になります。デフォルト： no。

• no：無効。

• yes：ストリクトモード有効 (推奨します)。txn-isolation-lock も有効にする必要があります。詳細については、「Lua スクリプトの仕様と一般的なエラー」をご参照ください。

標準：対応

クラスター：対応

いいえ

batch-scan-count

batch-scan-size

scan-background-interval-ms

TTL のチェックとガベージコレクションを実行する、バックグラウンドのキーポーリングプロセスに関するパラメーターです。

• scan-background-interval-ms：ポーリング間隔。単位：ミリ秒。デフォルト： 1000 (1 秒)。

• batch-scan-count：1 回のイテレーションでポーリングするキーの数。デフォルト： 20000。

• batch-scan-size：1 回のイテレーションでポーリングするデータの最大量。単位：バイト。デフォルト： 2097152 (2 MB)。

ポーリングループは、batch-scan-count または batch-scan-size のいずれかに達すると終了し、次の間隔まで待機します。

標準：対応

クラスター：対応

いいえ

bigkey-threshold

トップキー統計でラージキー (多くの要素を持つキー) を識別するための要素数のしきい値。有効な値：500～100000。デフォルト： 2000。

標準：対応

クラスター：対応

いいえ

hotkey-threshold

トップキー統計でホットキーを識別するための QPS のしきい値。有効な値：100～100000。デフォルト： 5000。

標準：対応

クラスター：対応

いいえ

latency-monitor-threshold

レイテンシーイベントを記録するための期間のしきい値。このしきい値を超えたイベントがログに記録されます。単位：ミリ秒。有効な値：0～10000000。デフォルト： 100。

標準：対応

クラスター：対応

いいえ

max-rename-commit-size

RENAME コマンドが処理できるキーの最大データ量 (バイト単位)。実際のデータがこの制限を超えると、操作は失敗します。有効な値：1024～268435456。デフォルト： 16777216 (16 MB)。

標準：対応

クラスター：対応

いいえ

max-write-batch-size

ディスクストレージ形式でコマンド実行中に生成される中間的なメモリ内データのサイズ制限 (バイト単位)。有効な値：0～1073741824。デフォルト： 0 (制限なし)。

標準：対応

クラスター：対応

いいえ

optimise-huge-value

大きな値に対するパフォーマンス最適化を有効にします。デフォルト： no。

• no：無効。

• yes：有効。大きな値に対して書き込みパフォーマンスを約 2 倍にできますが、範囲クエリ (SCAN、HGETALL、ZRANGE) の効率が低下し、メモリ使用量の変動が大きくなります。このオプションは、平均値サイズが 16 KB を超え、書き込みスループットが高い場合にのみ有効にしてください。

標準：対応

クラスター：対応

いいえ

slowlog-log-slower-than

スロークエリログにコマンドを記録するための実行時間のしきい値。単位：マイクロ秒。有効な値：10000～10000000。デフォルト： 1000000。

標準：対応

クラスター：対応

いいえ

slowlog-max-len

スロークエリログが保持するエントリの最大数。有効な値：100～10000。デフォルト： 1024。

標準：対応

クラスター：対応

いいえ

timeout

インスタンスがクライアント接続を閉じるまでのアイドル秒数。有効な値：0～100000。デフォルト： 0 (非アクティブ状態によって接続が閉じられることはありません)。

標準：対応

クラスター：対応

いいえ

timeout_retry_to_slave_enabled

異常リクエストのリトライ機能のスイッチ。有効な値：

• 0 (デフォルト)：機能を無効にします。

• 1：機能を有効にします。有効にすると、読み取りリクエストがタイムアウトし、timeout_ms_retry_to_slave の値に達した場合、プロキシは読み取りリクエストを自動的にセカンダリノードに転送し、読み取りリクエストの成功率を確保します。

標準：非対応

クラスター：対応

読み書き分離：非対応

いいえ

timeout_ms_retry_to_slave

リクエストのリトライをトリガーするタイムアウト期間。このパラメーターは timeout_retry_to_slave_enabled と一緒に使用する必要があります。単位：ミリ秒。有効な値：10～5000。デフォルト：500。

標準：非対応

クラスター：対応

読み書き分離：非対応

いいえ

txn-isolation-lock

トランザクションロックを有効にします。これにより、ディスクベースのインスタンスは MULTI、EXEC、および Lua スクリプトコマンドを実行できます。このパラメーターを有効にすると、最大で 10% のパフォーマンス低下が発生する可能性があります。デフォルト： no。

• no：無効。

• yes：有効。これらのコマンドは、ネイティブの Redis と同じ構文で動作します。

標準：対応

クラスター：対応

いいえ

パラメーター

説明

[再起動後に有効]

cluster_compat_enable

ネイティブ Redis クラスター構文との互換性を制御します。デフォルト： 1。

• 0：無効。

• 1：有効。有効にすると、READONLY、READWRITE、および CLUSTER クラスのコマンドがサポートされます。詳細については、「List of commands supported in proxy mode」をご参照ください。

いいえ

hello_enabled

HELLO コマンドで RESP2 と RESP3 プロトコルを切り替えられるかどうかを制御します。デフォルト： 0。

• 0：無効。

• 1：有効。

いいえ

max_session_processing

接続あたりのインフライトリクエストの最大数です。有効な値： 10 ～ 10000000。デフォルト： 1000。

プロキシノードがリクエストをデータノード へ転送した後、まだ応答を受信していない場合、そのリクエストはインフライトと見なされます。このパラメーターは、プロキシのフロントエンドとバックエンドの処理速度差によって発生するリクエストの蓄積を制限し、メモリの過度な増加を防止します。

いいえ

#no_loose_statistics-ip-enable

#no_loose_statistics-cmds

#no_loose_statistics-keys

可観測性 機能用のパラメーターグループです。これらのパラメーターを設定した後、有効にするには 監査ログ も有効にする必要があります。統計情報は 5 秒間隔で収集されます。

• #no_loose_statistics-ip-enable：IP アドレスの統計情報を有効にします。確立された接続の IP アドレスを記録します。有効な値： yes (有効) と no (デフォルト、無効)。

• #no_loose_statistics-cmds：追跡するコマンドを指定します。追跡対象の各コマンドについて、送信元 IP アドレスと実行頻度を記録します。デフォルト： 空 (コマンドは追跡されません)。複数のコマンドはカンマで区切って指定します。

• #no_loose_statistics-keys：追跡するキーを指定します。追跡対象の各キーについて、送信元 IP アドレスと頻度を記録します。デフォルト： 空 (キーは追跡されません)。複数のキーはカンマで区切って指定します。

いいえ

ptod_enabled

プロキシがクライアントの元の IP アドレスをデータノード へパススルーするかどうかを制御します。デフォルト： 1。

• 0：無効。データノードには、クライアントの IP ではなくプロキシノードの IP アドレスが表示されます。

• 1：有効。

いいえ

query_cache_enabled

query_cache_expire

query_cache_mode

プロキシノードのクエリキャッシュ機能用のパラメーターです。有効にすると、プロキシはホットキーの結果をキャッシュし、リクエストをデータシャードに転送せずにキャッシュされた応答を直接返します。

• query_cache_enabled：クエリキャッシュ機能を有効にするかどうかを制御します。デフォルト： 0 (無効)。有効にするには 1 に設定します。

• query_cache_expire：キャッシュの有効期間です。単位：ミリ秒。有効な値： 100 ～ 60000。デフォルト： 1000。値を短くするとキャッシュヒット率が低下します。値を長くすると、クライアントが古いデータを読み取る可能性がある期間が長くなります。

• query_cache_mode：動作モードです。

  • 0 (デフォルト)：データシャードからプッシュされたホットキーのみをキャッシュします。

  • 1：LRU (least recently used) エビクションで、すべてのキーをキャッシュします。各プロキシスレッドには 100 MB のキャッシュ上限があるため、LRU エビクションによりヒット率と全体的なパフォーマンスが低下する可能性があります。

いいえ

read_request_only_ronode_whenrwsplit_enable

読み取り専用アカウントからのリクエストをリードレプリカのみに転送するかどうかを制御します。デフォルト： 0。

• 0：無効。読み取り専用アカウントからのリクエストは、重みに基づいてすべてのノード (プライマリを含む) に分散されます。

• 1：有効。読み取り専用アカウントからのリクエストは、プライマリではなくリードレプリカに直接送信されます。

いいえ

readonly_lua_route_ronode_enable

リードレプリカでの Lua 実行モードを制御します。デフォルト： 0。

• 0：無効。Lua コマンドはプライマリで処理されます。

• 1：有効。読み取り操作のみを含む Lua スクリプトは、リードレプリカに転送されます。

いいえ

rt_threshold_ms

プロキシノードのスロークエリログのしきい値です。プロキシがリクエストを送信してから応答を受信するまでの時間がこの値を超えると、ログエントリが生成されます。単位：ミリ秒。有効な値： 30 ～ 2000。デフォルト： 500。

いいえ

script_check_enable

実行前にプロキシが Lua スクリプトをチェックするかどうかを制御します。チェック項目の一覧については、「Proxy check items for Lua」をご参照ください。デフォルト： 1。

• 0：無効。なお、読み取り専用アカウントは、この設定にかかわらず常にスクリプトチェックが有効です。

• 1：有効。

いいえ

sentinel_compat_enable

プロキシの Sentinel 互換モードを有効にするかどうかを制御します。デフォルト： 0。

• 0：無効。

• 1：有効。

いいえ

transfer_subscrible_to_psubscrible_enable

プロキシが SUBSCRIBE コマンドを PSUBSCRIBE に変換するかどうかを制御します。デフォルト： 0。

• 0：無効。

• 1：有効。Lua スクリプトが PUB/SUB クラスのコマンドを使用することが原因で、サブスクライブしたチャネルで通知を受信できない場合は、このオプションを有効にしてください。

いいえ