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

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

最終更新日:Nov 16, 2025

Tair (Enterprise Edition) インスタンスのパラメーターを調整およびカスタマイズして、パフォーマンスとセキュリティを向上させることができます。このトピックでは、各パラメーターについて詳しく説明します。

注意

  • パラメーターを設定するときにエラーメッセージ Parameter is not supported for current version が表示された場合は、マイナーバージョンを更新して再試行してください。詳細については、「マイナーバージョンとプロキシバージョンを更新する」をご参照ください。

  • 一部のパラメーターは、変更を送信すると自動的にインスタンスを再起動します。再起動中、数秒間の一時的な切断が発生します。パラメーターを設定するときは、対象のパラメーターの [再起動時に有効] 列を確認してください。詳細については、「パラメーターの設定」をご参照ください。

重要

サポートされるパラメーターは、データベースエンジンバージョンとアーキテクチャによって異なります。このトピックでは、メモリ最適化永続メモリディスクベースインスタンスなど、Tair (Enterprise Edition) インスタンスのパラメーターのみを説明します。Redis Open-Source Edition インスタンスのパラメーターの詳細については、「サポートされている Redis パラメーター」をご参照ください。

サポートされているパラメーターと説明

読みやすさと明確さのために、このトピックの表では次の規則を使用しています。

  • ✔️ は、パラメーターがメジャーバージョンまたはアーキテクチャでサポートされていることを示します。

  • ❌ は、パラメーターがメジャーバージョンまたはアーキテクチャでサポートされていないことを示します。

説明
  • インスタンスの安定性を確保するために、このトピックに記載されているパラメーターのみを設定できます。

  • アーキテクチャの詳細については、「アーキテクチャ情報のクエリ」をご参照ください。

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

パラメーター

説明

インスタンスエディションとアーキテクチャ

メモリ最適化

永続メモリ

#no_loose_check-whitelist-always

VPC 経由のパスワードなしのアクセスを有効にした後、クライアントの IP アドレスがインスタンスのホワイトリストに含まれているかどうかを確認するかどうかを指定します。有効な値:

  • yes: チェックを有効にします。パスワードなしのアクセスを有効にした後、同じ VPC 内のクライアントの IP アドレスをインスタンスのホワイトリストに追加して、そのクライアントからインスタンスに接続する必要があります。

    パスワードなしのアクセスを有効にしてもホワイトリストを正しく設定しない場合、(error) ERR illegal address のようなエラーメッセージが返されます。

  • no (デフォルト): チェックを無効にします。パスワードなしのアクセスを有効にした後、同じ VPC 内のクライアントの IP アドレスをインスタンスのホワイトリストに追加して、そのクライアントからインスタンスに接続する必要はありません。

説明
  • このパラメーターは、クラシックアーキテクチャを使用するインスタンスでのみサポートされます。

  • クラウドネイティブアーキテクチャの場合、パスワードなしのアクセスが有効になっているかどうかに関係なく、IP ホワイトリストは常にチェックされます。

標準️️✔️

クラスター✔️

読み書き分離✔️

#no_loose_disabled-commands

指定されたコマンドを無効にします。FLUSHALLFLUSHDBKEYSHGETALLEVALEVALSHASCRIPT などの高リスクコマンドまたは時間計算量の大きいコマンドを必要に応じて無効にできます。

説明
  • コマンドは小文字で入力してください。複数のコマンドはコンマ (,) で区切ります。

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

  • インスタンスのパフォーマンスを安定させるために、Tair (Redis OSS-compatible) では CONFIG などのコマンドを無効にすることはできません。詳細については、「無効にできないコマンド」をご参照ください。

標準️️✔️

クラスター✔️

読み書き分離✔️

標準️️✔️

クラスター✔️

読み書き分離✔️

#no_loose_high-cost-key-enabled

ホットキー (高トラフィック) 検出機能を有効にするかどうかを指定します。この機能は、値の大きいキーなど、1 秒あたりのアクセス トラフィックが高いキーを識別します。この機能を有効にすると、[CloudDBA] > [Top Key Statistics] セクションで検出されたホットキーを表示できます。

  • #no_loose_high-cost-key-enabled: 機能のスイッチです。デフォルト値は no で、機能を無効にします。有効にするには、値を yes に設定します。

    重要

    この機能を有効にすると、キーの数に応じて、インスタンスの CPU 使用率が 5% 以上増加します。必要に応じてこの機能を有効にしてください。

  • #no_loose_high-cost-key-traffic-bytes-threshold: 1 秒あたりのキーアクセストラフィックの収集しきい値です。値の単位は Byte/s です。有効値は [1024-4294967295] です。デフォルトは 1048576 (1 MB/s) です。

  • #no_loose_high-cost-key-parse-hashtag: ハッシュタグ解析を有効にするかどうかを指定します。デフォルトは no です。yes に設定すると、システムは同じ {hashtag} を持つキーを集約します。合計アクセス トラフィックがしきい値を超えると、ハッシュタグはデータ型 Hashtag のホットキーとして報告されます。

    例: キー {user}a{user}b は個々のトラフィックは低いですが、集約されたトラフィックがしきい値を超えると、[Top Key Statistics]{user} をホットキーとしてマークします。

  • #no_loose_high-cost-key-parse-prefix: 共通プレフィックス解析を有効にするかどうかを指定します。デフォルトは no です。yes に設定すると、システムは同じプレフィックスを持つキーを集約します。合計アクセス トラフィックがしきい値を超えると、プレフィックスはデータ型 Prefix のホットキーとして報告されます。

    • #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 です。

    例: 2 つのキー 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 以降が必要です。

標準️️✔️

クラスター✔️

読み書き分離✔️

#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

#no_loose_lua-strict-mode

Lua スクリプトの厳格モードを有効にするかどうかを指定します。有効にすると、標準アーキテクチャインスタンスは、クラスターアーキテクチャインスタンスと同様に、Lua スクリプト内のデータキーを KEYS 配列を介して渡す必要があり、スクリプト内で動的に生成することはできません。このモードを有効にすると、Lua スクリプトをマルチスレッド並列処理で高速化でき、パフォーマンスが数倍向上します。有効な値:

説明

このパラメーターは、Redis 6.0 以降と互換性のあるメモリ最適化インスタンスでのみサポートされます。

標準️️✔️

クラスター❌

読み書き分離❌️

#no_loose_maxmemory-evict-percent-soft-limit

プロアクティブなエビクションのメモリしきい値です。有効値は [50-100] です。単位はパーセンテージです。デフォルトは 100 です。インスタンスのメモリ使用量がこのしきい値に達すると、Tair はコマンド実行パフォーマンスに影響を与えることなくバックグラウンドでデータのエビクションを開始します。

エビクションポリシーは、maxmemory-policy パラメーターの設定に依存します。

説明

このパラメーターは、Redis 6.0 以降と互換性があり、マイナーバージョンが 25.2.0.0 以降のメモリ最適化インスタンスでのみサポートされます。

標準️️✔️

クラスター✔️

読み書き分離✔️

#no_loose_publish-no-wait-result

このパラメーターを有効にすると、Tair インスタンスの PUBLISH コマンドのスループットが向上しますが、コマンドの戻り値は常に 0 になります。

  • no (デフォルト): 機能を有効にしません。

  • yes: 機能を有効にします。

説明

このパラメーターは、Redis 6.0 以降と互換性のあるメモリ最適化インスタンスでのみサポートされます。

標準️️✔️

クラスター✔️

読み書き分離✔️

#no_loose_slow-query-isolation-weight

通常のコマンドのレイテンシを改善するために、Tair は別のスレッドを分離してスロークエリコマンドを処理します。これは追加のスレッドであり、インスタンスの通常の処理には影響しません。特定のスロークエリコマンドには、KEYSSMEMBERSHKEYSHVALSHGETALLEXHKEYSEXHVALSEXHGETALL が含まれます。このリストにコマンドを追加したり削除したりすることはできません。

このパラメーターは、スロークエリコマンドのしきい値を定義します。これは、対応するキーのサブメンバーの数です。KEYS コマンドの場合、現在の DB のキーの数です。有効値は [1-999999999999999] です。デフォルトは 1000 です。たとえば、Set コレクションに 1,000 を超えるサブメンバーがある場合、そのキーで SMEMBERS コマンドを実行すると、分離されたスレッドが使用されます。

分離されたスレッドで待機中のリクエスト数が 500 を超えると、後続のコマンドは通常のスレッドで処理されます。

説明
  • このパラメーターは、クラウドネイティブメモリ最適化インスタンスでのみサポートされます。

  • このしきい値を低く設定しすぎないでください。分離されたスレッドに過度の圧力がかかり、全体のリソースが無駄になる可能性があります。ビジネスリクエストのほとんどが上記のスロークエリコマンドである場合は、このパラメーターを最大値の 999999999999999 に設定して、分離メカニズムを無効にすることを検討してください。

標準️️✔️

直接接続クラスター✔️

プロキシベースのクラスター❌

読み書き分離❌

#no_loose_sentinel-enabled

標準アーキテクチャインスタンスの Sentinel 互換モードを有効または無効にします。有効な値:

  • yes: モードを有効にします。

  • no (デフォルト): モードを無効にします。

標準️️✔️

クラスター✔️

読み書き分離❌

標準️️✔️

クラスター✔️

読み書き分離❌

#no_loose_sentinel-password-free-access

Sentinel モードが有効な場合、Sentinel 関連のコマンドをパスワードなしで実行できるかどうかを指定します。有効な値:

  • yes: 機能を有効にします。この機能を有効にすると、任意の接続で パスワードなしで Sentinel コマンドを実行でき、SENTINEL コマンドを使用して +switch-master チャンネルをリッスンできます。

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

標準️️✔️

クラスター✔️

読み書き分離✔️

標準️️✔️

クラスター✔️

読み書き分離✔️

#no_loose_sentinel-password-free-commands

Sentinel モードと #no_loose_sentinel-password-free-access パラメーターを有効にした後、このパラメーターを使用して追加のパスワードなしコマンドのリストを追加できます。デフォルト値は空です。

重要
  • このパラメーターを設定すると、任意の接続で対応するコマンドをパスワードなしで実行できます。このパラメーターは注意して使用してください。

  • コマンドは小文字で入力してください。複数のコマンドはコンマ (,) で区切ります。

標準️️✔️

クラスター✔️

読み書き分離✔️

標準️️✔️

クラスター✔️

読み書き分離✔️

#no_loose_tls-min-version

インスタンスがサポートする最小 TLS バージョンです。有効な値:

  • TLSv1 (デフォルト)。

  • TLSv1.1

  • TLSv1.2

標準️️❌

クラスター✔️

読み書き分離✔️

active-expire-effort

期限切れキーをクリアするタスクの積極性です。この値を大きくすると、エンジンは期限切れキーをより積極的にクリアするようになり、期限切れキーが占有するメモリは減少しますが、CPU 使用率とレイテンシも増加します。有効値は [1-10] です。デフォルトは 1 です。

説明

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

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

appendfsync

追加専用ファイル (AOF) 永続化の fsync 頻度です。このパラメーターは、appendonly パラメーターが有効な場合にのみ効果があります。デフォルト値は everysec です。この値は変更できません。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

appendonly

プライマリノードの AOF 永続化を有効または無効にします。有効な値:

  • yes (デフォルト): AOF 永続化を有効にします。

  • no: AOF 永続化を無効にします。

    説明

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

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

  • 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 です。

  • <hard limit>: クライアントの出力バッファーが占有するメモリがハードリミットに達するか超えると、クライアント接続は切断されます。ハードリミットの単位はバイトです。

  • <soft limit><soft seconds>: クライアントの出力バッファーが占有するメモリがソフトリミットに達するか超え、この状態が指定されたソフト秒数以上持続すると、クライアント接続は切断されます。ソフトリミットの単位はバイトです。ソフト秒数の単位は秒です。

重要
  • client-output-buffer-limit normal パラメーターは、Redis 6.0 以降と互換性のあるメモリ最適化インスタンスでのみサポートされます。

  • クライアント出力バッファーは実行メモリを占有します。コマンドが多すぎると、インスタンスデータの退避や、メモリ不足による故障を引き起こす可能性があります。このパラメーターを調整する前に、インスタンスのメモリ仕様を注意深く確認してください。注意して進めてください。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

dynamic-hz

動的 hz を有効または無効にします。有効な値:

  • yes (デフォルト): 動的 hz を有効にします。

  • no シャットダウン

標準️️✔️

クラスター✔️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

globalvectorindex_enabled

TairVector グローバルインデックスのスイッチです。有効な値:

  • 0 (デフォルト): インデックスを無効にします。

  • 1: 有効。

標準️️❌

クラスター✔️

読み書き分離❌

  • hash-max-ziplist-entries

  • hash-max-ziplist-value

Redis 6.0 以前と互換性のあるインスタンスでは、ハッシュのデフォルトコーデックとして ziplist が使用されます。ハッシュオブジェクトは、次の両方の条件が満たされた場合に ziplist エンコーディングを使用します。

  • ハッシュ内のキーと値のペアの数が hash-max-ziplist-entries の値未満である。

  • ハッシュ内のキーと値の両方の文字列長が hash-max-ziplist-value の値未満である。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

  • hash-max-listpack-entries

  • hash-max-listpack-value

Redis 7.0 以降と互換性のあるインスタンスでは、ハッシュのデフォルトコーデックとして listpack が使用されます。ハッシュオブジェクトは、次の両方の条件が満たされた場合に listpack エンコーディングを使用します。

  • ハッシュ内のキーと値のペアの数が hash-max-listpack-entries の値未満である。

  • ハッシュ内のキーと値の両方の文字列長が hash-max-listpack-value の値未満である。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

hz

期限切れキーのクリアタスクなど、インスタンスのバックグラウンドタスクの実行頻度です。有効値は [1-500] です。デフォルトは 10 で、1 秒あたり 10 回を意味します。

説明

値を高くすると CPU リソースをより多く消費しますが、期限切れキーが多い場合のクリア頻度も高くなります。また、インスタンスがタイムアウトをより正確に処理できるようになります。100 以下の値をお勧めします。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

lazyfree-lazy-eviction

lazyfree ベースのエビクションを有効にするかどうかを指定します。有効な値:

  • yes: 機能を有効にします。

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

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

lazyfree-lazy-expire

期限切れキーの lazyfree ベースの削除を有効にするかどうかを指定します。有効な値:

  • yes (デフォルト): 機能を有効にします。

  • no: 機能を無効にします。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

lazyfree-lazy-server-del

DEL コマンドが lazyfree に基づいてデータを非同期に削除するかどうかを指定します。有効な値:

  • yes (デフォルト): 機能を有効にします。

  • no: 機能を無効にします。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

lazyfree-lazy-user-del

DEL コマンドが lazyfree に基づいてデータを非同期に削除するかどうかを指定します。有効な値:

  • yes (デフォルト): 機能を有効にします。

  • no: 機能を無効にします。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

list-compress-depth

リストの両端にある非圧縮ノードの数です。有効値は [0-65535] です。

  • 0 (デフォルト): ノードは圧縮されません。

  • 1-65535: リストの各端にある指定された数のノードは圧縮されず、中央のノードは圧縮されます。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

  • list-max-ziplist-size

  • list-max-listpack-size

Redis 6.0 以前と互換性のあるインスタンスでは、リストのデフォルトコーデックは ziplist です (list-max-ziplist-size パラメーター)。Redis 7.0 以降と互換性のあるインスタンスでは、リストのデフォルトコーデックは listpack です (list-max-listpack-size パラメーター)。

  • 正の値は、各クイックリストノードの ziplist (または listpack) の長さをデータ項目の数で制限します。たとえば、このパラメーターを 5 に設定すると、各クイックリストノードの ziplist (または listpack) には最大 5 つのデータ項目を含めることができます。

  • 負の値は、各クイックリストノードの ziplist (または listpack) の長さを占有バイト数で制限します。有効な値:

    • -5: 各クイックリストノードの ziplist (または listpack) のサイズは 64 KB を超えることはできません。

    • -4: 各クイックリストノードの ziplist (または listpack) のサイズは 32 KB を超えることはできません。

    • -3: 各クイックリストノードの ziplist (または listpack) のサイズは 16 KB を超えることはできません。

    • -2 (デフォルト): 各クイックリストノードの ziplist (または listpack) のサイズは 8 KB を超えることはできません。

    • -1: 各クイックリストノードの ziplist (または listpack) のサイズは 4 KB を超えることはできません。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

maxmemory-policy

データエビクションポリシーです。インスタンスのメモリが不足し、使用量が Maxmemory に達すると、データエビクションがトリガーされます。さまざまなデータエビクションポリシーを選択できます。有効な値:

説明
  • 各インスタンスの Maxmemory はその仕様サイズであり、変更できません。たとえば、2 GB のインスタンスを購入した場合、その Maxmemory は 2 GB です。

  • クラスターアーキテクチャでは、単一のデータノードがその Maxmemory に達すると (合計メモリ使用量が制限に達していなくても)、そのデータノードはデータエビクションをトリガーします。データスキューを処理する必要があります。詳細については、「データスキューの処理方法」をご参照ください。

  • LRU は Least Recently Used (最近最も使用されていない) の略です。LFU は Least Frequently Used (最も使用頻度が低い) の略です。LRU、LFU、および volatile-ttl はすべて、近似ランダムアルゴリズムを使用して実装されています。

  • volatile-lru (メモリ最適化および Redis Open-Source Edition インスタンスのデフォルト): 有効期限 (Expire) が設定されたキーから、キーが期限切れかどうかに関係なく、最近最も使用されていない (LRU) キーを削除します。

  • noeviction (永続メモリインスタンスのデフォルト): キーを削除しません。メモリ制限に達すると、新しいデータを書き込むことができず、データベースはエラーメッセージを返します。

  • volatile-lfu: 有効期限 (Expire) が設定されたキーから、最も使用頻度が低い (LFU) キーを削除します。

  • volatile-random: 有効期限 (Expire) が設定されたキーから、いくつかのキーをランダムに削除します。

  • volatile-ttl: 有効期限 (Expire) が設定されたキーから、生存時間 (TTL) の昇順でソートされたキーを削除します。

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

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

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

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

notify-keyspace-events

notify-keyspace-events の値は、サーバーが送信すべき通知のタイプを指定する以下の文字の任意の組み合わせにすることができます。このパラメーターは、インスタンス全体 (すべての DB) の通知を有効にし、追加の CPU を消費します。詳細については、「Redis キースペース通知」をご参照ください。

  • K: キースペース通知。すべての通知には __keyspace@<db>__ というプレフィックスが付きます。

  • E: キーイベント通知。すべての通知には __keyevent@<db>__ というプレフィックスが付きます。

  • g: DELEXPIRERENAME などの、型に依存しない汎用コマンドの通知。

  • $: 文字列コマンドの通知。文字列の作成、変更、削除、その他の操作に関する通知を送信します。

  • l: リストコマンドの通知。

  • s: セットコマンドの通知。

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

  • z: ソートセットコマンドの通知。

  • x: 期限切れイベント。キーが期限切れになったときに必ずしも送信されるわけではなく、期限切れのキーが削除されたときに送信されます。

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

  • A: パラメーター g$lshzxe のエイリアスです。上記にリストされているすべてのイベントをリッスンすることを意味します。設定例は AKE です。

重要

入力パラメーターには、少なくとも K または E を含める必要があります。そうでない場合、通知はディスパッチされません。

たとえば、期限切れイベントをサブスクライブしたい場合は、パラメーター設定でこのパラメーターを Ex に設定できます。パラメーターを設定した後、クライアントで対応するサブスクリプションコマンドを実行します: PSUBSCRIBE __keyevent@0__*。これにより、DB0 のキーイベント通知がサブスクライブされます。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

pena_rename_move_compatible_enabled

MOVE および RENAME シリーズコマンドの互換モードを有効にするかどうかを指定します。これらのコマンドの時間計算量は O(n) であり、ネイティブ Redis の O(1) とは異なります。ターゲットオブジェクトが大きなキーの場合、操作に時間がかかります。有効な値:

  • no (デフォルト): モードを無効にします。

  • yes: モードを有効にします。関連するコマンドを実行できます。構文はネイティブ Redis と同じです。

説明

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

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

set-max-intset-entries

Set コレクション内のデータが次の条件を満たす場合、intset エンコーディングが使用されます。

  • コレクション内のすべてのデータは文字列オブジェクトです。

  • すべてが 64 ビット符号付き整数の範囲内の 10 進整数です。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

slowlog-log-slower-than

スロークエリログのしきい値です。実行時間がこのしきい値を超えるコマンドは、スロークエリログに記録されます。単位はマイクロ秒 (μs) です。有効値は [10000-10000000] です。デフォルトは 20000 (20 ミリ秒) です。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

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 で、接続は切断されないことを意味します。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

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

TairTS データ構造内のすべてのデータポイントが期限切れになったときに、Skey を自動的に削除するかどうかを指定します。有効な値:

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

  • No: 削除しません。

説明

このパラメーターは、Redis 6.0 以降と互換性があり、マイナーバージョンが 24.7.0.0 以降のメモリ最適化インスタンスでのみサポートされます。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

  • zset-max-ziplist-entries

  • zset-max-ziplist-value

Redis 6.0 以前と互換性のあるインスタンスでは、Zset のデフォルトコーデックとして ziplist が使用されます。Zset は、次の両方の条件が満たされた場合に ziplist エンコーディングを使用します。

  • Zset 内のキーと値のペアの数が zset-max-ziplist-entries の値未満である。

  • Zset のキーと値のペアのキーと値の両方の文字列長が zset-max-ziplist-value の値未満である。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

  • zset-max-listpack-entries

  • zset-max-listpack-value

Redis 7.0 以降と互換性のあるインスタンスでは、Zset のデフォルトコーデックとして listpack が使用されます。Zset は、次の両方の条件が満たされた場合に listpack エンコーディングを使用します。

  • Zset 内のキーと値のペアの数が zset-max-listpack-entries の値未満である。

  • Zset のキーと値のペアのキーと値の両方の文字列長が zset-max-listpack-value の値未満である。

bigkey-threshold

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

説明

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

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

bigkey-mem-threshold

Top Key Statistics の大きなキー (多くの要素を持つキー) のメモリサイズのしきい値です。デフォルトは 536870912 B です。有効値は [1048576 B-1073741824 B] です。

説明

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

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

hotkey-threshold

Top Key Statistics のホットキー (QPS 別) の統計しきい値です。デフォルトは 5000 です。有効値は [100-100000] です。

説明

このパラメーターは、クラウドネイティブメモリ最適化インスタンスでのみサポートされ、マイナーバージョンは次の要件を満たす必要があります。

  • Redis 5.0 と互換性あり: 5.5.0.50 以降。

  • Redis 6.0 および 7.0 と互換性あり: 25.2.0.0 以降。

標準️️✔️

クラスター✔️️️️️

読み書き分離✔️

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

パラメーター

説明

ディスクベース

#no_loose_disabled-commands

指定されたコマンドを無効にします。FLUSHALLFLUSHDBKEYSHGETALLEVALEVALSHASCRIPT などの高リスクコマンドまたは時間計算量の大きいコマンドを必要に応じて無効にできます。

説明
  • コマンドは小文字で入力してください。複数のコマンドはコンマ (,) で区切ります。

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

  • インスタンスのパフォーマンスを安定させるために、Tair (Redis OSS-compatible) では CONFIG などのコマンドを無効にすることはできません。詳細については、「無効にできないコマンド」をご参照ください。

標準✔️️

クラスター✔️️️️️

#no_loose_lua-strict-mode

Lua スクリプトの厳格モードを有効にするかどうかを指定します。有効にすると、標準アーキテクチャインスタンスは、クラスターアーキテクチャインスタンスと同様に、Lua スクリプト内のデータキーを KEYS 配列を介して渡す必要があり、スクリプト内で動的に生成することはできません。このモードを有効にすると、Lua スクリプトをマルチスレッド並列処理で高速化でき、パフォーマンスが数倍向上します。有効な値:

  • no (デフォルト): 厳格モードを無効にします。

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

標準✔️️

クラスター✔️️️️️

bigkey-threshold

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

説明

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

標準✔️

クラスター✔️️️️️

hotkey-threshold

Top Key Statistics のホットキー (QPS 別) の統計しきい値です。デフォルトは 5000 です。有効値は [100-100000] です。

説明

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

標準✔️

クラスター✔️️️️️

latency-monitor-threshold

レイテンシのしきい値です。このしきい値を超える期間のイベントは、レイテンシイベントとして記録されます。単位はミリ秒です。有効値は [0-10000000] です。デフォルトは 100 です。

標準✔️

クラスター✔️️️️️

max-rename-commit-size

RENAME コマンドで名前を変更するためにキーが保存できるデータの最大量です。単位はバイトです。有効値は [1024-268435456] です。デフォルトは 16777216 です。

実際のデータサイズがこのしきい値を超えると、操作は失敗します。

標準✔️

クラスター✔️️️️️

max-write-batch-size

コマンド実行中にディスクストレージ形式でメモリ内に生成されるデータのサイズ制限です。単位はバイトです。有効値は 0-1073741824 (1 GB) です。デフォルトは 0 で、上限なしを意味します。

説明

データ分布とリクエストが大きな中間データを生成する可能性がある場合は、メモリオーバーフローを防ぐためにこれを 1073741824 (1 GB) に設定することをお勧めします。

標準✔️

クラスター✔️️️️️

optimise-huge-value

大きな値のパフォーマンス最適化を有効にするかどうかを指定します。有効な値:

  • no (デフォルト): 最適化を無効にします。

  • yes: 最適化を有効にします。これにより、大きな値の書き込みパフォーマンスが 2 倍になりますが、範囲クエリ (SCANHGETALLZRANGE など) の効率が低下し、メモリ使用量の変動が増加します。

    大きな値 (平均 16 KB 超) で書き込み負荷が高いシナリオでのみ有効にすることをお勧めします。

説明

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

標準✔️

クラスター✔️️️️️

slowlog-log-slower-than

スロークエリログのしきい値です。実行時間がこのしきい値を超えるコマンドは、スロークエリログに記録されます。単位はマイクロ秒 (μs) です。有効値は [10000-10000000] です。デフォルトは 1000000 です。

標準✔️

クラスター✔️️️️️

slowlog-max-len

スロークエリログに保存できるレコードの最大数です。有効値は [100-10000] です。デフォルトは 1024 です。

標準✔️️

クラスター✔️️️️️

scan-background-interval-ms

インスタンスのバックグラウンドプロセスは、キーをアクティブにポーリングして TTL などの情報を判断し、GC を実行します。

  • scan-background-interval-ms: ポーリング間隔です。単位は ms です。デフォルトは 1000 (1s) です。

  • batch-scan-count: 毎回ポーリングされるキーの数です。デフォルトは 20000 で、デフォルトで 20,000 個のキーがクエリされることを意味します。

  • batch-scan-size: 毎回ポーリングされるデータの上限です。単位はバイトです。デフォルトは 2097152 で、デフォルトで 2 MB のデータがクエリされることを意味します。

説明
  • batch-scan-count または batch-scan-size のいずれかの条件が満たされると、ループは終了し、次のスキャンを待ちます。

  • バックグラウンド GC に対する要件が高い場合は、scan-background-interval-ms の値を適切に減らすことができます。ただし、ポーリング頻度を上げると、ディスク帯域幅もより多く消費されます。ユーザーリクエストに影響を与えないように、ポーリング頻度を大幅に上げることはお勧めしません。

標準✔️️

クラスター✔️️️️️

batch-scan-count

batch-scan-size

timeout

クライアントのアイドル時間が指定された秒数に達すると、インスタンスは接続を閉じます。単位は秒です。有効値は [0,100000] です。デフォルトは 0 で、接続は切断されないことを意味します。

標準✔️️

クラスター✔️️️️️

txn-isolation-lock

トランザクションロックを有効にするかどうかを指定します。有効にすると、ディスクベースのインスタンスは MULTI、EXEC、および Lua スクリプト関連のコマンドを実行できます。トランザクションロック機能により、パフォーマンスが 10% 低下する可能性があります。有効な値:

  • no (デフォルト): 設定を無効にします。

  • yes: トランザクションロックを有効にします。関連するコマンドを実行できます。構文はネイティブ Redis と同じです。

標準✔️️

クラスター✔️️️️️

プロキシノードパラメーター

以下のパラメーターはプロキシノードによって提供され、プロキシベースのクラスターインスタンスと読み書き分離インスタンスでのみサポートされます。

パラメーター

説明

cluster_compat_enable

ネイティブ Redis クラスター構文との互換性を有効にするかどうかを指定します。有効な値:

hello_enabled

HELLO コマンドを使用して RESP2 と RESP3 プロトコルを切り替えるためのスイッチです。有効な値:

  • 0 (デフォルト): スイッチを無効にします。

  • 1: スイッチを有効にします。有効にすると、HELLO コマンドを使用して RESP2 と RESP3 プロトコルを切り替えることができます。

説明

このパラメーターは、Proxy 7.0.9 以降でのみサポートされます。

max_session_processing

単一の接続でスタックできるリクエストの最大数です。有効値は [10-10000000] です。デフォルトは 1000 です。

プロキシノードがクライアントのリクエストをデータノードに転送したが、データノードから応答を受信しない場合、リクエストはスタック状態になります。このパラメーターは主に、プロキシノードのフロントエンドとバックエンドの処理能力の違いによって引き起こされるリクエストのスタックを制限し、メモリの増加を防ぐために使用されます。

  • #no_loose_statistics-ip-enable

  • #no_loose_statistics-cmds

  • #no_loose_statistics-keys

このパラメーターグループは、可観測性機能の一部です。設定後、監査ログを有効にして有効にする必要があります。統計期間は 5 秒に 1 回です。

  • #no_loose_statistics-ip-enable: IP アドレス統計を有効にするかどうかを指定します。これにより、確立された接続の IP アドレスが記録されます。有効な値は yes (有効) と no (デフォルト、無効) です。

  • #no_loose_statistics-cmds: 追跡するコマンドを指定します。これらのコマンドのソース IP アドレスと頻度を記録します。デフォルトは空で、追跡しないことを意味します。複数のコマンドはコンマ (,) で区切ります。

  • #no_loose_statistics-keys: 追跡するキーを指定します。これらのキーのソース IP アドレスと頻度を記録します。デフォルトは空で、追跡しないことを意味します。複数のキーはコンマ (,) で区切ります。

説明
  • このパラメーターグループは、メモリ最適化インスタンスでのみサポートされます。

  • パフォーマンスに影響を与えないように、#no_loose_statistics-cmds および #no_loose_statistics-keys パラメーターに多くの値を設定しないでください。トラブルシューティングまたは O&M の目的でのみ有効にしてください。

  • Simple Log Service コンソールから監査ログをダウンロードし (ダウンロード手順については、「監査ログのダウンロード」をご参照ください)、キーワードを使用して必要な情報をフィルタリングできます。

    • type value 7: IP アドレスの QPS 統計を示します。

    • type value 8: IP アドレスの接続統計を示します。

    • type value 9: キー統計を示します。

    • type value 10: コマンド統計を示します。

ptod_enabled

クライアントの IP アドレスをデータノードに渡すかどうかを指定します。有効な値:

  • 0: 渡しません。データノードにアクセスする IP アドレスはすべてプロキシノードの IP アドレスです。

  • 1 (デフォルト): 渡します。

query_cache_enabled

プロキシノードクエリキャッシュ機能です。有効にすると、プロキシノードはホットキーのリクエストとクエリ結果をキャッシュします。有効期間内に同じリクエストを受信した場合、プロキシノードはバックエンドのデータシャードと対話することなく、結果を直接クライアントに返します。

重要

プロキシノードにキャッシュされたホットキーのキーと値のペアは、有効期間中は更新されません。この機能を有効にする前に、ビジネスがキャッシュの有効期間内のデータの結果整合性を許容できることを確認してください。

  • query_cache_enabled: この機能を有効にするかどうかを指定します。有効な値は 0 (無効、デフォルト) と 1 (有効) です。

  • query_cache_expire: キャッシュされたデータの有効期間です。単位はミリ秒です。有効値は [100-60000] です。デフォルトは 1000 です。

    • キャッシュされたデータが有効期間中に変更された場合、変更はキャッシュに同期されません。つまり、同じ読み取りリクエストは、キャッシュが期限切れになるまでキャッシュからダーティデータを取得します。

    • 特定のビジネスシナリオとダーティデータに対する許容度に基づいて、このパラメーターの値を慎重に評価する必要があります。この値を低く設定しすぎるとキャッシュヒット率が低下し、高く設定しすぎるとクライアントがダーティデータを長期間読み取ることになります。

  • query_cache_mode: プロキシノードクエリキャッシュ機能の動作モードです。有効な値:

    • 0 (デフォルト): データシャードによってプッシュされたホットキーのみをキャッシュします。

    • 1: すべてのキーをキャッシュし、最近最も使用されていない (LRU) アルゴリズムに基づいてそれらをエビクションします。

      プロキシノードのキャッシュスペースは限られているため (スレッドあたり 100 MB)、このパラメーターを 1 に設定すると、プロキシノードは LRU アルゴリズムに従ってキーをエビクションします。これにより、キャッシュヒット率が低下し、全体的なパフォーマンスが低下する可能性があります。

query_cache_expire

query_cache_mode

readonly_lua_route_ronode_enable

読み取り専用レプリカの Lua 実行モードを有効または無効にします。有効な値:

  • 0 (デフォルト): Lua 実行モードを無効にします。読み取り専用レプリカは Lua をサポートしません。Lua コマンドはプライマリノードによって処理されます。

  • 1: Lua 実行モードを有効にします。読み取り操作を含む Lua スクリプトのみが処理のために読み取り専用レプリカに転送されます。

read_request_only_ronode_whenrwsplit_enable

読み取り専用アカウントからのリクエストの方向転送を有効または無効にします。有効な値:

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

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

rt_threshold_ms

プロキシノードのスロークエリログのしきい値です。単位はミリ秒 (ms) です。有効値は [30-2000] です。デフォルトは 500 です。

プロキシノードからデータノードにリクエストが送信されてから、プロキシノードが応答を受信するまでの時間がこのしきい値を超えると、スロークエリログエントリが生成されます。

script_check_enable

プロキシノードの Lua スクリプトのチェックを有効または無効にします。チェック項目の詳細については、「Lua スクリプトのプロキシチェック」をご参照ください。有効な値:

  • 0: チェックしません。Lua スクリプトを実行するインスタンスアカウントに読み取り専用権限がある場合でも、チェックは有効になります。

  • 1 (デフォルト): チェックします。

sentinel_compat_enable

Sentinel 互換モードを有効または無効にします。有効な値:

  • 0 (デフォルト): モードを無効にします。

  • 1: モードを有効にします。

transfer_subscrible_to_psubscrible_enable

SUBSCRIBEPSUBSCRIBE に変換する機能を有効または無効にします。有効な値:

  • 0 (デフォルト): 機能を無効にします。2 つは変換されません。

  • 1: 機能を有効にします。プロキシノードは、処理のために SUBSCRIBEPSUBSCRIBE に変換します。

    説明

    Lua スクリプトで PUB または SUB クラスのコマンドが使用されているために、サブスクライブされたチャンネルで通知を受信できない場合は、この機能を有効にできます。