Tair (Enterprise Edition) では、サポートされているパラメータを調整することで、インスタンスの動作をチューニングできます。このトピックでは、メモリ最適化、永続メモリ、およびディスクベースの各インスタンスで設定可能なすべてのパラメータを一覧で示します。
Redis オープンソース版インスタンスのパラメータについては、「サポートされている Redis パラメータ」をご参照ください。
注意事項
このトピックに記載されているパラメータのみ設定できます。パラメータの設定方法については、パラメータの設定をご参照ください。
パラメーターによっては、変更を適用するとインスタンスが自動的に再起動されます。再起動の際、インスタンスへの接続が数秒間切断されることがあります。変更を適用する前に、[再起動時に有効] 列をご確認ください。
パラメータの設定時に
Parameter is not supported for current versionエラーが表示された場合は、マイナーバージョンをアップグレードしてから再試行してください。サポートされるパラメータは、エンジンバージョンとアーキテクチャによって異なります。アーキテクチャの詳細については、アーキテクチャ情報のクエリをご参照ください。
表の規約
このトピックの表では、次の記号を使用します。
チェックマーク:対応
X マーク:非対応
メモリ最適化インスタンスと永続メモリインスタンス
パラメータ | 説明 | メモリ最適化 | 永続メモリ | [再起動後に有効] |
| VPC のパスワードレスアクセスを有効にした後、インスタンスがクライアント IP アドレスをホワイトリストと照合するかどうかを制御します。 デフォルト値:
説明 このパラメータは、クラシックアーキテクチャを使用するインスタンスでのみサポートされます。クラウドネイティブアーキテクチャのインスタンスは、パスワードなしのアクセスが有効になっているかどうかにかかわらず、常に IP ホワイトリストを強制します。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
| 無効にするコマンドを指定します。FLUSHALL、FLUSHDB、KEYS、HGETALL、EVAL、EVALSHA、SCRIPT などの高リスクまたは高レイテンシーのコマンドをブロックするために使用します。
| Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| ホットキー (アクセス頻度の高いキー) を監視するためのパラメーターグループです。この機能を有効にすると、検出されたホットキーをで表示できます。 重要 この機能を有効にすると、キーの数に比例して CPU 使用率が 5% 以上増加する場合があります。必要な場合にのみ有効にしてください。
説明 マイナーバージョンが 25.2.0.0 以降のクラウドネイティブメモリ最適化インスタンスでのみサポートされます。ハッシュタグとプレフィックスの解析には、マイナーバージョン 25.9.1.0 以降が必要です。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
| Lua スクリプトの厳格モードを有効にします。有効にすると、標準アーキテクチャインスタンスはクラスターアーキテクチャインスタンスのように動作します。Lua スクリプト内のデータキーは
説明 Redis 6.0 以降に対応するメモリ最適化インスタンスでのみサポートされます。 | Standard: 対応 Cluster: 非対応 Read/write splitting: 非対応 | 非対応 | いいえ |
| インスタンスが Maxmemory の上限に達する前にバックグラウンドエビクションを開始するメモリ使用率を設定します。これにより、コマンドのパフォーマンスに影響を与えることなく、早期エビクションが可能になります。有効な値: 50~100。 デフォルト: 削除ポリシーは、引き続き 説明 Redis 6.0 以降に対応し、マイナーバージョンが 25.2.0.0 以降のメモリ最適化インスタンスでのみサポートされます。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
| サブスクライバー数を待たずに PUBLISH コマンドのスループットを向上させます。有効にすると、PUBLISH は常に 説明 Redis 6.0 以降に対応するメモリ最適化インスタンスでのみサポートされます。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
| インスタンスへのアクセスを制御するための QPS スロットリングのパラメーターグループです。有効にすると、インスタンスへのリクエスト数が設定されたしきい値に達した場合、インスタンスは新しいリクエストを拒否し、
説明
| Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
| インスタンスの Sentinel 互換モードを有効にします。デフォルト:
| Standard: 対応 Cluster: 対応 Read/write splitting: 非対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 非対応 | いいえ |
| Sentinel モードが有効な場合、このパラメーターは、任意の接続でパスワードなしで Sentinel コマンドを実行できるかどうかを制御します。デフォルト値は
| Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| Sentinel モードが有効であり、 重要 ここで設定されたコマンドは、どの接続でも認証なしで実行できます。コマンドは小文字で入力し、カンマで区切ります。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| 低速クエリコマンドを分離されたスレッドにルーティングするしきい値 (キー内のサブメンバー数) を設定し、通常のコマンド用にメインスレッドを解放します。対象となるコマンドは、KEYS、SMEMBERS、HKEYS、HVALS、HGETALL、EXHKEYS、EXHVALS、および EXHGETALL です。KEYS コマンドの場合、しきい値は現在の DB のキー数に適用されます。有効な値: 1 ~ 999999999999999。デフォルト: 例えば、あるセットに 1,000 を超えるメンバーがある場合、そのキーに対する SMEMBERS は分離スレッドを使用します。分離スレッドの保留キューが 500 リクエストを超えると、後続のコマンドは通常のスレッドにフォールバックします。 説明 このしきい値を低く設定しすぎないようにしてください。隔離スレッドに過度の圧力がかかると、リソースが浪費されます。ほとんどのリクエストがスロークエリコマンドである場合は、このパラメーターを | Standard: 対応 Direct connection cluster: 対応 Proxy cluster: 非対応 Read/write splitting: 非対応 | 非対応 | いいえ |
| プライマリノードとセカンダリノード間の同期モードです。有効な値:
説明 Redis 6.0 以降に対応し、マイナーバージョンが 23.12.2.0 以降のメモリ最適化インスタンスでのみサポートされます。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
| このパラメーターを調整する前に、まず半同期モードを有効にする必要があります ( このパラメータは、準同期モードのタイムアウトを設定します。書き込みリクエストがプライマリ/セカンダリ間の同期を待機する時間がこのしきい値を超えた場合、リクエストはまだセカンダリノードにレプリケートされていなくても、直ちにクライアントに返されます。単位:ミリ秒。有効な値:1~7200000。デフォルト:100。 説明 Redis 6.0 以降に対応し、マイナーバージョンが 23.12.2.0 以降のメモリ最適化インスタンスでのみサポートされます。変更は慎重に行ってください。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
| インスタンスが受け入れる最小 TLS バージョンを設定します。デフォルト: 有効な値: | Standard: 非対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
| TairTS データ構造で、Skey のすべてのデータポイントが期限切れになったときに、その Skey を自動的に削除するかどうかを制御します。デフォルト:
説明 Redis 6.0 以降に対応し、マイナーバージョンが 24.7.0.0 以降のメモリ最適化インスタンスでのみサポートされます。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| インスタンスがバックグラウンドで期限切れのキーをどの程度積極的にクリーンアップするかを制御します。値を大きくすると、期限切れキーが使用するメモリをより速く削減しますが、CPU 使用率とレイテンシは増加します。有効な値: 1 ~ 10。デフォルト: 説明 永続メモリインスタンスでのみサポートされます。 | 非対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| 追加専用ファイル (AOF) 永続化の fsync 頻度。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| プライマリノードの AOF 永続化を有効または無効にします。デフォルト:
説明 Redis データベース (RDB) 永続化は、デフォルトで 1 日に 1 回実行されます。詳細については、「自動または手動バックアップ」をご参照ください。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | はい |
| Top Key Statistics において大規模キー (多くの要素を持つキー) を特定するための要素数のしきい値。有効値: 500 ~ 100000。デフォルト: 説明 このパラメータがパラメータ設定に表示されない場合は、マイナーバージョンをアップグレードして再試行してください。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
| トップキー統計における、大きなキー (大量のメモリを消費するキー) を識別するためのメモリサイズのしきい値。単位: バイト。有効な値: 1048576~1073741824 (1 MB~1 GB)。デフォルト: 説明 マイナーバージョンが 25.6.0.0 以降のクラウドネイティブメモリ最適化インスタンスでのみサポートされます。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
| Top Key Statistics で大規模キー (大量のメモリを消費するキー) を識別するための、サブ要素あたりの平均メモリサイズしきい値。単位: バイト。有効値: 1024~1073741824 (1 KB~1 GB)。デフォルト: 説明
| Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
| pub/sub クライアントと通常のクライアントの出力バッファを制限します。 書式:
クライアントの出力バッファがハードリミットに達すると、接続は直ちに閉じられます。バッファがソフトリミットに達し、指定された秒数間その状態が続くと、接続は閉じられます。 重要
| Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| バックグラウンドタスクの実行頻度を動的に調整できます。デフォルト:
| Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| TairVector グローバルインデックスを有効または無効にします。デフォルト:
| Standard: 非対応 Cluster: 対応 Read/write splitting: 非対応 | 非対応 | いいえ |
| Redis 6.0 以前に対応したインスタンスでは、キーと値のペアの数が | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| Redis 7.0 以降に対応したインスタンスでは、キーと値のペアの数が | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
| トップキー統計におけるホットキー識別のための QPS しきい値。 有効な値: 100 ~ 100000。 デフォルト: 説明 クラウドネイティブメモリ最適化インスタンスでのみサポートされます。必要なマイナーバージョンは次のとおりです。
| Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
| インスタンスが、期限切れキーのクリーンアップなどのバックグラウンドタスクを毎秒実行する回数を設定します。有効値: 1 ~ 500。デフォルト: 値が高いほどキーのクリーンアップが頻繁になり、タイムアウト処理がより正確になりますが、CPU 使用率も増加します。100 を超える値は避けてください。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| エビクションで非同期 (lazyfree) 削除を使用するかどうかを制御します。デフォルト:
| Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| 有効期限が切れたキーを非同期 (lazyfree) で削除するかどうかを設定します。デフォルト:
| Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| DEL コマンドが非同期 (lazyfree) 削除を使用するかどうかを制御します。デフォルト:
| Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| ユーザーによってトリガーされた DEL コマンドが非同期 (lazyfree) 削除を使用するかどうかを制御します。デフォルト:
| 非対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| リストの両端で圧縮せずに保持するノード数を設定します。 中間のノードは圧縮されます。 有効な値: 0~65535。 デフォルト: | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| 各 quicklist ノード上の ziplist (Redis 6.0 以前) または listpack (Redis 7.0 以降) のサイズまたは長さを制御します。
| Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| インスタンスが Maxmemory の上限に達したときに適用される追い出しポリシーです。デフォルト値は、メモリ最適化インスタンスでは 注意事項:
利用可能なポリシー:
| Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| インスタンスが送信するキー空間イベント通知を設定します。これを有効にすると、追加の CPU リソースが消費されます。詳細については、「Redis のキー空間通知」をご参照ください。 重要 値には、 以下の文字の任意の組み合わせを使用します。
例: 有効期限イベントを受信するには、このパラメーターを | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| MOVE および RENAME シリーズのコマンドの互換モードを有効にします。ネイティブの Redis (O(1) の計算量) とは異なり、これらのコマンドは Tair では O(n) の計算量になります。そのため、大きなキーに対する操作にはかなりの時間がかかる可能性があります。デフォルト:
説明 バージョン 1.2.4 以降の永続メモリインスタンスでのみサポートされます。 | 非対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| intset エンコーディングを使用するセットの最大サイズを設定します。セットのすべてのメンバーが 64 ビット符号付き整数の範囲内の 10 進整数である場合、セットは intset エンコーディングを使用します。 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| スロークエリログにコマンドを記録するための実行時間しきい値です。この値よりも実行時間が長いコマンドがログに記録されます。単位: マイクロ秒。有効な値: 10000~10000000。デフォルト: | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| スロークエリログが保持するエントリの最大数。有効値:100~10000。デフォルト: | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| Stream 内の単一のマクロノードが消費できる最大メモリ量。 単位: バイト。 有効値: 0 ~ 999999999999999。 デフォルト: | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| Stream 内の単一のマクロノードが保存できる最大エントリ数。 有効値: 0 ~ 999999999999999。 デフォルト: | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| インスタンスがクライアント接続をクローズするまでのアイドル秒数。有効値: 0~100000。デフォルト: | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| Redis 6.0 以前と互換性のあるインスタンスでは、キーと値のペアの数が | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | いいえ |
| Redis 7.0 以降に対応したインスタンスでは、キーと値のペアの数が | Standard: 対応 Cluster: 対応 Read/write splitting: 対応 | 非対応 | いいえ |
ディスクベースのインスタンス
パラメータ | 説明 | ディスクベース | [再起動時に有効] |
| 無効にするコマンドを指定します。FLUSHALL、FLUSHDB、KEYS、HGETALL、EVAL、EVALSHA、SCRIPT など、高リスクまたは高レイテンシーのコマンドをブロックするために使用します。
| スタンダード:対応 クラスター:対応 | いいえ |
| Lua スクリプトの strict モードを有効にします。データキーは
| スタンダード:対応 クラスター:対応 | いいえ |
| TTL チェックとガベージコレクションを実行するバックグラウンドキーポーリングプロセスのパラメータ。
ポーリングループは、 説明
| スタンダード:対応 クラスター:対応 | いいえ |
| Top Key 統計でラージキー (多数の要素を持つキー) を識別するための要素数のしきい値。有効な値:500 ~ 100000。デフォルト: 説明 バージョン 2.6.0 以降のディスクベースのインスタンスでのみサポートされます。 | スタンダード:対応 クラスター:対応 | いいえ |
| Top Key 統計でホットキーを識別するための QPS しきい値。有効な値:100 ~ 100000。デフォルト: 説明 バージョン 2.6.0 以降のディスクベースのインスタンスでのみサポートされます。 | スタンダード:対応 クラスター:対応 | いいえ |
| レイテンシーイベントを記録するための時間しきい値。このしきい値を超えるイベントがログに記録されます。単位:ミリ秒。有効な値:0 ~ 10000000。デフォルト: | スタンダード:対応 クラスター:対応 | いいえ |
|
| スタンダード:対応 クラスター:対応 | いいえ |
| ディスクストレージ形式でのコマンド実行中に生成される中間インメモリデータのサイズ制限 (バイト単位)。有効な値:0 ~ 1073741824。デフォルト: 説明 ワークロードで大量の中間データが生成される可能性がある場合は、メモリ不足の問題を防ぐために、これを | スタンダード:対応 クラスター:対応 | いいえ |
| 大きな値のパフォーマンス最適化を有効にします。デフォルト:
説明 バージョン 2.6.0 以降のディスクベース SSD インスタンスでのみサポートされます。 | スタンダード:対応 クラスター:対応 | いいえ |
| コマンドをスロークエリログに記録するための実行時間のしきい値。単位:マイクロ秒。有効な値:10000 ~ 10000000。デフォルト: | スタンダード:対応 クラスター:対応 | いいえ |
| スロークエリログが保持するエントリの最大数。有効な値:100 ~ 10000。デフォルト: | スタンダード:対応 クラスター:対応 | いいえ |
| インスタンスがクライアント接続を閉じるまでのアイドル時間 (秒)。有効な値:0 ~ 100000。デフォルト: | スタンダード:対応 クラスター:対応 | いいえ |
| 異常リクエスト再試行機能のスイッチ。有効な値:
| スタンダード:非対応 クラスター:対応 読み書き分離:非対応 | いいえ |
| リクエストの再試行をトリガーするタイムアウト期間。このパラメータは | スタンダード:非対応 クラスター:対応 読み書き分離:非対応 | いいえ |
| トランザクションロックを有効にします。これにより、ディスクベースのインスタンスで MULTI、EXEC、および Lua スクリプトコマンドを実行できます。このパラメーターを有効にすると、最大 10% パフォーマンスが低下する可能性があります。デフォルト:
| スタンダード:対応 クラスター:対応 | いいえ |
プロキシノードのパラメーター
これらのパラメーターはプロキシノードから提供され、プロキシモードのクラスターアーキテクチャまたは読み書き分離アーキテクチャを使用するインスタンスにのみ適用されます。
パラメーター | 説明 | [再起動後に有効になります] |
| ネイティブ Redis クラスター構文との互換性を制御します。デフォルト:
| いいえ |
| HELLO コマンドが RESP2 プロトコルと RESP3 プロトコルを切り替えられるかどうかを制御します。デフォルト:
説明 Proxy バージョン 7.0.9 以降でのみサポートされます。 | いいえ |
| 接続ごとのインフライトリクエストの最大数。有効な値:10~10000000。デフォルト: プロキシノードがリクエストをデータノードに転送したものの、まだ応答を受信していない場合、そのリクエストをインフライトと見なします。このパラメーターは、プロキシのフロントエンドとバックエンドの処理速度の違いによって引き起こされるリクエストの蓄積を制限し、過剰なメモリ増加を防ぎます。 | いいえ |
| 可観測性機能のための一連のパラメーターです。これらのパラメーターを設定した後、有効にするには監査ログも有効にする必要があります。統計は 5 秒間隔で収集します。
説明
統計情報を取得するには、Simple Log Service コンソールから監査ログをダウンロードし (「監査ログのダウンロード」をご参照ください)、次の
| いいえ |
| プロキシがクライアントの元の IP アドレスをデータノードにパススルーするかどうかを制御します。デフォルト:
| いいえ |
| プロキシノードのクエリキャッシュ機能のパラメーターです。有効にすると、プロキシはホットキーの結果をキャッシュし、リクエストをデータシャードに転送せずにキャッシュされた応答を直接返します。 重要 キャッシュされたキーと値のデータは、キャッシュの有効期間中は更新されません。この機能を有効にする前に、ワークロードが結果整合性を許容できることを確認してください。
| いいえ |
| 読み取り専用アカウントからのリクエストをリードレプリカにのみ転送するかどうかを制御します。デフォルト:
| いいえ |
| リードレプリカでの Lua 実行モードを制御します。デフォルト:
| いいえ |
| プロキシノードのスロークエリログのしきい値。プロキシがリクエストを送信してから応答を受信するまでの時間がこの値を超えると、ログエントリを生成します。単位:ミリ秒。有効な値:30~2000。デフォルト: | いいえ |
| プロキシが実行前に Lua スクリプトをチェックするかどうかを制御します。チェック項目のリストについては、「Lua のプロキシチェック項目」をご参照ください。デフォルト:
| いいえ |
| プロキシの Sentinel 互換モードを有効にします。デフォルト:
| いいえ |
| プロキシが SUBSCRIBE コマンドを PSUBSCRIBE に変換するかどうかを制御します。デフォルト:
| いいえ |