Redis OSS 固有のパラメータ - Amazon MemoryDB

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Redis OSS 固有のパラメータ

Redis OSS クラスターのパラメータグループを指定しない場合、エンジンバージョンに適したデフォルトのパラメータグループが使用されます。デフォルトのパラメータグループのパラメータの値を変更することはできません。しかし、カスタムパラメータグループを作成し、いつでもクラスターに割り当てることはできます。ただし、条件付きで変更可能なパラメータの値が両方のパラメータグループで同じである場合に限ります。詳細については、「パラメータグループを作成する」を参照してください。

Redis OSS 7 パラメータの変更

注記

MemoryDB は、新しいイミュータブルなパラメータグループ default.memorydb-redis7.search.preview を含むベクトル検索のプレビューリリースを導入しました。このパラメータグループは、MemoryDB コンソールで、および create-cluster CLI コマンドを使用して新しい vector-search-enabled クラスターを作成するときに使用できます。プレビューリリースは、米国東部 (バージニア北部)、米国東部 (オハイオ)、米国西部 (オレゴン)、アジアパシフィック (東京)、欧州 (アイルランド) の各 AWS リージョンで利用できます。

パラメータグループファミリー: memorydb_redis7

Redis OSS 7 で追加されたパラメータは次のとおりです。

名前 詳細 説明
latency-tracking

許可される値: yesno

デフォルト: no

タイプ: 文字列

変更可能: はい

変更の適用: クラスター内のすべてのノードにわたって即時

[yes] に設定すると、コマンドごとのレイテンシーが追跡され、INFO レイテンシー統計コマンドを使用してパーセンタイル分布をエクスポートし、LATENCY コマンドを使用して累積レイテンシー分布 (ヒストグラム) をエクスポートできます。

hash-max-listpack-entries

許可される値: 0+

デフォルト: 512

タイプ: 整数

変更可能: はい

変更の適用: クラスター内のすべてのノードにわたって即時

データセットを圧縮するためのハッシュエントリの最大数。

hash-max-listpack-value

許可される値: 0+

デフォルト: 64

タイプ: 整数

変更可能: はい

変更の適用: クラスター内のすべてのノードにわたって即時

データセットを圧縮するための最大ハッシュエントリのしきい値。

zset-max-listpack-entries

許可される値: 0+

デフォルト: 128

タイプ: 整数

変更可能: はい

変更の適用: クラスター内のすべてのノードにわたって即時

データセットを圧縮するためにソートされたセットエントリの最大数。

zset-max-listpack-value

許可される値: 0+

デフォルト: 64

タイプ: 整数

変更可能: はい

変更の適用: クラスター内のすべてのノードにわたって即時

データセットを圧縮するためにソートされたセットエントリの最大しきい値。

search-enabled

許可される値: yes, no

デフォルト: no

タイプ: 文字列

変更可能: はい

変更は新しいクラスターに対してのみ有効になります。

最小エンジンバージョン: 7.1

「はい」に設定すると、検索機能が有効になります。

search-query-timeout-ms

許可される値: 1 - 60,000

デフォルト: 10,000

タイプ: 整数

変更可能: はい

変更の適用: クラスター内のすべてのノードにわたって即時

最小エンジンバージョン: 7.1

検索クエリの実行が許可されるミリ秒単位の最大時間。

Redis OSS 7 で変更されたパラメータは次のとおりです。

名前 詳細 説明
activerehashing

変更可能: no。Redis OSS 7 では、このパラメータはデフォルトで非表示になり、有効になっています。無効にするには、サポートケースを作成する必要があります。

変更可能は Yes でした。

Redis OSS 7 で削除されるパラメータは次のとおりです。

名前 詳細 説明
hash-max-ziplist-entries

許可される値: 0+

デフォルト: 512

タイプ: 整数

変更可能: はい

変更の適用: クラスター内のすべてのノードにわたって即時

小さなハッシュエンコーディングを表現するために listpackziplist の代わりに使用する

hash-max-ziplist-value

許可される値: 0+

デフォルト: 64

タイプ: 整数

変更可能: はい

変更の適用: クラスター内のすべてのノードにわたって即時

小さなハッシュエンコーディングを表現するために listpackziplist の代わりに使用する

zset-max-ziplist-entries

許可される値: 0+

デフォルト: 128

タイプ: 整数

変更可能: はい

変更の適用: クラスター内のすべてのノードにわたって即時

小さなハッシュエンコーディングを表現するために listpackziplist の代わりに使用します。

zset-max-ziplist-value

許可される値: 0+

デフォルト: 64

タイプ: 整数

変更可能: はい

変更の適用: クラスター内のすべてのノードにわたって即時

小さなハッシュエンコーディングを表現するために listpackziplist の代わりに使用します。

Redis OSS 6 パラメータ

注記

Redis OSS エンジンバージョン 6.2 では、 で使用する r6gd ノードファミリーが導入されたときデータ階層化noevictionvolatile-lruおよび allkeys-lru max-memory ポリシーのみが r6gd ノードタイプでサポートされます。

パラメータグループファミリー:memorydb_redis6

Redis OSS 6 で追加されたパラメータは次のとおりです。

名前 詳細 説明
maxmemory-policy

型: 文字列

許容値:volatile-lru、allkeys-lru、volatile-lfu、allkeys-lfu、volatile-random、allkeys-random、volatile-ttl、noeviction

デフォルト:エビクションなし

メモリの最大使用量に到達したときのキーの削除ポリシー。

詳細については、「Redis OSS を LRU キャッシュとして使用する Redis OSS を LRU キャッシュとして使用する」を参照してください。

list-compress-depth

型: INTEGER

許可される値: 0-

デフォルト: 0

圧縮の深さは、圧縮から除外するリストの端からのクイックリスト ziplist ノードの数です。リストの先頭と末尾は、プッシュおよびポップオペレーションを高速にするために常に圧縮されません。設定は以下のとおりです。
  • 0: すべての圧縮を無効にします。

  • 1: 先頭から末尾までの最初のノードで圧縮を開始します。

    先頭->ノード->ノード->...->ノード->末尾

    先頭 と 末尾 を除くすべてのノードで圧縮を実行します。

  • 2: 先頭から末尾までの 2 番目のノードで圧縮を開始します。

    先頭->次->ノード->ノード->...->ノード->前->末尾

    先頭、次、前、末尾 は圧縮されません。他のすべてのノードで圧縮を実行します。

  • その他

hll-sparse-max-bytes

型: 整数

許可される値: 1~16000

デフォルト: 3000

HyperLogLog スパース表現のバイト数制限。この制限には 16 バイトのヘッダーが含まれます。スパース表現 HyperLogLog を使用する がこの制限を超えると、高密度表現に変換されます。

16,000 より大きい値はお勧めしません。その時点では、デンスな表現の方がメモリ効率が高くなるためです。

PFADD の速度を下げすぎることなく領域効率の良いエンコードの利点を活かせる (スパースなエンコードで O(N) になる) ように、値は約 3,000 にすることをお勧めします。CPU が問題ではなく、スペースが で、データセットがカーディナリティが 0~15000 の範囲 HyperLogLogs の多くの で構成されている場合、値は ~10000 に引き上げることができます。

lfu-log-factor

型: INTEGER

許可される値: 1-

デフォルト: 10

LFU エビクションポリシーのキーカウンターをインクリメントするためのログファクター。

lfu-decay-time

型: 整数

許可される値: 0-

デフォルト: 1

LFU エビクションポリシーのキーカウンターをデクリメントする期間 (分単位)。

active-defrag-max-scan-fields

型: 整数

許可される値: 1~1000000

デフォルト: 1000

アクティブなデフラグメンテーション中にメインディクショナリスキャンから処理される set/hash/zset/list フィールドの最大数。

active-defrag-threshold-upper

型: 整数

許可される値: 1~100

デフォルト: 100

最大の労力を使用するフラグメントの最大割合。

client-output-buffer-limit-pubsub-hard-limit

型: 整数

許可される値: 0-

デフォルト: 33554432

Redis OSS パブリッシュ/サブスクライブクライアントの場合: クライアントの出力バッファが指定されたバイト数に達すると、クライアントは切断されます。

client-output-buffer-limit-pubsub-soft-limit

型: INTEGER

許可される値: 0-

デフォルト: 8388608

Redis OSS パブリッシュ/サブスクライブクライアントの場合: クライアントの出力バッファが指定されたバイト数に達すると、クライアントは切断されますが、この条件が に対して持続する場合に限ります。 client-output-buffer-limit-pubsub-soft-seconds.

client-output-buffer-limit-pubsub-soft-seconds

型: INTEGER

許可される値: 0-

デフォルト: 60

Redis OSS パブリッシュ/サブスクライブクライアントの場合: クライアントの出力バッファがこの秒数よりも長くclient-output-buffer-limit-pubsub-soft-limitバイト数のままの場合、クライアントは切断されます。

timeout

型: INTEGER

許可される値: 0,20-

デフォルト: 0

ノードがタイムアウトまで待機する秒数。値は次のとおりです。

  • 0 – アイドル状態のクライアントは切断しません。

  • 1-19 – 無効な値です。

  • >=20 – ノードがアイドル状態のクライアントを切断するまでに待機する秒数。

notify-keyspace-events

型: 文字列

許可される値: NULL

デフォルト: NULL

Redis OSS が Pub/Sub クライアントに通知するためのキースペースイベント。デフォルトではすべての通知は無効になっています。

maxmemory-samples

型: 整数

許可される値: 1-

デフォルト: 3

および least-recently-used (LRU)time-to-live (TTL)の計算では、このパラメータはチェックするキーのサンプルサイズを表します。デフォルトでは、Redis OSS は 3 つのキーを選択し、最近使用されたものを使用します。

slowlog-max-len

型: INTEGER

許可される値: 0-

デフォルト: 128

Redis OSS スローログの最大長。この長さには制限はありません。ただ、メモリを消費することになるので注意してください。スローログが使用していたメモリは、SLOWLOG RESET. のようにして再利用することができます。

activerehashing

型: 文字列

許可される値: はい,いいえ

デフォルト: はい

主要なハッシュテーブルは、1 秒あたり 10 回再ハッシュされます。再ハッシュ操作ごとに 1 ミリ秒の CPU が消費されます。

パラメータグループを作成するとき、この値を設定します。クラスターに新しいパラメータグループを割り当てるとき、この値は以前のパラメータグループと新しいパラメータグループで一致している必要があります。

client-output-buffer-limit-normal-hard-limit

型: 整数

許可される値: 0-

デフォルト: 0

クライアントの出力バッファーが指定されたバイト数に達した場合、クライアントの接続が切断されます。デフォルトは 0 です (ハード制限なし)。

client-output-buffer-limit-normal-soft-limit

型: 整数

許可される値: 0-

デフォルト: 0

クライアントの出力バッファーが指定されたバイト数に達した場合、クライアントの接続が切断されますが、この条件が client-output-buffer-limit-normal-soft-seconds の間存続した場合に限ります。デフォルトは 0 です (ソフト制限なし)。

client-output-buffer-limit-normal-soft-seconds

型: 整数

許可される値: 0-

デフォルト: 0

クライアントの出力バッファーが、この秒数より長い時間 client-output-buffer-limit-normal-soft-limit バイトのままの場合、クライアントの接続が切断されます。デフォルトは 0 です (時間制限なし)。

tcp-keepalive

型: 整数

許可される値: 0-

デフォルト: 300

0 以外の値 (N) に設定した場合、接続が維持されていることを確認するためにノードクライアントが N 秒ごとにポーリングされます。デフォルト設定の 0 では、このようなポーリングが行われません。

active-defrag-cycle-min

型: 整数

許可される値: 1~75

デフォルト: 5

デフラグの最小の労力 (CPU 使用率)。

stream-node-max-bytes

型: 整数

許可される値: 0-

デフォルト: 4096

ストリームデータ構造は、内部の複数のアイテムをエンコードするノードの基数ツリーです。基数ツリーの単一ノードの最大サイズをバイト単位で指定するには、この設定を使用します。0 に設定されている場合、ツリーノードのサイズは無制限です。

stream-node-max-entries

型: 整数

許可される値: 0-

デフォルト: 100

ストリームデータ構造は、内部の複数のアイテムをエンコードするノードの基数ツリーです。新しいストリームエントリを追加するとき、新しいノードに切り替える前に単一ノードに含めることができるアイテムの最大数を指定するには、この設定を使用します。0 に設定されている場合、ツリーノードのアイテムの数は無制限です。

lazyfree-lazy-eviction

型: 文字列

許可される値: はい,いいえ

デフォルト: いいえ

削除で、非同期削除を実行します。

active-defrag-ignore-bytes

型: 整数

許可される値: 1048576-

デフォルト: 104857600

アクティブなデフラグを開始するためのフラグメントの最小量。

lazyfree-lazy-expire

型: 文字列

許可される値: はい,いいえ

デフォルト: いいえ

期限切れのキーで、非同期削除を実行します。

active-defrag-threshold-lower

型: 整数

許可される値: 1~100

デフォルト: 10

アクティブなデフラグを開始するためのフラグメントの割合。

active-defrag-cycle-max

型: 整数

許可される値: 1~75

デフォルト: 75

デフラグの最大の労力 (CPU 使用率)。

lazyfree-lazy-server-del

型: 文字列

許可される値: はい,いいえ

デフォルト: いいえ

値を更新するコマンドに対して非同期削除を実行します。

slowlog-log-slower-than

型: 整数

許可される値: 0-

デフォルト: 10000

コマンドが Redis OSS Slow Log機能によってログに記録されるのにかかる最大実行時間をマイクロ秒単位で超えます。負の数値ではスローログは無効になり、値が 0 の場合はすべてのコマンドのロギングが強制されることに注意してください。

hash-max-ziplist-entries

型: 整数

許可される値: 0-

デフォルト: 512

ハッシュに使用されるメモリ量を決定します。エントリが指定された数より少ないハッシュは、領域を節約する特殊なエンコードを使用して格納されます。

hash-max-ziplist-value

型: 整数

許可される値: 0-

デフォルト: 64

ハッシュに使用されるメモリ量を決定します。エントリが指定されたバイト数より小さいハッシュは、領域を節約する特殊なエンコードを使用して格納されます。

set-max-intset-entries

型: 整数

許可される値: 0-

デフォルト: 512

特定のタイプのセットに使用されるメモリの量を決定します (64 ビット符号付き整数の範囲に収まる基数 10 の整数である文字列)。エントリが指定された数より少ないセットは、領域を節約する特殊なエンコードを使用して格納されます。

zset-max-ziplist-entries

型: 整数

許可される値: 0-

デフォルト: 128

ソート対象セットに使用されるメモリ量を決定します。要素が指定された数より少ないソート対象セットは、領域を節約する特殊なエンコードを使用して格納されます。

zset-max-ziplist-value

型: 整数

許可される値: 0-

デフォルト: 64

ソート対象セットに使用されるメモリ量を決定します。エントリが指定されたバイト数より小さいソート対象セットは、領域を節約する特殊なエンコードを使用して格納されます。

tracking-table-max-keys

型: 整数

許可される値: 1~100000000

デフォルト:1000000

クライアント側のキャッシュをサポートするために、Redis OSS はどのクライアントがどのキーにアクセスしたかの追跡をサポートします。

追跡されたキーが変更されると、無効化メッセージがすべてのクライアントに送信され、キャッシュされた値が無効になったことが通知されます。この値により、このテーブルの上限を指定できます。

acllog-max-len

型: 整数

許可される値: 1~10000

デフォルト: 128

ACL ログ内のエントリの最大数。

active-expire-effort

型: 整数

許可される値: 1~10

デフォルト: 1

Redis OSS は、2 つのメカニズムによって有効期限を超えたキーを削除します。1 つでは、キーがアクセスされ、期限切れであることが判明します。もう 1 つでは、定期的なジョブがキーをサンプリングし、有効期限 (TTL) を超えたキーを期限切れにします。このパラメータは、Redis OSS が定期的なジョブの項目を期限切れにするために使用する労力の量を定義します。

デフォルト値の 1 では、期限切れのキーの 10% 以上をメモリに残さないようにします。また、合計メモリの 25% 以上を消費しないようにし、システムにレイテンシーを追加しようとします。この値を最大 10 まで増やすと、キーの期限切れに費やす労力を増やすことができます。トレードオフは、CPU が高くなると、潜在的にレイテンシーが高くなることです。メモリ使用率が高く、CPU 使用率の増加が許容される場合を除き、値 1 を推奨します。

lazyfree-lazy-user-del

型: 文字列

許可される値: はい,いいえ

デフォルト: いいえ

DEL コマンドのデフォルト動作が UNLINK と同じ動作をするかどうかを指定します。

activedefrag

型: 文字列

許可される値: はい,いいえ

デフォルト: いいえ

有効化されているアクティブなメモリのデフラグメンテーション。

maxclients

型: INTEGER

許容される値: 65000

デフォルト: 65000

一度に接続できるクライアントの最大数。変更不可。

client-query-buffer-limit

型: INTEGER

許容される値: 1048576~1073741824

デフォルト: 1073741824

単一のクライアントクエリバッファの最大サイズ。変更は直ちに行われます。

proto-max-bulk-len

型: INTEGER

許容される値: 1048576~536870912

デフォルト: 536870912

1 つの要素リクエストの最大サイズ。変更は直ちに行われます。

MemoryDB ノードタイプ固有のパラメータ

ほとんどのパラメータの値は 1 つですが、一部のパラメータには、使用されているノードタイプによって複数の値が設定されることがあります。次の表は、各ノードタイプの maxmemory のデフォルト値を示しています。maxmemory の値は、ノードでデータやその他の用途に使用できる最大バイト数です。

ノードの種類 Maxmemory
db.r7g.large 14037181030
db.r7g.xlarge 28261849702
db.r7g.2xlarge 56711183565
db.r7g.4xlarge 113609865216
db.r7g.8xlarge 225000375228
db.r7g.12xlarge 341206346547
db.r7g.16xlarge 450000750456
db.r6gd.xlarge 28261849702
db.r6gd.2xlarge 56711183565
db.r6gd.4xlarge 113609865216
db.r6gd.8xlarge 225000375228
db.r6g.large 14037181030
db.r6g.xlarge 28261849702
db.r6g.2xlarge 56711183565
db.r6g.4xlarge 113609865216
db.r6g.8xlarge 225000375228
db.r6g.12xlarge 341206346547
db.r6g.16xlarge 450000750456
db.t4g.small 1471026299
db.t4g.medium 3317862236
注記

MemoryDB インスタンスタイプはすべて Amazon 仮想プライベートクラウド (VPC) に作成する必要があります。