エンジン固有のパラメータ - Amazon MemoryDB

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

エンジン固有のパラメータ

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

Valkey 7 および Redis 7 OSS パラメータの変更

注記

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

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

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

名前 詳細 説明
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 7 OSS で変更されたパラメータは次のとおりです。

名前 詳細 説明
activerehashing

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

変更可能は Yes でした。

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

名前 詳細 説明
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 6 OSS パラメータ

注記

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

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

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

名前 詳細 説明
maxmemory-policy

タイプ: STRING

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

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

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

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

list-compress-depth

タイプ: INTEGER

許可される値: 0-

デフォルト: 0

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

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

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

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

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

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

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

  • その他

hll-sparse-max-bytes

タイプ: INTEGER

許可される値: 1~16000

デフォルト: 3000

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

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

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

lfu-log-factor

タイプ: INTEGER

許可される値: 1-

デフォルト: 10

LFU エビクションポリシーのキーカウンターを増分するためのログ係数。

lfu-decay-time

タイプ: INTEGER

許可される値: 0-

デフォルト: 1

LFU 立ち退きポリシーのキーカウンターを減じる分単位の時間。

active-defrag-max-scan-fields

タイプ: INTEGER

許可される値: 1~1000000

デフォルト: 1000

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

active-defrag-threshold-upper

タイプ: INTEGER

許可される値: 1~100

デフォルト: 100

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

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

タイプ: INTEGER

許可される値: 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

タイプ: STRING

許可される値: NULL

デフォルト: NULL

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

maxmemory-samples

タイプ: INTEGER

許可される値: 1-

デフォルト: 3

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

slowlog-max-len

タイプ: INTEGER

許可される値: 0-

デフォルト: 128

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

activerehashing

タイプ: STRING

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

デフォルト: はい

メインハッシュテーブルは 1 秒あたり 10 回リハッシュされます。各リハッシュオペレーションには 1 ミリ秒のCPU時間がかかります。

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

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

タイプ: INTEGER

許可される値: 0-

デフォルト: 0

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

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

タイプ: INTEGER

許可される値: 0-

デフォルト: 0

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

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

タイプ: INTEGER

許可される値: 0-

デフォルト: 0

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

tcp-keepalive

タイプ: INTEGER

許可される値: 0-

デフォルト: 300

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

active-defrag-cycle-min

タイプ: INTEGER

許可される値: 1~75

デフォルト: 5

デフラグの最小労力をCPUパーセンテージで表します。

stream-node-max-bytes

タイプ: INTEGER

許可される値: 0-

デフォルト: 4096

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

stream-node-max-entries

タイプ: INTEGER

許可される値: 0-

デフォルト: 100

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

lazyfree-lazy-eviction

タイプ: STRING

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

デフォルト: いいえ

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

active-defrag-ignore-bytes

タイプ: INTEGER

許可される値: 1048576-

デフォルト: 104857600

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

lazyfree-lazy-expire

タイプ: STRING

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

デフォルト: いいえ

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

active-defrag-threshold-lower

タイプ: INTEGER

許可される値: 1~100

デフォルト: 10

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

active-defrag-cycle-max

タイプ: INTEGER

許可される値: 1~75

デフォルト: 75

デフラグの最大労力CPUの割合。

lazyfree-lazy-server-del

タイプ: STRING

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

デフォルト: いいえ

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

slowlog-log-slower-than

タイプ: INTEGER

許可される値: 0-

デフォルト: 10000

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

hash-max-ziplist-entries

タイプ: INTEGER

許可される値: 0-

デフォルト: 512

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

hash-max-ziplist-value

タイプ: INTEGER

許可される値: 0-

デフォルト: 64

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

set-max-intset-entries

タイプ: INTEGER

許可される値: 0-

デフォルト: 512

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

zset-max-ziplist-entries

タイプ: INTEGER

許可される値: 0-

デフォルト: 128

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

zset-max-ziplist-value

タイプ: INTEGER

許可される値: 0-

デフォルト: 64

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

tracking-table-max-keys

タイプ: INTEGER

許可される値: 1~100000000

デフォルト:1000000

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

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

acllog-max-len

タイプ: INTEGER

許可される値: 1~10000

デフォルト: 128

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

active-expire-effort

タイプ: INTEGER

許可される値: 1~10

デフォルト: 1

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

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

lazyfree-lazy-user-del

タイプ: STRING

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

デフォルト: いいえ

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

activedefrag

タイプ: STRING

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

デフォルト: いいえ

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

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 Virtual Private Cloud で作成する必要がありますVPC。