Tair (Redis OSS-compatible) インスタンスのパラメーターをカスタマイズして、パフォーマンスとセキュリティを向上させることができます。サポートされるパラメーターは、エンジンバージョンとアーキテクチャによって異なります。このトピックでは、サポートされるパラメーターについて詳しく説明します。
注意事項
パラメーターを構成するときに
Parameter is not supported for current versionエラーが返された場合は、インスタンスのマイナーバージョンを更新してください。詳細については、「マイナーバージョンとプロキシバージョンをアップグレードする」をご参照ください。特定のパラメーターの変更を送信すると、インスタンスは自動的に再起動されます。再起動中、インスタンスで数秒間続く一時的な切断が発生します。パラメーターを変更するページで、[再起動して有効にする] 列は、変更を有効にするためにインスタンスを再起動する必要があるかどうかを示します。詳細については、「パラメーターの設定」をご参照ください。
このトピックでは、Redis コミュニティ版インスタンスのパラメーターについて説明します。メモリ最適化、永続メモリ、ディスクベースインスタンスを含む Tair (Enterprise Edition) インスタンスのパラメーターの詳細については、「Tair (Enterprise Edition) の構成パラメーター」をご参照ください。
サポートされるパラメーター
読みやすさと明確さのために、このトピックの表では次の規則が使用されています。
✔️: パラメーターはメジャーバージョンまたはアーキテクチャでサポートされています。
❌: パラメーターはメジャーバージョンまたはアーキテクチャでサポートされていません。
インスタンスの安定性を確保するために、一部のパラメーターのみを構成できます。このトピックに記載されていないパラメーターは構成できません。
アーキテクチャの詳細については、「標準アーキテクチャ」、「クラスターアーキテクチャ」、および「読み書き分離アーキテクチャ」をご参照ください。
データベースカーネルパラメーター
パラメーター | 説明 | インスタンスのメジャーバージョンとアーキテクチャ | ||||
バージョン 7.0 | バージョン 6.0 | バージョン 5.0 | バージョン 4.0 | バージョン 2.8 | ||
#no_loose_check-whitelist-always | VPC 経由のパスワードなしのアクセスを有効にした後、クライアント IP アドレスがインスタンスのホワイトリストにあるかどうかを確認するかどうかを指定します。有効な値:
説明
| ❌ | ❌ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ |
#no_loose_disabled-commands | 無効化されたコマンド。このパラメーターを使用して、FLUSHALL、FLUSHDB、KEYS、HGETALL、EVAL、EVALSHA、SCRIPT など、ビジネス要件に基づいてリスクが高い、または時間計算量が大きい可能性のあるコマンドを無効にできます。 説明
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ |
#no_loose_sentinel-enabled | 標準インスタンスまたは直接接続モードのクラスターインスタンスに対して Sentinel 互換モードを有効にするかどうかを指定します。有効な値:
| 標準 ✔️ クラスター ✔️ 読み書き分離 ❌ | 標準 ✔️ クラスター ✔️ 読み書き分離 ❌ | 標準 ✔️ クラスター ✔️ 読み書き分離 ❌ | 標準 ✔️ クラスター ✔️ 読み書き分離 ❌ | ❌ |
#no_loose_sentinel-password-free-access | Sentinel モードが有効な場合、Sentinel 関連コマンドのパスワードなしでの実行を許可するかどうかを指定します。有効な値:
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ | ❌ |
#no_loose_sentinel-password-free-commands | Sentinel モードと #no_loose_sentinel-password-free-access パラメーターを有効にした後、このパラメーターを使用して、追加のパスワードなしコマンドのリストを追加できます。デフォルト値は空です。 重要
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ | ❌ |
#no_loose_tls-min-version | インスタンスでサポートされる最小 TLS バージョンを設定します。有効な値:
| 標準 ❌ クラスター ✔️ 読み書き分離 ✔️ | 標準 ❌ クラスター ✔️ 読み書き分離 ✔️ | 標準 ❌ クラスター ✔️ 読み書き分離 ✔️ | 標準 ❌ クラスター ✔️ 読み書き分離 ✔️ | 標準 ❌ クラスター ✔️ 読み書き分離 ✔️ |
appendfsync | 追記専用ファイル (AOF) 永続化のために fsync 操作を実行する頻度。デフォルト値は everysec で、変更できません。このパラメーターは、appendonly パラメーターが yes に設定されている場合にのみ使用できます。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ |
appendonly | プライマリノードの AOF 永続化を有効または無効にします。有効な値:
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ |
| pubsub パラメーターは、publish/subscribe クライアントの出力バッファーを制限します。デフォルト値は 33554432 8388608 60 です。 normal パラメーターは、通常のクライアントの出力バッファーを制限します。デフォルト値は 524288000 0 0 です。 パラメーターのフォーマットは
重要
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ |
dynamic-hz | 動的 hz を有効または無効にします。有効な値:
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ |
| Redis 6.0 以前と互換性のあるインスタンスでは、ハッシュのデフォルトエンコーディングとして ziplist が使用されます。ハッシュオブジェクトは、次の両方の条件が満たされた場合に ziplist エンコーディングを使用します。
| ❌ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ |
| Redis 7.0 以降と互換性のあるインスタンスでは、ハッシュのデフォルトエンコーディングとして listpack が使用されます。ハッシュオブジェクトは、次の両方の条件が満たされた場合に listpack エンコーディングを使用します。
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ | ❌ | ❌ |
hz | 期限切れのキーをクリアするタスクなど、インスタンスのバックグラウンドタスクの実行頻度。有効値は [1-500] です。デフォルトは 10 で、1 秒あたり 10 回を意味します。 説明 値を大きくすると CPU リソースの消費量が増えますが、期限切れのキーが多い場合のクリア頻度も高くなります。また、インスタンスがタイムアウトをより正確に処理できるようになります。100 以下の値をお勧めします。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ |
latency-tracking | コマンドのレイテンシ監視を有効にするかどうかを指定します。有効な値:
説明 このパラメーターは、Redis 7.0 以降と互換性のあるインスタンスでのみサポートされます。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ | ❌ | ❌ |
lazyfree-lazy-eviction | lazyfree ベースのエビクションを有効にするかどうかを指定します。有効な値:
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ |
lazyfree-lazy-expire | lazyfree ベースの期限切れキーの削除を有効にするかどうかを指定します。有効な値:
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ |
lazyfree-lazy-server-del | DEL コマンドが lazyfree に基づいてデータを非同期に削除するかどうかを指定します。有効な値:
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ |
lazyfree-lazy-user-del | DEL コマンドの実行時に lazyfree に基づいてデータを非同期に削除するかどうかを指定します。有効な値:
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ | ❌ |
lazyfree-lazy-user-flush | FLUSHDB、FLUSHALL、SCRIPT FLUSH、および FUNCTION FLUSH コマンドを Lazyfree 非同期削除モードに自動的に変換するかどうかを指定します。有効な値:
説明 このパラメーターは、Redis 7.0 以降と互換性のあるインスタンスでのみサポートされます。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ | ❌ | ❌ |
list-compress-depth | リストの両端にある非圧縮ノードの数。有効値は [0-65535] です。
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ |
list-max-ziplist-entries | このパラメーターセットは、Redis 2.8 と互換性のあるインスタンスでのみサポートされます。List オブジェクトが次の両方の条件を満たす場合、ziplist エンコーディングが使用されます。
| ❌ | ❌ | ❌ | ❌ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ |
list-max-ziplist-value | ||||||
| Redis 6.0 以前と互換性のあるインスタンスでは、リストのデフォルトエンコーディングは ziplist です (list-max-ziplist-size パラメーター)。Redis 7.0 以降と互換性のあるインスタンスでは、リストのデフォルトエンコーディングは listpack です (list-max-listpack-size パラメーター)。
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ |
maxmemory-policy | データのエビクションポリシー。インスタンスのメモリが不足し、使用量が Maxmemory に達すると、データのエビクションがトリガーされます。さまざまなデータのエビクションポリシーを選択できます。有効な値: 説明
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ |
maxmemory-eviction-tenacity | 各データのエビクションの遅延を設定するために使用されるデータのエビクション係数。値の範囲は 0 から 100 です。デフォルト値は 10 です。
説明 このパラメーターは Redis 7.0 でのみサポートされます。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ | ❌ | ❌ |
active-expire-effort | 期限切れキー (Expire) の削除係数。期限切れキーの各削除の遅延を設定するために使用されます。値の範囲は 1 から 10 です。デフォルト値は 1 です。値を大きくすると、期限切れキーの削除が速くなりますが、CPU リソースの消費量も増えます。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ | ❌ |
notify-keyspace-events | サーバーがクライアントに通知できるイベントのタイプ。このパラメーターの値は、次の文字の組み合わせです。このパラメーター設定は、インスタンス内のすべてのデータベースに適用されます。これらの通知は CPU リソースを消費します。詳細については、「Redis キースペース通知」をご参照ください。
重要 指定された値には、少なくとも K または E を含める必要があります。そうでない場合、通知は送信されません。 たとえば、期限切れイベントの通知を受けたい場合は、このパラメーターを | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ |
set-max-intset-entries | Set コレクション内のデータが次の条件を満たす場合、intset エンコーディングが使用されます。
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ |
slowlog-log-slower-than | スロークエリログのしきい値。実行時間がこのしきい値を超えたコマンドは、スロークエリログに記録されます。単位: マイクロ秒 (μs)。デフォルト値は 20000 (20 ms) です。値の範囲は 10000 から 10000000 です。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ |
slowlog-max-len | スロークエリログに保存できるレコードの最大数。値の範囲は 100 から 10000 です。デフォルト値は 1024 です。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ |
stream-node-max-bytes | Stream 内の各マクロノードが占有できる最大メモリ。値の範囲は 0 から 999,999,999,999,999 です。 説明 値 0 は制限なしを示します。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ |
stream-node-max-entries | Stream 内の各マクロノードに保存できるエントリの最大数。値の範囲は 0 から 999,999,999,999,999 です。 説明 値 0 は制限なしを示します。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ |
tracking-table-max-keys | Tracking Table に保存されるキーの数の上限を設定します。値の範囲は 0 から 1000000000 です。デフォルト値は 1000000 です。 説明 このパラメーターは Redis 7.0 でのみサポートされます。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ | ❌ | ❌ |
timeout | クライアントのアイドル時間が指定された秒数に達すると、インスタンスは接続を閉じます。単位は秒です。有効値は [0,100000] です。デフォルトは 0 で、接続が切断されないことを意味します。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ |
| Redis 6.0 以前と互換性のあるインスタンスでは、Zset のデフォルトエンコーディングとして ziplist が使用されます。Zset は、次の両方の条件が満たされた場合に ziplist エンコーディングを使用します。
| ❌ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ |
| Redis 7.0 以降と互換性のあるインスタンスでは、Zset のデフォルトエンコーディングとして listpack が使用されます。Zset は、次の両方の条件が満たされた場合に listpack エンコーディングを使用します。
| 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ | ❌ | ❌ |
bigkey-threshold | トップキー統計における large キー (多くの要素を持つキー) の要素数のしきい値。デフォルト値は 2000 です。値の範囲は 500 から 100000 です。 説明 このパラメーターがパラメーター設定に表示されない場合は、マイナーバージョンを更新して再試行してください。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ |
| トップキー統計におけるホットキー (QPS 別) の統計しきい値。デフォルトは 5000 です。有効値は [100-100000] です。 説明 このパラメーターは、マイナーバージョン 7.0.18、6.0.2.9、5.5.2.9 以降でのみサポートされます。 | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | 標準 ✔️ クラスター ✔️ 読み書き分離 ✔️ | ❌ | ❌ |
プロキシノードパラメーター
次のパラメーターはプロキシノードによって提供されます。これらのパラメーターは、プロキシモードのクラスターアーキテクチャまたは読み書き分離アーキテクチャを使用するインスタンスでのみサポートされます。
パラメーター | 説明 |
cluster_compat_enable | ネイティブ Redis クラスター構文との互換性を有効にするかどうかを指定します。有効な値:
|
hello_enabled | HELLO コマンドを使用して RESP2 プロトコルと RESP3 プロトコルを切り替えるためのスイッチ。有効な値:
説明 このパラメーターは、Proxy 7.0.9 以降でのみサポートされます。 |
max_session_processing | 単一の接続でスタックできるリクエストの最大数。有効値は [10-10000000] です。デフォルトは 1000 です。 プロキシノードがクライアントのリクエストをデータノードに転送したが、データノードから応答を受信しない場合、リクエストはスタック状態になります。このパラメーターは主に、プロキシノードのフロントエンドとバックエンドの処理能力の違いによって引き起こされるリクエストのスタックを制限し、メモリの増加を防ぐために使用されます。 |
| このパラメーターグループは、可観測性機能の一部です。これらのパラメーターを設定した後、監査ログ機能を有効にして有効にする必要があります。統計期間は、コレクションごとに 5 秒です。
説明
|
ptod_enabled | クライアントの IP アドレスをデータノードにパススルーするかどうかを指定します。有効な値:
|
readonly_lua_route_ronode_enable | 読み取り専用レプリカの Lua 実行モードを有効または無効にします。有効な値:
|
read_request_only_ronode_whenrwsplit_enable | 読み取り専用アカウントからのリクエストの方向転送を有効または無効にします。有効な値:
|
rt_threshold_ms | プロキシノードのスローログのしきい値。単位はミリ秒 (ms) です。有効値は [30-2000] です。デフォルトは 500 です。 リクエストがプロキシノードからデータノードに送信されてから、プロキシノードが応答を受信するまでの時間がこのしきい値を超えると、スローログエントリが生成されます。 |
script_check_enable | Lua スクリプトに対するプロキシノードのチェックを有効または無効にします。チェック項目の詳細については、「Lua スクリプトのプロキシチェック」をご参照ください。有効な値:
|
sentinel_compat_enable | プロキシモードのクラスターインスタンスまたは読み書き分離インスタンスに対して Sentinel 互換モードを有効にするかどうかを指定します。有効な値:
|
transfer_subscrible_to_psubscrible_enable | SUBSCRIBE を PSUBSCRIBE に変換する機能を有効または無効にします。有効な値:
|