すべてのプロダクト
Search
ドキュメントセンター

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

最終更新日:May 30, 2026

Tair (Enterprise Edition) では、サポートされているパラメータを調整することで、インスタンスの動作をチューニングできます。このトピックでは、メモリ最適化永続メモリ、およびディスクベースの各インスタンスで設定可能なすべてのパラメータを一覧で示します。

Redis オープンソース版インスタンスのパラメータについては、「サポートされている Redis パラメータ」をご参照ください。

注意事項

  • このトピックに記載されているパラメータのみ設定できます。パラメータの設定方法については、パラメータの設定をご参照ください。

  • パラメーターによっては、変更を適用するとインスタンスが自動的に再起動されます。再起動の際、インスタンスへの接続が数秒間切断されることがあります。変更を適用する前に、[再起動時に有効] 列をご確認ください。

  • パラメータの設定時に Parameter is not supported for current version エラーが表示された場合は、マイナーバージョンをアップグレードしてから再試行してください。

  • サポートされるパラメータは、エンジンバージョンとアーキテクチャによって異なります。アーキテクチャの詳細については、アーキテクチャ情報のクエリをご参照ください。

表の規約

このトピックの表では、次の記号を使用します。

  • チェックマーク:対応

  • X マーク:非対応

メモリ最適化インスタンスと永続メモリインスタンス

パラメータ

説明

メモリ最適化

永続メモリ

[再起動後に有効]

#no_loose_check-whitelist-always

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

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

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

説明

このパラメータは、クラシックアーキテクチャを使用するインスタンスでのみサポートされます。クラウドネイティブアーキテクチャのインスタンスは、パスワードなしのアクセスが有効になっているかどうかにかかわらず、常に IP ホワイトリストを強制します。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

#no_loose_disabled-commands

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

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

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

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

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

#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] > [上位キー統計]で表示できます。

重要

この機能を有効にすると、キーの数に比例して CPU 使用率が 5% 以上増加する場合があります。必要な場合にのみ有効にしてください。

  • #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 は個別にはホットキーではありません。しかし、それらの集計されたトラフィックがしきい値を超えた場合、[上位キー統計]{user} をハッシュタグタイプのホットキーとして識別します。

  • #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:123service:user:456 で、区切り文字が : の場合を考えます。skip-first-n が 1 で、find-limit-n が 1 の場合、ホットキー service:user が検出されます。skip-first-n が 0 で、find-limit-n が 2 の場合、serviceservice:user の両方が検出されます。

説明

マイナーバージョンが 25.2.0.0 以降のクラウドネイティブメモリ最適化インスタンスでのみサポートされます。ハッシュタグとプレフィックスの解析には、マイナーバージョン 25.9.1.0 以降が必要です。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

#no_loose_lua-strict-mode

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

説明

Redis 6.0 以降に対応するメモリ最適化インスタンスでのみサポートされます。

Standard: 対応

Cluster: 非対応

Read/write splitting: 非対応

非対応

いいえ

#no_loose_maxmemory-evict-percent-soft-limit

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

削除ポリシーは、引き続き maxmemory-policy によって制御されます。

説明

Redis 6.0 以降に対応し、マイナーバージョンが 25.2.0.0 以降のメモリ最適化インスタンスでのみサポートされます。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

#no_loose_publish-no-wait-result

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

説明

Redis 6.0 以降に対応するメモリ最適化インスタンスでのみサポートされます。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

#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 パラメーターは有効になりません。

説明
  • Redis 6.0 以降に対応し、マイナーバージョンが 25.1.0.0 以降のメモリ最適化インスタンスでのみサポートされます。

  • 例外を回避するために、事前にクライアントで THROTTLED エラーを処理することをお勧めします。 また、クライアントが THROTTLED エラーを受信したときに頻繁なリトライを避けることをお勧めします。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

#no_loose_sentinel-enabled

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

  • yes: 有効。

  • no: 無効。

Standard: 対応

Cluster: 対応

Read/write splitting: 非対応

Standard: 対応

Cluster: 対応

Read/write splitting: 非対応

いいえ

#no_loose_sentinel-password-free-access

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

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

  • no: 無効。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

#no_loose_sentinel-password-free-commands

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

重要

ここで設定されたコマンドは、どの接続でも認証なしで実行できます。コマンドは小文字で入力し、カンマで区切ります。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

#no_loose_slow-query-isolation-weight

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

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

説明

このしきい値を低く設定しすぎないようにしてください。隔離スレッドに過度の圧力がかかると、リソースが浪費されます。ほとんどのリクエストがスロークエリコマンドである場合は、このパラメーターを 999999999999999 に設定して隔離を無効にすることを検討してください。クラウドネイティブのメモリ最適化インスタンスでのみサポートされています。

Standard: 対応

Direct connection cluster: 対応

Proxy cluster: 非対応

Read/write splitting: 非対応

非対応

いいえ

#no_loose_tsync-repl-mode

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

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

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

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

説明

Redis 6.0 以降に対応し、マイナーバージョンが 23.12.2.0 以降のメモリ最適化インスタンスでのみサポートされます。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

#no_loose_tsync-semisync-wait-timeout-ms

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

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

説明

Redis 6.0 以降に対応し、マイナーバージョンが 23.12.2.0 以降のメモリ最適化インスタンスでのみサポートされます。変更は慎重に行ってください。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

#no_loose_tls-min-version

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

有効な値: TLSv1, TLSv1.1, TLSv1.2.

Standard: 非対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

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

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

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

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

説明

Redis 6.0 以降に対応し、マイナーバージョンが 24.7.0.0 以降のメモリ最適化インスタンスでのみサポートされます。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

active-expire-effort

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

説明

永続メモリインスタンスでのみサポートされます。

非対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

appendfsync

追加専用ファイル (AOF) 永続化の fsync 頻度。appendonly が有効な場合にのみ適用されます。デフォルト: everysec (変更不可)。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

appendonly

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

  • yes: AOF 永続化が有効です。

  • no: AOF 永続化は無効です。

説明

Redis データベース (RDB) 永続化は、デフォルトで 1 日に 1 回実行されます。詳細については、「自動または手動バックアップ」をご参照ください。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

はい

bigkey-threshold

Top Key Statistics において大規模キー (多くの要素を持つキー) を特定するための要素数のしきい値。有効値: 500 ~ 100000。デフォルト: 2000

説明

このパラメータがパラメータ設定に表示されない場合は、マイナーバージョンをアップグレードして再試行してください。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

bigkey-mem-threshold

トップキー統計における、大きなキー (大量のメモリを消費するキー) を識別するためのメモリサイズのしきい値。単位: バイト。有効な値: 1048576~1073741824 (1 MB~1 GB)。デフォルト: 536870912 バイト (512 MB)。

説明

マイナーバージョンが 25.6.0.0 以降のクラウドネイティブメモリ最適化インスタンスでのみサポートされます。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

bigkey-field-mem-threshold

Top Key Statistics で大規模キー (大量のメモリを消費するキー) を識別するための、サブ要素あたりの平均メモリサイズしきい値。単位: バイト。有効値: 1024~1073741824 (1 KB~1 GB)。デフォルト: 1048576 バイト (1 MB)。

説明
  • マイナーバージョンが 25.6.0.0 以降のクラウドネイティブメモリ最適化インスタンスでのみサポートされます。

  • 2026 年 5 月 26 日以降、このパラメータのデフォルト値は 50 MB から 1 MB に変更されます。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

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

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

重要
  • Redis 6.0 以降に対応したメモリ最適化インスタンスのみが client-output-buffer-limit normal に対応しています。

  • クライアント出力バッファは実行時メモリを消費します。コマンドが多すぎると、インスタンスでデータ削除がトリガーされたり、メモリ不足になったりする可能性があります。これらの値を調整する前に、インスタンスのメモリ容量を確認してください。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

dynamic-hz

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

  • yes: 有効。

  • no: 無効。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

globalvectorindex_enabled

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

  • 0: 無効。

  • 1:有効。

Standard: 非対応

Cluster: 対応

Read/write splitting: 非対応

非対応

いいえ

hash-max-ziplist-entries

hash-max-ziplist-value

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

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

hash-max-listpack-entries

hash-max-listpack-value

Redis 7.0 以降に対応したインスタンスでは、キーと値のペアの数が hash-max-listpack-entries 未満で、かつすべてのキーと値の文字列の長さが hash-max-listpack-value 未満という両方の条件が満たされると、ハッシュオブジェクトは listpack エンコーディングを使用します。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

hotkey-threshold

トップキー統計におけるホットキー識別のための QPS しきい値。 有効な値: 100 ~ 100000。 デフォルト: 5000

説明

クラウドネイティブメモリ最適化インスタンスでのみサポートされます。必要なマイナーバージョンは次のとおりです。

  • Redis 5.0 互換:5.5.0.50 以降。

  • Redis 6.0 および Redis 7.0 互換:25.2.0.0 以降。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

hz

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

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

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

lazyfree-lazy-eviction

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

  • yes: 有効。

  • no: 無効。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

lazyfree-lazy-expire

有効期限が切れたキーを非同期 (lazyfree) で削除するかどうかを設定します。デフォルト: yes

  • yes:有効。

  • no: 無効。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

lazyfree-lazy-server-del

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

  • yes: 有効。

  • no: 無効。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

lazyfree-lazy-user-del

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

  • yes: 有効。

  • no:無効。

非対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

list-compress-depth

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

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

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

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

maxmemory-policy

インスタンスが Maxmemory の上限に達したときに適用される追い出しポリシーです。デフォルト値は、メモリ最適化インスタンスでは volatile-lru、永続メモリインスタンスでは noeviction です。

注意事項:

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

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

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

利用可能なポリシー:

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

  • noeviction:メモリが満杯になると、新しい書き込みを拒否し、エラーを返します。

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

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

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

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

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

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

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

notify-keyspace-events

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

重要

値には、K または E のいずれかを含める必要があります。そうでない場合、通知は送信されません。

以下の文字の任意の組み合わせを使用します。

  • K: キースペース通知 (__keyspace@<db>__をプレフィックスに持つ)。

  • E: キーイベント通知 (__keyevent@<db>__ で始まる)。

  • g: DEL、EXPIRE、RENAME などの汎用コマンド。

  • $:文字列コマンド。

  • l:コマンドを一覧表示します。

  • s: コマンドを設定します。

  • h: ハッシュコマンド。

  • z: ソート済みセットコマンド。

  • x: 期限切れイベント。期限切れのキーが削除されると送信されます。

  • e: エビクトイベント。エビクションポリシーによってキーが削除されると送信されます。

  • A: g$lshzxe のエイリアス。上記のすべてをサブスクライブします。

例: 有効期限イベントを受信するには、このパラメーターを Ex に設定し、クライアントで PSUBSCRIBE __keyevent@0__* を実行して DB0 のキーイベント通知をサブスクライブします。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

pena_rename_move_compatible_enabled

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

  • no: 無効。

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

説明

バージョン 1.2.4 以降の永続メモリインスタンスでのみサポートされます。

非対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

set-max-intset-entries

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

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

slowlog-log-slower-than

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

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

slowlog-max-len

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

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

stream-node-max-bytes

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

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

stream-node-max-entries

Stream 内の単一のマクロノードが保存できる最大エントリ数。 有効値: 0 ~ 999999999999999。 デフォルト: 100。 制限なしの場合は 0 に設定します。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

timeout

インスタンスがクライアント接続をクローズするまでのアイドル秒数。有効値: 0~100000。デフォルト: 0 (非アクティブでは接続はクローズされません)。

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

zset-max-ziplist-entries

zset-max-ziplist-value

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

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

いいえ

zset-max-listpack-entries

zset-max-listpack-value

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

Standard: 対応

Cluster: 対応

Read/write splitting: 対応

非対応

いいえ

ディスクベースのインスタンス

パラメータ

説明

ディスクベース

[再起動時に有効]

#no_loose_disabled-commands

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

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

  • FLUSHALL を無効にしても、コンソールの [データクリア] 機能には影響しません。

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

スタンダード:対応

クラスター:対応

いいえ

#no_loose_lua-strict-mode

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

スタンダード:対応

クラスター:対応

いいえ

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 のいずれかに達すると終了し、次の間隔まで待機します。

説明

scan-background-interval-ms を小さくすると、ガベージコレクションの頻度が増加しますが、ディスク帯域幅の消費も増加します。ユーザーリクエストのパフォーマンスに影響を与える可能性があるため、過度な変更は避けてください。

スタンダード:対応

クラスター:対応

いいえ

bigkey-threshold

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

説明

バージョン 2.6.0 以降のディスクベースのインスタンスでのみサポートされます。

スタンダード:対応

クラスター:対応

いいえ

hotkey-threshold

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

説明

バージョン 2.6.0 以降のディスクベースのインスタンスでのみサポートされます。

スタンダード:対応

クラスター:対応

いいえ

latency-monitor-threshold

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

スタンダード:対応

クラスター:対応

いいえ

max-rename-commit-size

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

スタンダード:対応

クラスター:対応

いいえ

max-write-batch-size

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

説明

ワークロードで大量の中間データが生成される可能性がある場合は、メモリ不足の問題を防ぐために、これを 1073741824 (1 GB) に設定してください。

スタンダード:対応

クラスター:対応

いいえ

optimise-huge-value

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

  • no:無効。

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

説明

バージョン 2.6.0 以降のディスクベース SSD インスタンスでのみサポートされます。

スタンダード:対応

クラスター:対応

いいえ

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

いいえ

hello_enabled

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

  • 0:無効。

  • 1:有効。

説明

Proxy バージョン 7.0.9 以降でのみサポートされます。

いいえ

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 アドレスと頻度を記録します。デフォルト:空 (キーは追跡されません)。複数のキーはカンマで区切ります。

説明
  • メモリ最適化インスタンスのみがこのパラメーターグループをサポートします。

  • パフォーマンスへの影響を最小限に抑えるため、追跡するコマンドとキーの数を少なくしてください。この機能は、トラブルシューティングまたは運用保守の目的でのみ有効にしてください。

統計情報を取得するには、Simple Log Service コンソールから監査ログをダウンロードし (「監査ログのダウンロード」をご参照ください)、次の type 値でフィルタリングします。

  • 7:IP アドレス別の QPS 統計

  • 8:IP アドレス別の接続統計

  • 9:キー統計

  • 10:コマンド統計

いいえ

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 (最近最も使用されていない) エビクションを使用してすべてのキーをキャッシュします。各プロキシスレッドには 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 スクリプトをチェックするかどうかを制御します。チェック項目のリストについては、「Lua のプロキシチェック項目」をご参照ください。デフォルト: 1

  • 0:無効。この設定に関わらず、読み取り専用アカウントでは常にスクリプトチェックが有効になりますので、ご注意ください。

  • 1:有効。

いいえ

sentinel_compat_enable

プロキシの Sentinel 互換モードを有効にします。デフォルト: 0

  • 0:無効。

  • 1:有効。

いいえ

transfer_subscrible_to_psubscrible_enable

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

  • 0:無効。

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

いいえ