View a markdown version of this page

エンジン固有のパラメータ - Amazon ElastiCache
Valkey および Redis OSS パラメータMemcached 固有のパラメータ

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

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

Valkey および Redis OSS

ほとんどの Valkey 8 パラメータは Redis OSS 7.1 パラメータと互換性があります。Valkey 7.2 パラメータは Redis OSS 7 パラメータと同じです。

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

Valkey および Redis OSS パラメータ

Valkey 9.1 および Valkey 9.0 パラメータの変更

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

注記

  • Valkey 9.0 以降のパラメータグループは、Valkey 8.x および Redis OSS と互換性がありません。

Valkey 9.1 および Valkey 9.0 の新しいパラメータグループファミリー:

  • default.valkey9 – Valkey 9.1 および Valkey 9.0 のデフォルトのパラメータグループ (クラスターモードが無効）。

  • default.valkey9.cluster.on – クラスターモードが有効になっている Valkey 9.1 および Valkey 9.0 のデフォルトのパラメータグループ。

Valkey 9.0 の新しいカスタマー表示パラメータ
パラメータ 説明 値 デフォルト 変更可能
cluster-databases クラスターモードで使用可能なデータベースの数。クラスターの作成時に を設定します。 1～10,000 0 いいえ (作成時に設定)

Valkey 8.2 パラメータの変更

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

注記

  • Valkey 8.2 パラメータの変更は Valkey 8.1 には適用されません

  • Valkey 8.0 以降のパラメータグループは、Redis OSS 7.2.4 と互換性がありません。

  • Valkey 8.2 では、コマンド commandlog、commandlog get、commandlog help、commandlog len、commandlog reset. はサーバーレスキャッシュで使用できません。

Valkey 8.2 の新しいパラメータグループ
名前 詳細 説明
search-fanout-target-mode (8.2 で追加)

デフォルト: client

タイプ: 文字列

変更可能: はい

変更の適用: 即時

search-fanout-target-mode 設定パラメータは、Valkey クラスター環境のノード間で検索クエリを分散する方法を制御します。この設定では、次の 2 つの値を使用できます。「throughput」の場合、クライアントタイプや READONLY ステータスに関係なく、検索クエリをすべてのクラスターノードにランダムに分散することで、最大のスループットが得られるように最適化します。「client」の場合、非 READONLY クライアントをプライマリノードのみにルーティングし、レプリカ接続上の READONLY クライアントをレプリカノードのみにルーティングし、プライマリ接続上の READONLY クライアントをすべてのノードにランダムにルーティングすることで、クライアントの接続特性に従います。

デフォルトの動作は「client」モードです。つまり、システムはクエリルーティングの決定の際にクライアント接続タイプと READONLY ステータスに従います。クラスターのリソースを最大限に利用することが望ましい大量の検索ワークロードには throughput モードを使用し、読み取り/書き込みの分離を維持してアプリケーションレベルの READONLY 接続パターンに従う場合は client モードを使用します。
search-default-timeout-ms

デフォルト: 50,000

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

タイプ: 整数

変更可能: はい

変更の適用: 即時

 デフォルトの Valkey 検索クエリのタイムアウト (ミリ秒単位)。
search-enable-partial-results

デフォルト: はい

許可される値: yes、no

タイプ：ブール値

変更可能: はい

変更の適用: 即時

 Valkey 検索のクエリ失敗動作を設定します。有効にした場合、1 つ以上のシャードでタイムアウトが発生すると、検索クエリは部分的な結果を返します。無効にした場合、シャードタイムアウトにより検索クエリ全体が失敗し、エラーが返されます。

Valkey 8.1 パラメータの変更

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

注記

  • Valkey 8.1 パラメータの変更は Valkey 8.0 には適用されません

  • Valkey 8.0 以降のパラメータグループは、Redis OSS 7.2.4 と互換性がありません。

  • Valkey 8.1 では、コマンド commandlog、commandlog get、commandlog help、commandlog len、commandlog reset. はサーバーレスキャッシュで使用できません。

Valkey 8.1 の新しいパラメータグループ
名前 詳細 説明

commandlog-request-larger-than (8.1 で追加)

デフォルト: 1048576

タイプ: 整数

変更可能: はい

変更の適用: 即時

Valkey コマンドログ機能によってログに記録されるリクエストの最大サイズ (バイト単位)。

commandlog-large-request-max-len (8.1 で追加)

デフォルト: 128

許可される値: 0～1024

タイプ: 整数

変更可能: はい

変更の適用: 即時

リクエストの Valkey コマンドログの最大長。

commandlog-reply-larger-than (8.1 で追加)

デフォルト: 1048576

タイプ: 整数

変更可能: はい

変更の適用: 即時

Valkey コマンドログ機能によってログに記録されるレスポンスの最大サイズ (バイト単位)。

commandlog-large-reply-max-len (8.1 で追加)

デフォルト: 128

許可される値: 0～1024

タイプ: 整数

変更可能: はい

変更の適用: 即時

レスポンスの Valkey コマンドログの最大長。

Valkey 8.0 パラメータの変更

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

注記

Redis OSS 7.2.4 は Valkey 8 以降のパラメータグループと互換性がありません。

Valkey 8.0 での特定のパラメータの変更
名前 詳細 説明

repl-backlog-size

デフォルト: 10485760

タイプ: 整数

変更可能: はい

変更の適用: 即時

プライマリノードバックログバッファーのサイズ (バイト単位)。バックログは、プライマリノードのデータの更新を記録するために使用されます。リードレプリカは、プライマリに接続すると、部分同期 (psync) の実行を試みます。このとき、プライマリノードに追いつくことができるようにバックログからデータを適用します。psync に失敗した場合は、完全同期が必要です。

このパラメータの最小値は 16384 です。

注意: Redis OSS 2.8.22 から、このパラメータはプライマリクラスターとリードレプリカに適用されます。

maxmemory-samples

デフォルト: 3

許可される値: 1～64

タイプ: 整数

変更可能: はい

変更の適用: 即時

LRU (least-recently-used) と TTL (time-to-live) の計算の場合、このパラメータはチェックするキーのサンプルサイズを表します。デフォルトで、Redis OSS は 3 個のキーを選択し、最も長い間使用されていないキーを使用します。
Valkey 8.0 の新しいパラメータグループ
名前 詳細 説明

extended-redis-compatibility

許可される値: yes、no

デフォルト: はい

型: ブール値

変更可能: はい

変更の反映: 即時

拡張 Redis OSS 互換モードでは、Valkey が Redis OSS 7.2 のように動作します。これは、ツールまたはクライアントに問題がある場合にのみ有効にします。

顧客に対する影響:

  • LOADING – Redis OSS はデータセットをメモリにロードしています

  • BUSY – Redis OSS はビジー状態です

  • MISCONF – Redis OSS は次のいずれかの方法で設定されます。

    • HELLO コマンドは、"server" => "redis" と "version" => "7.2.4" (Redis OSS 互換バージョン) を返します。

    • モードの INFO フィールドは「redis_mode」と呼ばれます。
Valkey 8.0 で削除されたパラメータグループ
名前 詳細 説明

lazyfree-lazy-eviction

許可される値: yes、no

デフォルト: いいえ

型: ブール値

変更可能: はい

変更の反映: 即時

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

lazyfree-lazy-expire

許可される値: yes、no

デフォルト: いいえ

型: ブール値

変更可能: はい

変更の反映: 即時

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

lazyfree-lazy-server-del

許可される値: yes、no

デフォルト: いいえ

型: ブール値

変更可能: はい

変更の反映: 即時

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

lazyfree-lazy-user-del

デフォルト: いいえ

タイプ: 文字列

変更可能: はい

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

値を yes に設定すると、DEL コマンドは UNLINK と同じように動作します。

replica-lazy-flush

デフォルト: はい

型: ブール値

変更可能: いいえ

旧名: slave-lazy-flush

レプリカの同期中に非同期 flushDB を実行します。

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

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

Valkey 7.2 のデフォルトのパラメータグループは次のとおりです。

  • default.valkey7 – このパラメータグループ、またはそこから派生したグループを、Valkey (クラスターモードが無効) クラスターおよびレプリケーショングループに使用します。

  • default.valkey7.cluster.on – このパラメータグループ、またはそこから派生したグループを、Valkey (クラスターモードが有効) クラスターおよびレプリケーショングループに使用します。

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

Redis OSS 7 のデフォルトのパラメータグループは次のとおりです。

  • default.redis7 – このパラメータグループ、またはそこから派生したグループを、Redis OSS (クラスターモードが無効) クラスターおよびレプリケーショングループに使用します。

  • default.redis7.cluster.on – このパラメータグループ、またはそこから派生したグループを、Redis OSS (クラスターモードが有効) クラスターおよびレプリケーショングループに使用します。

特定のパラメータの変更

Redis OSS 7 で追加されたパラメータは次のとおりです。Valkey 7.2 も、これらのパラメータをサポートしています。

名前 詳細 説明
cluster-allow-pubsubshard-when-down

許可される値: yes、no

デフォルト: yes

タイプ: 文字列

変更可能: はい

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

デフォルトの [yes] に設定すると、クラスターがダウン状態でも、自分がスロットを所有しているとみなしている限り、ノードは pubsub シャードトラフィックを処理できます。
cluster-preferred-endpoint-type

許可される値: ip、tls-dynamic

デフォルト: tls-dynamic

タイプ: 文字列

変更可能: はい

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

この値は、MOVED/ASKING リクエストに対して返されるエンドポイントと、CLUSTER SLOTS および CLUSTER SHARDS のエンドポイントフィールドを制御します。値が IP に設定されると、ノードは IP アドレスをアドバタイズします。値が tls-dynamic に設定されているとき、ノードは転送中の暗号化が有効になっている場合はホスト名をアドバタイズし、それ以外の場合は IP アドレスをアドバタイズします。
latency-tracking

許可される値: yes、no

デフォルト: 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

型: 整数

変更可能: はい

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

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

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

名前 詳細 説明
activerehashing

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

変更可能は Yes でした。

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

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

許可される値: 0+

デフォルト: 512

型: 整数

変更可能: はい

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

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

許可される値: 0+

デフォルト: 64

型: 整数

変更可能: はい

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

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

許可される値: 0+

デフォルト: 128

型: 整数

変更可能: はい

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

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

許可される値: 0+

デフォルト: 64

型: 整数

変更可能: はい

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

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

許可される値:

デフォルト: -2

型: 整数

変更可能: はい

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

内部リストノードごとに許可されるエントリ数。

Redis OSS 6.x パラメータの変更

パラメータグループファミリー: redis6.x

Redis OSS 6.x のデフォルトのパラメータグループは次のとおりです。

  • default.redis6.x – このパラメータグループ、またはそこから派生したグループを、Valkey または Redis OSS (クラスターモードが無効) クラスターおよびレプリケーショングループに使用します。

  • default.redis6.x.cluster.on – このパラメータグループ、またはそこから派生したグループを、Valkey または Redis OSS (クラスターモードが有効) クラスターおよびレプリケーショングループに使用します。

注記

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

詳細については、「Redis OSS 用の ElastiCache バージョン 6.2 (拡張)」および「Redis OSS 用の ElastiCache バージョン 6.0 (拡張)」を参照してください。

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

詳細 説明
acl-pubsub-default (added in 6.2)

許可される値: resetchannels、allchannels

デフォルト: allchannels

タイプ: 文字列

変更可能: はい

変更の適用: クラスターに関連付けられている既存の Redis OSS ユーザーには、既存のアクセス許可が引き続き付与されます。ユーザーを更新するか、クラスターを再起動して、既存の Redis OSS ユーザーを更新します。

このクラスターにデプロイした ACL ユーザーの、デフォルトの pubsub チャネルのアクセス許可。
cluster-allow-reads-when-down (added in 6.0)

デフォルト: いいえ

タイプ: 文字列

変更可能: はい

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

[はい] に設定すると、Redis OSS (クラスターモードが有効) レプリケーショングループは、ノードがプライマリキーのクォーラムに到達できない場合でも、読み取りコマンドを処理し続けます。

デフォルトの no に設定すると、レプリケーショングループはすべてのコマンドを拒否します。ノードグループが 3 つ未満のクラスターを使用している場合、またはアプリケーションで古い読み取りを安全に処理できる場合は、この値を yes に設定することをお勧めします。
tracking-table-max-keys (added in 6.0)

デフォルト: 1,000,000

タイプ: 数値

変更可能: はい

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

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

追跡されたキーが変更されると、無効化メッセージがすべてのクライアントに送信され、キャッシュされた値が無効になったことが通知されます。この値により、このテーブルの上限を指定できます。このパラメータ値を超えると、クライアントには無作為に無効化が送信されます。この値は、十分なキーを追跡し続けながら、メモリ使用量を制限するように調整する必要があります。キーはメモリ不足状態でも無効になります。
acllog-max-len (added in 6.0)

デフォルト: 128

タイプ: 数値

変更可能: はい

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

この値は、ACL ログ内のエントリの最大数に対応します。
active-expire-effort (added in 6.0)

デフォルト: 1

タイプ: 数値

変更可能: はい

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

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

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

デフォルト: いいえ

タイプ: 文字列

変更可能: はい

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

値を yes に設定すると、DEL コマンドは UNLINKと同じように動作します。

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

名前 詳細 説明
lua-replicate-commands

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

デフォルト: はい

型: ブール値

変更可能: はい

変更の適用: 即時

 Lua 効果レプリケーションを常に有効にするか、Lua スクリプトでは有効にしません

Redis OSS 5.0.3 パラメータの変更

パラメータグループファミリー: redis5.0

Redis OSS 5.0 のデフォルトのパラメータグループ

  • default.redis5.0 – このパラメータグループ、またはそこから派生したグループを、Valkey または Redis OSS (クラスターモードが無効) クラスターおよびレプリケーショングループに使用します。

  • default.redis5.0.cluster.on – このパラメータグループ、またはそこから派生したグループを、Valkey または Redis OSS (クラスターモードが有効) クラスターおよびレプリケーショングループに使用します。

Redis OSS 5.0.3 で追加されたパラメータ
名前 詳細 説明
rename-commands

デフォルト: なし

タイプ: 文字列

変更可能: はい

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

 名前が変更された Redis OSS コマンドのスペースで区切られたリスト。以下に示すのは、名前変更に使用できるコマンドのリストの一部です。

APPEND AUTH BITCOUNT BITFIELD BITOP BITPOS BLPOP BRPOP BRPOPLPUSH BZPOPMIN BZPOPMAX CLIENT CLUSTER COMMAND DBSIZE DECR DECRBY DEL DISCARD DUMP ECHO EVAL EVALSHA EXEC EXISTS EXPIRE EXPIREAT FLUSHALL FLUSHDB GEOADD GEOHASH GEOPOS GEODIST GEORADIUS GEORADIUSBYMEMBER GET GETBIT GETRANGE GETSET HDEL HEXISTS HGET HGETALL HINCRBY HINCRBYFLOAT HKEYS HLEN HMGET HMSET HSET HSETNX HSTRLEN HVALS INCR INCRBY INCRBYFLOAT INFO KEYS LASTSAVE LINDEX LINSERT LLEN LPOP LPUSH LPUSHX LRANGE LREM LSET LTRIM MEMORY MGET MONITOR MOVE MSET MSETNX MULTI OBJECT PERSIST PEXPIRE PEXPIREAT PFADD PFCOUNT PFMERGE PING PSETEX PSUBSCRIBE PUBSUB PTTL PUBLISH PUNSUBSCRIBE RANDOMKEY READONLY READWRITE RENAME RENAMENX RESTORE ROLE RPOP RPOPLPUSH RPUSH RPUSHX SADD SCARD SCRIPT SDIFF SDIFFSTORE SELECT SET SETBIT SETEX SETNX SETRANGE SINTER SINTERSTORE SISMEMBER SLOWLOG SMEMBERS SMOVE SORT SPOP SRANDMEMBER SREM STRLEN SUBSCRIBE SUNION SUNIONSTORE SWAPDB TIME TOUCH TTL TYPE UNSUBSCRIBE UNLINK UNWATCH WAIT WATCH ZADD ZCARD ZCOUNT ZINCRBY ZINTERSTORE ZLEXCOUNT ZPOPMAX ZPOPMIN ZRANGE ZRANGEBYLEX ZREVRANGEBYLEX ZRANGEBYSCORE ZRANK ZREM ZREMRANGEBYLEX ZREMRANGEBYRANK ZREMRANGEBYSCORE ZREVRANGE ZREVRANGEBYSCORE ZREVRANK ZSCORE ZUNIONSTORE SCAN SSCAN HSCAN ZSCAN XINFO XADD XTRIM XDEL XRANGE XREVRANGE XLEN XREAD XGROUP XREADGROUP XACK XCLAIM XPENDING GEORADIUS_RO GEORADIUSBYMEMBER_RO LOLWUT XSETID SUBSTR

詳細については、「Redis OSS 用の ElastiCache バージョン 5.0.6 (拡張)」を参照してください。

Redis OSS 5.0.0 パラメータの変更

パラメータグループファミリー: redis5.0

Redis OSS 5.0 のデフォルトのパラメータグループ

  • default.redis5.0 – このパラメータグループ、またはそこから派生したグループを、Valkey または Redis OSS (クラスターモードが無効) クラスターおよびレプリケーショングループに使用します。

  • default.redis5.0.cluster.on – このパラメータグループ、またはそこから派生したグループを、Valkey または Redis OSS (クラスターモードが有効) クラスターおよびレプリケーショングループに使用します。

Redis OSS 5.0 で追加されたパラメータ
名前 詳細 説明
stream-node-max-bytes

許可される値: 0+

デフォルト: 4096

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

許可される値: 0+

デフォルト: 100

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

許可される値: 1～1000000

デフォルト: 1000

タイプ: 整数

変更可能: はい

変更の適用: 即時

 メインディクショナリスキャンから処理される set/hash/zset/list フィールドの最大数
lua-replicate-commands

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

デフォルト: はい

型: ブール値

変更可能: はい

変更の適用: 即時

 Lua 効果レプリケーションを常に有効にするか、Lua スクリプトでは有効にしません
replica-ignore-maxmemory

デフォルト: はい

型: ブール値

変更可能: いいえ

 プライマリから独立したアイテムを削除しないで、レプリカが maxmemory 設定を無効にするかどうかを判断します。
Redis OSS 5.0 で変更されたパラメータ
名前 詳細 説明
active-defrag-cycle-min

許可される値: 1～75

デフォルト: 5

タイプ: 整数

変更可能: はい

変更の反映: 即時

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

Redis OSS は、コミュニティのフィードバックに応じてエンジンバージョン 5.0 でいくつかのパラメータの名前を変更しました。詳細については、「Redis OSS 5 の最新情報」を参照してください。次の表に、新しい名前と前のバージョンとの対応を示します。

Redis OSS 5.0 で名前が変更されたパラメータ
名前 詳細 説明
replica-lazy-flush

デフォルト: はい

型: ブール値

変更可能: いいえ

旧名: slave-lazy-flush

 レプリカの同期中に非同期 flushDB を実行します。
client-output-buffer-limit-replica-hard-limit

デフォルト: 値については、「Redis OSS のノードタイプに固有のパラメータ」を参照してください

タイプ: 整数

変更可能: いいえ

旧名: client-output-buffer-limit-slave-hard-limit

 Redis OSS リードレプリカの場合: クライアントの出力バッファが指定されたバイト数に達した場合、クライアントの接続が切断されます。
client-output-buffer-limit-replica-soft-limit

デフォルト: 値については、「Redis OSS のノードタイプに固有のパラメータ」を参照してください

タイプ: 整数

変更可能: いいえ

旧名: client-output-buffer-limit-slave-soft-limit

 Redis OSS リードレプリカの場合: クライアントの出力バッファが指定されたバイト数に達した場合、クライアントの接続が切断されますが、この条件が client-output-buffer-limit-replica-soft-seconds の間存続した場合に限ります。
client-output-buffer-limit-replica-soft-seconds

デフォルト: 60

タイプ: 整数

変更可能: いいえ

旧名: client-output-buffer-limit-slave-soft-seconds

 Redis OSS リードレプリカの場合: クライアントの出力バッファが、この秒数より長い時間 client-output-buffer-limit-replica-soft-limit バイトのままの場合、クライアントの接続が切断されます。
replica-allow-chaining

デフォルト: いいえ

タイプ: 文字列

変更可能: いいえ

旧名: slave-allow-chaining

 Redis OSS のリードレプリカは自身のリードレプリカを持つことができるかどうかを決定します。
min-replicas-to-write

デフォルト: 0

タイプ: 整数

変更可能: はい

旧名: min-slaves-to-write

変更の適用: 即時

プライマリノードがクライアントからの書き込みを受け入れるために、使用可能でなければならないリードレプリカの数。使用可能なレプリカの数がこの数を下回った場合、プライマリノードは書き込みリクエストを受け入れなくなります。

このパラメータか min-replicas-max-lag のどちらかが 0 の場合、レプリカが使用できない場合でもプライマリノードは常に書き込みリクエストを受け入れます。
min-replicas-max-lag

デフォルト: 10

タイプ: 整数

変更可能: はい

旧名: min-slaves-max-lag

変更の適用: 即時

プライマリノードからリードレプリカから ping リクエストを受け取る必要がある秒数。この時間が経過してもプライマリが ping を受け取らない場合、レプリカは使用可能と見なされなくなります。使用可能なレプリカの数が min-replicas-to-write を下回った場合、プライマリはその時点で書き込みの受け入れを停止します。

このパラメータか min-replicas-to-write のどちらかが 0 の場合、レプリカが使用できない場合でもプライマリノードは常に書き込みリクエストを受け入れます。
close-on-replica-write

デフォルト: はい

型: ブール値

変更可能: はい

旧名: close-on-slave-write

変更の適用: 即時

有効にした場合、読み取り専用レプリカに書き込もうとするクライアントの接続は切断されます。
Redis OSS 5.0 で削除されたパラメータ
名前 詳細 説明
repl-timeout

デフォルト: 60

変更可能: いいえ

 パラメータはこのバージョンでは使用できません。

Redis OSS 4.0.10 パラメータの変更

パラメータグループファミリー: redis4.0

Redis OSS 4.0.x のデフォルトのパラメータグループ

  • default.redis4.0 – このパラメータグループ、またはそこから派生したグループを、Valkey または Redis OSS (クラスターモードが無効) クラスターおよびレプリケーショングループに使用します。

  • default.redis4.0.cluster.on – このパラメータグループ、またはそこから派生したグループを、Valkey または Redis OSS (クラスターモードが有効) クラスターおよびレプリケーショングループに使用します。

Redis OSS 4.0.10 で変更されたパラメータ
名前 詳細 説明
maxmemory-policy

許可される値: allkeys-lru、volatile-lru、allkeys-lfu、volatile-lfu、allkeys-random、volatile-random、volatile-ttl、noeviction

デフォルト: volatile-lru

タイプ: 文字列

変更可能: はい

変更の反映: 即時

 maxmemory-policy がバージョン 2.6.13 で追加されました。バージョン 4.0.10 では、2 つの新しい許容値が追加されました。allkeys-lfu は、近似 LFU を使用して、すべてのキーを削除します。volatile-lfu は、近似 LFU を使用して、有効期限が設定されたキーを削除します。バージョン 6.2 では、データ階層化で使用するために r6gd ノードファミリーが導入された場合、noeviction、volatile-lru および allkeys-lru max-memory ポリシーのみが r6gd ノードタイプでサポートされます。
Redis OSS 4.0.10 で追加されたパラメータ
名前 詳細 説明
非同期削除パラメータ
lazyfree-lazy-eviction

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

デフォルト: いいえ

型: ブール値

変更可能: はい

変更の反映: 即時

 Performs an asynchronous delete on evictions.
lazyfree-lazy-expire

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

デフォルト: いいえ

型: ブール値

変更可能: はい

変更の反映: 即時

 Performs an asynchronous delete on expired keys.
lazyfree-lazy-server-del

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

デフォルト: いいえ

型: ブール値

変更可能: はい

変更の反映: 即時

 Performs an asynchronous delete for commands which update values.
slave-lazy-flush

許可される値: 該当なし

デフォルト: いいえ

型: ブール値

変更可能: いいえ

Changes take place: N/A		 Performs an asynchronous flushDB during slave sync.
LFU パラメータ
lfu-log-factor

許可される値: 任意の整数 > 0

デフォルト: 10

タイプ: 整数

変更可能: はい

変更の反映: 即時

 Set the log factor, which determines the number of key hits to saturate the key counter.
lfu-decay-time

許可される値: 任意の整数

デフォルト: 1

タイプ: 整数

変更可能: はい

変更の反映: 即時

 The amount of time in minutes to decrement the key counter.
アクティブなデフラグメンテーションのパラメータ
activedefrag

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

デフォルト: いいえ

型: ブール値

変更可能: はい

変更の反映: 即時

アクティブなデフラグメンテーションを有効にします。

注記

Valkey および Redis OSS バージョン 7.0 以降 AWS では、この設定に関係なく、運用上必要な場合に自動的にデフラグを実行できます。
active-defrag-ignore-bytes

許可される値: 10485760～104857600

デフォルト: 104857600

タイプ: 整数

変更可能: はい

変更の反映: 即時

 Minimum amount of fragmentation waste to start active defrag.
active-defrag-threshold-lower

許可される値: 1～100

デフォルト: 10

タイプ: 整数

変更可能: はい

変更の反映: 即時

 Minimum percentage of fragmentation to start active defrag.
active-defrag-threshold-upper

許可される値: 1～100

デフォルト: 100

タイプ: 整数

変更可能: はい

変更の反映: 即時

 Maximum percentage of fragmentation at which we use maximum effort.
active-defrag-cycle-min

許可される値: 1～75

デフォルト: 25

タイプ: 整数

変更可能: はい

変更の反映: 即時

 Minimal effort for defrag in CPU percentage.
active-defrag-cycle-max

許可される値: 1～75

デフォルト: 75

タイプ: 整数

変更可能: はい

変更の反映: 即時

 Maximal effort for defrag in CPU percentage.
クライアント出力バッファのパラメータ
client-query-buffer-limit

許可される値: 1048576～1073741824

デフォルト: 1073741824

タイプ: 整数

変更可能: はい

変更の反映: 即時

 Max size of a single client query buffer.
proto-max-bulk-len

許可される値: 1048576～536870912

デフォルト: 536870912

タイプ: 整数

変更可能: はい

変更の反映: 即時

 Max size of a single element request.

Redis OSS 3.2.10 パラメータの変更

パラメータグループファミリー: redis3.2

ElastiCache for Redis OSS 3.2.10 では、追加でサポートされているパラメータはありません。

Redis OSS 3.2.6 パラメータの変更

パラメータグループファミリー: redis3.2

Redis OSS 3.2.6 では、追加でサポートされているパラメータはありません。

Redis OSS 3.2.4 パラメータの変更

パラメータグループファミリー: redis3.2

Redis OSS 3.2.4 以降、2 つのデフォルトのパラメータグループがあります。

  • default.redis3.2 – Redis OSS 3.2.4 を実行する場合、Valkey または Redis OSS (クラスターモードが無効) レプリケーショングループを作成し、Redis OSS 3.2.4 のその他の機能を引き続き使用する場合は、このパラメータグループまたはそこから派生したパラメータグループを指定します。

  • default.redis3.2.cluster.on – Valkey または Redis OSS (クラスターモードが有効) レプリケーショングループを作成する場合は、このパラメータグループまたはそこから派生したパラメータグループを指定します。

Redis OSS 3.2.4 の新しいパラメータ

パラメータグループファミリー: redis3.2

Redis OSS 3.2.4 では、次のパラメータが追加でサポートされます。

名前 詳細 説明
list-max-ziplist-size

デフォルト: -2

タイプ: 整数

変更可能: いいえ

 リストは、領域を節約する特殊な方法でエンコードされます。内部リストノードあたり許可されるエントリの数は、要素の固定最大サイズまたは最大数として指定できます。最大固定サイズには、-5～-1 を使用します。この意味は次のとおりです。

  • -5: 最大サイズ: 64 KB - 通常のワークロードには推奨されません

  • -4: 最大サイズ: 32 KB - 推奨されません

  • -3: 最大サイズ: 16 KB - 推奨されません

  • -2: 最大サイズ: 8 KB - 推奨

  • -1: 最大サイズ: 4 KB - 推奨

  • 正の値は、リストノードあたり、最大でその数の要素まで保存することを意味します。
list-compress-depth

デフォルト: 0

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

  • 0: すべての圧縮を無効にします。

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

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

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

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

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

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

  • その他
cluster-enabled

デフォルト: no/yes *

タイプ: 文字列

変更可能: いいえ

これがクラスターモードの Valkey または Redis OSS (クラスターモードが有効) レプリケーショングループである (yes) か、非クラスターモードの Valkey または Redis OSS (クラスターモードが有効) レプリケーショングループである (no) かを示します。クラスターモードの Valkey または Redis OSS (クラスターモードが有効) レプリケーショングループは、最大 500 のノードグループ間でデータを分割できます。

* Redis OSS 3.2.x には 2 つのデフォルトのパラメータグループがあります。

  • default.redis3.2 - デフォルト値: no。

  • default.redis3.2.cluster.on - デフォルト値: yes。

.
cluster-require-full-coverage

デフォルト: いいえ

型: ブール値

変更可能: はい

変更の適用: 即時

yes に設定された場合、Valkey または Redis OSS (クラスターモードが有効) のクラスターモード内のノードは、少なくとも 1 つのハッシュスロットがカバーされていない (利用可能なノードがそれを処理していない) ことを検出した場合、クエリの受け付けを停止します。このように、クラスターが部分的にダウンしている場合、クラスターは使用できなくなります。すべてのスロットが再び処理対象になると、クラスターは自動的に再び使用可能になります。

ただし、まだ処理対象になっているキー空間の部分に対するクエリを受け入れ続けるようにクラスターのサブセットが機能していることが必要な場合があります。その場合は、cluster-require-full-coverage オプションを no に設定するだけです。
hll-sparse-max-bytes

デフォルト: 3000

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

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

PFADD の速度を下げすぎることなく領域効率の良いエンコードの利点を活かせる (スパースなエンコードで O(N) になる) ように、値は約 3,000 にすることをお勧めします。問題が CPU ではなく領域であり、データセットが 0～15,000 の濃度の大量の HyperLogLog で構成されているときは、値を 10,000 まで大きくすることができます。
reserved-memory-percent

デフォルト: 25

タイプ: 整数

変更可能: はい

変更の適用: 即時

非データ用に確保されているノードのメモリの割合。デフォルトでは、ノードのメモリがすべて消費されるまで Redis OSS データフットプリントは増加します。この場合、メモリページングが大量に行われるため、ノードパフォーマンスが低下する可能性が高くなります。使用可能なメモリの一部を Redis OSS 以外の用途に確保しておくことで、ページングの量を減らすことができます。

このパラメータは ElastiCache に固有であり、標準的な Redis OSS ディストリビューションには含まれていません。

詳細については、「reserved-memory」および「Valkey および Redis OSS の予約済みメモリを管理する」を参照してください。

Redis OSS 3.2.4 (拡張) で変更されたパラメータ

パラメータグループファミリー: redis3.2

Redis OSS 3.2.4 では、以下のパラメータが変更されました。

名前 詳細 変更
activerehashing

変更可能: パラメータグループがいずれのクラスターにも関連付けられていない場合は、はい。それ以外の場合は No です。

変更可能は No でした。
databases

変更可能: パラメータグループがいずれのクラスターにも関連付けられていない場合は、はい。それ以外の場合は No です。

変更可能は No でした。
appendonly

デフォルト: オフ

変更可能: いいえ

以前のバージョンの Redis OSS からアップグレードする場合は、最初に appendonly をオフにする必要があります。
appendfsync

デフォルト: オフ

変更可能: いいえ

以前のバージョンの Redis OSS からアップグレードする場合は、最初に appendfsync をオフにする必要があります。
repl-timeout

デフォルト: 60

変更可能: いいえ

 現在はデフォルト値 60 で、変更できません。
tcp-keepalive

デフォルト: 300

デフォルト値は 0 でした。
list-max-ziplist-entries

パラメータは使用できなくなりました。
list-max-ziplist-value

パラメータは使用できなくなりました。

Redis OSS 2.8.24 (拡張) で追加されたパラメータ

パラメータグループファミリー: redis2.8

Redis OSS 2.8.24 では、追加でサポートされているパラメータはありません。

Redis OSS 2.8.23 (拡張) で追加されたパラメータ

パラメータグループファミリー: redis2.8

Redis OSS 2.8.23 では、以下のパラメータが追加でサポートされます。

名前 詳細 説明
close-on-slave-write

デフォルト: はい

タイプ: 文字列 (はい/いいえ)

変更可能: はい

変更の適用: 即時

有効にした場合、読み取り専用レプリカに書き込もうとするクライアントの接続は切断されます。

close-on-slave-write の動作

close-on-slave-write パラメータが Amazon ElastiCache によって導入されたことで、リードレプリカがプライマリノードに昇格するために両者間でロールが入れ替わるときのクラスターの応答を、より細かく制御できるようになりました。

イメージ: close-on-replica-write、すべてが正常に動作

リードレプリカクラスターが、マルチ AZ 対応レプリケーショングループのフェイルオーバー以外の理由で、プライマリに昇格する場合、クライアントは引き続きエンドポイント A に書き込もうとします。エンドポイント A はこの時点でリードレプリカのエンドポイントであるため、これらの書き込みは失敗します。これは、ElastiCache が close-on-replica-write を導入する前の Redis OSS に対する動作であり、close-on-replica-write を無効にした場合の動作です。

イメージ: close-on-slave-write、書き込みが失敗

close-on-replica-write が有効になっていると、クライアントがリードレプリカに書き込もうとするたびに、クラスターへのクライアントの接続は切断されます。アプリケーションロジックは、切断を検出し、DNS テーブルを確認して、プライマリエンドポイント (この時点でエンドポイント B になっている) に再接続する必要があります。

イメージ: close-on-slave-write、新しいプライマリクラスターに書き込み

close-on-replica-write を無効にする場合

close-on-replica-write を無効にすると、障害が発生しているクラスターに書き込まれることになります。それでは、なぜ close-on-replica-write を無効にするのでしょう。

前述したように、close-on-replica-write が有効になっていると、クライアントがリードレプリカに書き込もうとするたびに、クラスターへのクライアントの接続は切断されます。ノードへの新しい接続の確立には時間がかかります。したがって、レプリカへの書き込みリクエストの結果として切断および再接続が行われると、同じ接続を介して提供される読み取りリクエストのレイテンシーにも影響します。この効果は、新しい接続が確立されるまで維持されます。特に、読み取りが多いアプリケーションや、レイテンシーの影響を受けやすいアプリケーションの場合、読み取りパフォーマンスが下がらないように、クライアントを接続したままにすることができます。

Redis OSS 2.8.22 (拡張) で追加されたパラメータ

パラメータグループファミリー: redis2.8

Redis OSS 2.8.22 では、追加でサポートされているパラメータはありません。

重要

  • Redis OSS バージョン 2.8.22 から、プライマリクラスターとレプリカクラスターに repl-backlog-size が適用されるようになりました。

  • Redis OSS バージョン 2.8.22 以降では、repl-timeout パラメータはサポートされていません。そのパラメータが変更された場合、appendonly と同様に、ElastiCache によってデフォルト (60 秒) で上書きされます。

次のパラメータはサポートされなくなりました。

  • appendonly

  • appendfsync

  • repl-timeout

Redis OSS 2.8.21 で追加されたパラメータ

パラメータグループファミリー: redis2.8

Redis OSS 2.8.21 では、追加でサポートされているパラメータはありません。

Redis OSS 2.8.19 で追加されたパラメータ

パラメータグループファミリー: redis2.8

Redis OSS 2.8.19 では、追加でサポートされているパラメータはありません。

Redis OSS 2.8.6 で追加されたパラメータ

パラメータグループファミリー: redis2.8

Redis OSS 2.8.6 では、次のパラメータが追加でサポートされます。

名前 詳細 説明
min-slaves-max-lag

デフォルト: 10

タイプ: 整数

変更可能: はい

変更の適用: 即時

プライマリノードからリードレプリカから ping リクエストを受け取る必要がある秒数。この時間が経過してもプライマリが ping を受け取らない場合、レプリカは使用可能と見なされなくなります。使用可能なレプリカの数が min-slaves-to-write を下回った場合、プライマリはその時点で書き込みの受け入れを停止します。

このパラメータか min-slaves-to-write のどちらかが 0 の場合、レプリカが使用できない場合でもプライマリノードは常に書き込みリクエストを受け入れます。
min-slaves-to-write

デフォルト: 0

タイプ: 整数

変更可能: はい

変更の適用: 即時

プライマリノードがクライアントからの書き込みを受け入れるために、使用可能でなければならないリードレプリカの数。使用可能なレプリカの数がこの数を下回った場合、プライマリノードは書き込みリクエストを受け入れなくなります。

このパラメータか min-slaves-max-lag のどちらかが 0 の場合、レプリカが使用できない場合でもプライマリノードは常に書き込みリクエストを受け入れます。
notify-keyspace-events

デフォルト: (空の文字列)

タイプ: 文字列

変更可能: はい

変更の適用: 即時

Redis OSS がクライアントに通知できる keyspace イベントのタイプ。各イベントタイプは 1 文字で表されます。

  • K — Keyspace イベント、プレフィックス __keyspace@<db>__ を付けて発行

  • E — Key-event イベント、プレフィックス __keyevent@<db>__ を付けて発行

  • g — 固有でない汎用コマンド (DEL、EXPIRE、RENAME など)

  • $ — 文字列コマンド

  • l — リストコマンド

  • s — 設定コマンド

  • h — ハッシュコマンド

  • z — ソート対象セットコマンド

  • x — 期限切れのイベント（キーの期限が切れるたびにイベントが生成されます）

  • e — 削除されたイベント（maxmemory に達したためにキーが削除された場合にイベントが生成されます）

  • A — g$lshzxe のエイリアス

注: Amazon ElastiCache が通知を配信できるように、文字列に少なくとも K または E を含めます。イベントタイプの文字 (期限切れxのイベントなど) は何が起こったかを識別しますが、配信は自分でトリガーしません。K と E を省略すると、Amazon ElastiCache はエラーなしで設定を受け入れますが、通知をサイレントに無効にします。

これらのイベントタイプは自由に組み合わせることができます。例えば、AKE は Redis OSS がすべてのイベントタイプの通知を発行できることを意味します。

上に挙げられた文字以外の文字を使用しないでください。使用しようとすると、エラーメッセージが表示されます。

デフォルトでは、このパラメータは空の文字列に設定されます。これは、keyspace イベント通知が無効であることを意味します。
repl-backlog-size

デフォルト: 1048576

タイプ: 整数

変更可能: はい

変更の適用: 即時

プライマリノードバックログバッファーのサイズ (バイト単位)。バックログは、プライマリノードのデータの更新を記録するために使用されます。リードレプリカは、プライマリに接続すると、部分同期 (psync) の実行を試みます。このとき、プライマリノードに追いつくことができるようにバックログからデータを適用します。psync に失敗した場合は、完全同期が必要です。

このパラメータの最小値は 16384 です。

注記

Redis OSS 2.8.22 から、このパラメータはプライマリクラスターとリードレプリカに適用されます。
repl-backlog-ttl

デフォルト: 3600

タイプ: 整数

変更可能: はい

変更の適用: 即時

プライマリノードがバックログバッファーを保持する秒数。最後のレプリカノードが切断されたときから、バックログ内のデータは repl-backlog-ttl の期限が切れるまで変更されません。レプリカがこの時間内にプライマリに接続されない場合、プライマリはバックログバッファーを解放します。レプリカが最終的に再接続した場合、プライマリとの完全同期を実行する必要があります。

このパラメータを 0 に設定した場合、バックログバッファーは解放されません。
repl-timeout

デフォルト: 60

タイプ: 整数

変更可能: はい

変更の適用: 即時

 次のタイムアウト時間（秒単位）を表します。

  • 同期中の一括データ転送 (リードレプリカの観点から)

  • プライマリノードのタイムアウト (レプリカの観点から)

  • レプリカのタイムアウト (プライマリノードの観点から)

Redis OSS 2.6.13 パラメータ

パラメータグループファミリー: redis2.6

Redis OSS バージョン 2.6.13 は、ElastiCache でサポートされた Redis OSS の最初のバージョンです。次の表は、ElastiCache がサポートしている Redis OSS 2.6.13 パラメータを示しています。

名前 詳細 説明
activerehashing

デフォルト: はい

タイプ: 文字列 (はい/いいえ)

変更可能: はい

変更の適用: 作成時

Redis のアクティブな再ハッシュ機能を有効にするかどうかを決定します。主要なハッシュテーブルは、1 秒あたり 10 回再ハッシュされます。再ハッシュ操作ごとに 1 ミリ秒の CPU が消費されます。

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

デフォルト: いいえ

タイプ: 文字列

変更可能: はい

変更の適用: 即時

Redis の AOF (Append Only File) 機能を有効または無効にします。AOF は、キャッシュ内のデータを変更する Redis OSS コマンドをキャプチャし、特定のノード障害からの復元に使用されます。

デフォルト値は no です（AOF が無効であることを意味します）。AOF を有効にするには、このパラメータを yes に設定します。

詳細については、「障害の軽減」を参照してください。

注記

追加専用ファイル (AOF) は cache.t2.* ノードではサポートされていません。このタイプのノードの場合、appendonly パラメータ値は無視されます。

注記

マルチ AZ レプリケーショングループでは、AOF は許可されません。
appendfsync

デフォルト: everysec

タイプ: 文字列

変更可能: はい

変更の適用: 即時

 appendonly を [yes] に設定すると、AOF 出力バッファーをディスクに書き込む頻度が制御されます。

  • no — バッファーは必要に応じてディスクにフラッシュされます。

  • everysec — バッファーは 1 秒に 1 回フラッシュされます。これがデフォルトです。

  • always — バッファは、クラスターが変更されるたびにフラッシュされます。

  • Appendfsync は、バージョン 2.8.22 以降ではサポートされていません。
client-output-buffer-limit-normal-hard-limit

デフォルト: 0

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

デフォルト: 0

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

デフォルト: 0

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

デフォルト: 33554432

タイプ: 整数

変更可能: はい

変更の適用: 即時

Redis OSS 発行/サブスクライブクライアントの場合: クライアントの出力バッファが指定されたバイト数に達した場合、クライアントの接続が切断されます。
client-output-buffer-limit-pubsub-soft-limit

デフォルト: 8388608

タイプ: 整数

変更可能: はい

変更の適用: 即時

 Redis OSS 発行/サブスクライブクライアントの場合: クライアントの出力バッファが指定されたバイト数に達した場合、クライアントの接続が切断されますが、この条件が client-output-buffer-limit-pubsub-soft-seconds の間存続した場合に限ります。
client-output-buffer-limit-pubsub-soft-seconds

デフォルト: 60

タイプ: 整数

変更可能: はい

変更の適用: 即時

 Redis OSS 発行/サブスクライブクライアントの場合: クライアントの出力バッファがこの秒数より長い間 client-output-buffer-limit-pubsub-soft-limit バイトのままの場合、クライアントの接続が切断されます。
client-output-buffer-limit-slave-hard-limit

デフォルト: 値については、「Redis OSS のノードタイプに固有のパラメータ」を参照してください

タイプ: 整数

変更可能: いいえ

 Redis OSS リードレプリカの場合: クライアントの出力バッファが指定されたバイト数に達した場合、クライアントの接続が切断されます。
client-output-buffer-limit-slave-soft-limit

デフォルト: 値については、「Redis OSS のノードタイプに固有のパラメータ」を参照してください

タイプ: 整数

変更可能: いいえ

 Redis OSS リードレプリカの場合: クライアントの出力バッファが指定されたバイト数に達した場合、クライアントの接続が切断されますが、この条件が client-output-buffer-limit-slave-soft-seconds の間存続した場合に限ります。
client-output-buffer-limit-slave-soft-seconds

デフォルト: 60

タイプ: 整数

変更可能: いいえ

 Redis OSS リードレプリカの場合: クライアントの出力バッファが、この秒数より長い時間 client-output-buffer-limit-slave-soft-limit バイトのままの場合、クライアントの接続が切断されます。
databases

デフォルト: 16

タイプ: 整数

変更可能: いいえ

変更の適用: 作成時

論理パーティションデータベース数は分割されます。この値を低く抑えることをお勧めします。

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

デフォルト: 512

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

デフォルト: 64

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

デフォルト: 512

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

デフォルト: 64

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

デフォルト: 5000

タイプ: 整数

変更可能: いいえ

 ElastiCache がスクリプトを停止するアクションを実行までの Lua スクリプトの最大実行時間 (ミリ秒単位)。

lua-time-limit を超過した場合、すべての Redis OSS コマンドは ____-BUSY の形式のエラーを返します。この状態により、多く必須 Redis OSS オペレーションとの干渉が発生する可能性があるため、ElastiCache はまず SCRIPT KILL コマンドを発行します。これに失敗すると、ElastiCache は強制的に Redis OSS を再起動します。
maxclients この値は、明示的に指定されたインスタンスタイプを除くすべてのインスタンスタイプに適用されます。

デフォルト: 65000

タイプ: 整数

変更可能: いいえ

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

t2.medium デフォルト: 20000

タイプ: 整数

変更可能: いいえ

t2.small デフォルト: 20000

タイプ: 整数

変更可能: いいえ

t2.micro デフォルト: 20000

タイプ: 整数

変更可能: いいえ

t4g.micro デフォルト: 20000

タイプ: 整数

変更可能: いいえ

t3.medium デフォルト: 46000

タイプ: 整数

変更可能: いいえ

t3.small デフォルト: 46000

タイプ: 整数

変更可能: いいえ

t3.micro デフォルト: 20000

タイプ: 整数

変更可能: いいえ
maxmemory-policy

デフォルト: volatile-lru

タイプ: 文字列

変更可能: はい

変更の適用: 即時

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

有効な値は次のとおりです。volatile-lru | allkeys-lru | volatile-random | allkeys-random | volatile-ttl | noeviction

詳細については、「Using Valkey or Redis OSS as an LRU cache」を参照してください。
maxmemory-samples

デフォルト: 3

タイプ: 整数

変更可能: はい

変更の適用: 即時

 LRU (least-recently-used) と TTL (time-to-live) の計算の場合、このパラメータはチェックするキーのサンプルサイズを表します。デフォルトで、Redis OSS は 3 個のキーを選択し、最も長い間使用されていないキーを使用します。
reserved-memory

デフォルト: 0

タイプ: 整数

変更可能: はい

変更の適用: 即時

非データの使用に確保された合計メモリ (バイト単位)。デフォルトでは、Redis OSS ノードは、ノードの maxmemory を消費するまで大きくなります (「Redis OSS のノードタイプに固有のパラメータ」を参照)。この場合、メモリページングが大量に行われるため、ノードパフォーマンスが低下する可能性が高くなります。使用可能なメモリの一部を Redis OSS 以外の用途に確保しておくことで、ページングの量を減らすことができます。

このパラメータは ElastiCache に固有であり、標準的な Redis OSS ディストリビューションには含まれていません。

詳細については、「reserved-memory-percent」および「Valkey および Redis OSS の予約済みメモリを管理する」を参照してください。
set-max-intset-entries

デフォルト: 512

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

デフォルト: いいえ

タイプ: 文字列

変更可能: いいえ

 Redis OSS のリードレプリカは自身のリードレプリカを持つことができるかどうかを決定します。
slowlog-log-slower-than

デフォルト: 10000

タイプ: 整数

変更可能: はい

変更の適用: 即時

 Redis OSS のスローログ機能によりコマンドを記録する最大実行時間 (マイクロ秒単位)。
slowlog-max-len

デフォルト: 128

タイプ: 整数

変更可能: はい

変更の適用: 即時

 Redis OSS スローログの最大長。
tcp-keepalive

デフォルト: 0

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

Redis OSS バージョン 3.2.4 では、このパラメータのアスペクト値が一部変更されています。「Redis OSS 3.2.4 (拡張) で変更されたパラメータ」を参照してください。
timeout

デフォルト: 0

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

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

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

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

デフォルト: 128

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

デフォルト: 64

タイプ: 整数

変更可能: はい

変更の適用: 即時

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

Redis OSS 2.6.13 クラスターにパラメータグループを指定しない場合、デフォルトのパラメータグループ (default.redis2.6) が使用されます。デフォルトのパラメータグループ内のパラメータは、どれも値を変更できません。ただし、いつでもカスタムパラメータグループを作成して、クラスターに割り当てることができます。

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

の値は、ノード上のデータストレージに使用できる最大バイト数maxmemoryです。詳細については、「使用可能なメモリ」を参照してください。

注記

maxmemory パラメータは変更できません。

ノードタイプ 最大メモリ (バイト)
cache.t2.micro 581959680
cache.t2.small 1665138688
cache.t2.medium 3461349376
cache.t3.micro 536870912
cache.t3.small 1471026299
cache.t3.medium 3317862236
cache.t4g.micro 536870912
cache.t4g.small 1471026299
cache.t4g.medium 3317862236
cache.m4.large 6892593152
cache.m4.xlarge 15328501760
cache.m4.2xlarge 31889126359
cache.m4.4xlarge 65257290629
cache.m4.10xlarge 166047614239
cache.m5.large 6854542746
cache.m5.xlarge 13891921715
cache.m5.2xlarge 27966669210
cache.m5.4xlarge 56116178125
cache.m5.12xlarge 168715971994
cache.m5.24xlarge 337500562842
cache.m6g.large 6854542746
cache.m6g.xlarge 13891921715
cache.m6g.2xlarge 27966669210
cache.m6g.4xlarge 56116178125
cache.m6g.8xlarge 111325552312
cache.m6g.12xlarge 168715971994
cache.m6g.16xlarge 225000375228
cache.m7g.large 6854542746
cache.m7g.xlarge 13891921715
cache.m7g.2xlarge 27966669210
cache.m7g.4xlarge 56116178125
cache.m7g.8xlarge 111325552312
cache.m7g.12xlarge 168715971994
cache.m7g.16xlarge 225000375228
cache.m8g.large 7294178820
cache.m8g.xlarge 15222495510
cache.m8g.2xlarge 31866224640
cache.m8g.4xlarge 65856864256
cache.m8g.8xlarge 133838143488
cache.m8g.12xlarge 201819422720
cache.m8g.16xlarge 269800701952
cache.r4.large 13201781556
cache.r4.xlarge 26898228839
cache.r4.2xlarge 54197537997
cache.r4.4xlarge 108858546586
cache.r4.8xlarge 218255432090
cache.r4.16xlarge 437021573120
cache.r5.large 14037181030
cache.r5.xlarge 28261849702
cache.r5.2xlarge 56711183565
cache.r5.4xlarge 113609865216
cache.r5.12xlarge 341206346547
cache.r5.24xlarge 682485973811
cache.r6g.large 14037181030
cache.r6g.xlarge 28261849702
cache.r6g.2xlarge 56711183565
cache.r6g.4xlarge 113609865216
cache.r6g.8xlarge 225000375228
cache.r6g.12xlarge 341206346547
cache.r6g.16xlarge 450000750456
cache.r6gd.xlarge 28261849702
cache.r6gd.2xlarge 56711183565
cache.r6gd.4xlarge 113609865216
cache.r6gd.8xlarge 225000375228
cache.r6gd.12xlarge 341206346547
cache.r6gd.16xlarge 450000750456
cache.r7g.large 14037181030
cache.r7g.xlarge 28261849702
cache.r7g.2xlarge 56711183565
cache.r7g.4xlarge 113609865216
cache.r7g.8xlarge 225000375228
cache.r7g.12xlarge 341206346547
cache.r7g.16xlarge 450000750456
cache.r8g.large 15222495510
cache.r8g.xlarge 31866224640
cache.r8g.2xlarge 65856864256
cache.r8g.4xlarge 133838143488
cache.r8g.8xlarge 269800701952
cache.r8g.12xlarge 405763260416
cache.r8g.16xlarge 541725818880
cache.c7gn.large 3317862236
cache.c7gn.xlarge 6854542746
cache.c7gn.2xlarge 13891921715
cache.c7gn.4xlarge 27966669210
cache.c7gn.8xlarge 56116178125
cache.c7gn.12xlarge 84357985997
cache.c7gn.16xlarge 113609865216
cache.c8gn.large 3330020474
cache.c8gn.xlarge 7294178820
cache.c8gn.2xlarge 15222495510
cache.c8gn.4xlarge 31866224640
cache.c8gn.8xlarge 65856864256
cache.c8gn.12xlarge 99847503872
cache.c8gn.16xlarge 133838143488

Redis OSS のノードタイプに固有のパラメータ

の値は、ノード上のデータストレージに使用できる最大バイト数maxmemoryです。詳細については、「使用可能なメモリ」を参照してください。

注記

maxmemory パラメータは変更できません。

ノードタイプ 最大メモリ (バイト)
cache.t1.micro 142606336
cache.t2.micro 581959680
cache.t2.small 1665138688
cache.t2.medium 3461349376
cache.t3.micro 536870912
cache.t3.small 1471026299
cache.t3.medium 3317862236
cache.t4g.micro 536870912
cache.t4g.small 1471026299
cache.t4g.medium 3317862236
cache.m1.small 943718400
cache.m1.medium 3093299200
cache.m1.large 7025459200
cache.m1.xlarge 14889779200
cache.m2.xlarge 17091788800
cache.m2.2xlarge 35022438400
cache.m2.4xlarge 70883737600
cache.m3.medium 2988441600
cache.m3.large 6501171200
cache.m3.xlarge 14260633600
cache.m3.2xlarge 29989273600
cache.m4.large 6892593152
cache.m4.xlarge 15328501760
cache.m4.2xlarge 31889126359
cache.m4.4xlarge 65257290629
cache.m4.10xlarge 166047614239
cache.m5.large 6854542746
cache.m5.xlarge 13891921715
cache.m5.2xlarge 27966669210
cache.m5.4xlarge 56116178125
cache.m5.12xlarge 168715971994
cache.m5.24xlarge 337500562842
cache.m6g.large 6854542746
cache.m6g.xlarge 13891921715
cache.m6g.2xlarge 27966669210
cache.m6g.4xlarge 56116178125
cache.m6g.8xlarge 111325552312
cache.m6g.12xlarge 168715971994
cache.m6g.16xlarge 225000375228
cache.m7g.large 6854542746
cache.m7g.xlarge 13891921715
cache.m7g.2xlarge 27966669210
cache.m7g.4xlarge 56116178125
cache.m7g.8xlarge 111325552312
cache.m7g.12xlarge 168715971994
cache.m7g.16xlarge 225000375228
cache.c1.xlarge 6501171200
cache.r3.large 14470348800
cache.r3.xlarge 30513561600
cache.r3.2xlarge 62495129600
cache.r3.4xlarge 126458265600
cache.r3.8xlarge 254384537600
cache.r4.large 13201781556
cache.r4.xlarge 26898228839
cache.r4.2xlarge 54197537997
cache.r4.4xlarge 108858546586
cache.r4.8xlarge 218255432090
cache.r4.16xlarge 437021573120
cache.r5.large 14037181030
cache.r5.xlarge 28261849702
cache.r5.2xlarge 56711183565
cache.r5.4xlarge 113609865216
cache.r5.12xlarge 341206346547
cache.r5.24xlarge 682485973811
cache.r6g.large 14037181030
cache.r6g.xlarge 28261849702
cache.r6g.2xlarge 56711183565
cache.r6g.4xlarge 113609865216
cache.r6g.8xlarge 225000375228
cache.r6g.12xlarge 341206346547
cache.r6g.16xlarge 450000750456
cache.r6gd.xlarge 28261849702
cache.r6gd.2xlarge 56711183565
cache.r6gd.4xlarge 113609865216
cache.r6gd.8xlarge 225000375228
cache.r6gd.12xlarge 341206346547
cache.r6gd.16xlarge 450000750456
cache.r7g.large 14037181030
cache.r7g.xlarge 28261849702
cache.r7g.2xlarge 56711183565
cache.r7g.4xlarge 113609865216
cache.r7g.8xlarge 225000375228
cache.r7g.12xlarge 341206346547
cache.r7g.16xlarge 450000750456
cache.c7gn.large 3317862236
cache.c7gn.xlarge 6854542746
cache.c7gn.2xlarge 13891921715
cache.c7gn.4xlarge 27966669210
cache.c7gn.8xlarge 56116178125
cache.c7gn.12xlarge 84357985997
cache.c7gn.16xlarge 113609865216
注記

現在の世代のインスタンスタイプはすべて、デフォルトで Amazon Virtual Private Cloud VPC で作成されます。

T2 インスタンスは Redis OSS AOF をサポートしていません。

Redis OSS 設定変数 appendonlyおよび appendfsyncはサポートされていません。

Memcached 固有のパラメータ

Memcached

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

Memcached 1.6.17 の変更点

Memcached 1.6.17 以降、lru_crawler、lru、および slabs 管理コマンドはサポートされなくなりました。これらの変更により、lru_crawler コマンドを使ってランタイムで有効または無効にできなくなります。lru_crawler は、カスタムパラメータグループを変更して有効または無効にしてください。

Memcached 1.6.6 で追加されたパラメータ

Memcached 1.6.6 では、追加のパラメータはサポートされません。

パラメータグループファミリー: memcached1.6

Memcached 1.5.10 パラメータの変更

Memcached 1.5.10 では、次のパラメータが追加でサポートされます。

パラメータグループファミリー: memcached1.5

名前 詳細 説明
no_modern

デフォルト: 1

型: ブール値

変更可能: はい

許可された値: 0,1

変更の適用: 起動時

slab_reassign、lru_maintainer_thread、lru_segmented、maxconns_fast コマンドを無効にするためのエイリアス。

Memcached 1.5 以降を使用する場合、no_modern は hash_algorithm を jenkins に設定します。

さらに、Memcached 1.5.10 を使用する場合、inline_ascii_reponse はパラメータ parallelly によって制御されます。つまり、no_modern が無効になっている場合、inline_ascii_reponse は無効になります。Memcached エンジン 1.5.16 以降、inline_ascii_response パラメータは適用されなくなり、no_modern が有効または無効でも inline_ascii_reponse には影響しません。

no_modern が無効になっている場合、slab_reassign、lru_maintainer_thread、lru_segmented、maxconns_fast は有効になります。slab_automove および hash_algorithm パラメータは SWITCH パラメータではないため、設定はパラメータグループの設定に基づきます。

no_modern を無効にして modern に戻す場合は、このパラメータを無効にするようにカスタムパラメータグループを設定し、これらの変更を有効にするために再起動する必要があります。

注記

2021 年 8 月 20 日現在、このパラメータのデフォルトの設定値は 0 から 1 に変更されています。更新されたデフォルト値は、2021 年 8 月 20 日以降、各リージョンの ElastiCache の新規ユーザーによって自動的に取得されます。2021 年 8 月 20 日以前のリージョンで ElastiCache を使用する既存ユーザーは、この新しい変更を取得するためにカスタムパラメータグループを手動で変更する必要があります。
inline_ascii_resp

デフォルト: 0

型: ブール値

変更可能: はい

許可された値: 0,1

変更の適用: 起動時

アイテム内の VALUE レスポンスからの数値が保存されます。最大 24 バイトを使用します。ASCII get、faster セットの小さい減速。

Memcached 1.5.10 では、次のパラメータが削除されます。

名前 詳細 説明
expirezero_does_not_evict

デフォルト: 0

型: ブール値

変更可能: はい

許可された値: 0,1

変更の適用: 起動時

このバージョンではサポートされなくなりました。
modern

デフォルト: 1

型: ブール値

変更可能: はい (no_modern に設定されている場合は再起動が必要です)

許可された値: 0,1

変更の適用: 起動時

このバージョンではサポートされなくなりました。このバージョン以降、起動または再起動するたびに no-modern がデフォルトで有効になります。

Memcached 1.4.34 で追加されたパラメータ

Memcached 1.4.34 では、追加のパラメータはサポートされません。

パラメータグループファミリー: memcached1.4

Memcached 1.4.33 で追加されたパラメータ

Memcached 1.4.33 では、次のパラメータが追加でサポートされます。

パラメータグループファミリー: memcached1.4

名前 詳細 説明
modern

デフォルト: 有効

型: ブール値

変更可能: はい

変更の適用: 起動時

各種機能のエイリアス 有効化 modern は、次のコマンドをオンにし、murmur3 ハッシュアルゴリズム (slab_reassign、slab_automove、lru_crawler、lru_maintainer、maxconns_fast、hash_algorithm=murmur3) を使用する場合と同等です。
watch

デフォルト: 有効

型: ブール値

変更可能: はい

変更の適用: 即時

ログは、watcher_logbuf_size および worker_logbuf_size 制限に達すると削除できます。

ログ取得、削除または変異。たとえば、watch をオンにすると、get、set、delete または update が発生したときにユーザーはログを表示できます。
idle_timeout

デフォルト: 0 (無効)

タイプ: 整数

変更可能: はい

変更の適用: 起動時

閉じる前にクライアントがアイドル状態にできる最小秒数。値の範囲: 0～86400
track_sizes

デフォルト: 無効

型: ブール値

変更可能: はい

変更の適用: 起動時

各スラブグループの消費サイズを表示します。

有効化 track_sizes を行うと、stats sizes を実行せずに stats sizes_enable を実行できます。
watcher_logbuf_size

デフォルト: 256 (KB)

タイプ: 整数

変更可能: はい

変更の適用: 起動時

watch コマンドは、Memcached の配信ログ作成をオンにします。ただし、削除、変異、取得によって、ロギングバッファがいっぱいになる可能性がある場合には、watch でログを削除することができます。このような場合、ユーザーは、バッファサイズを増やして、ログ損失の可能性を抑えることができます。
worker_logbuf_size

デフォルト: 64 (KB)

タイプ: 整数

変更可能: はい

変更の適用: 起動時

watch コマンドは、Memcached の配信ログ作成をオンにします。ただし、削除、変異、取得によって、ロギングバッファがいっぱいになる可能性がある場合には、watch でログを削除することができます。このような場合、ユーザーは、バッファサイズを増やして、ログ損失の可能性を抑えることができます。
slab_chunk_max

デフォルト: 524288 (バイト)

タイプ: 整数

変更可能: はい

変更の適用: 起動時

スラブの最大サイズを指定します。スラブサイズを小さくすると、メモリは効率的に使用されます。slab_chunk_max より大きい項目は、複数のスラブに分割されます。
lru_crawler metadump [all|1|2|3]

デフォルト: 無効

型: ブール値

変更可能: はい

変更の適用: 即時

lru_crawler を有効化すると、このコマンドによってすべてのキーがダンプされます。

all|1|2|3 - すべてのスラブ、または特定のスラブ数を指定する

Memcached 1.4.24 で追加されたパラメータ

Memcached 1.4.24 では、次のパラメータが追加でサポートされます。

パラメータグループファミリー: memcached1.4

名前 詳細 説明
disable_flush_all

デフォルト: 0 (無効)

型: ブール値

変更可能: はい

変更の適用: 起動時

flush_all を無効化するパラメータ (-F) を追加します。本稼働インスタンスでフルフラッシュを実行しない場合に便利です。

値: 0、1 (値が 0 の場合にユーザーは flush_all を実行できます。)
hash_algorithm

デフォルト: jenkins

タイプ: 文字列

変更可能: はい

変更の適用: 起動時

 使用されるハッシュアルゴリズム。使用可能な値: murmur3 と jenkins。
lru_crawler

デフォルト: 0 (無効)

型: ブール値

変更可能: はい

変更の適用: 再起動後

注記

実行時に、コマンドラインから lru_crawler を一時的に有効にすることができます。詳細については、「Describe」列を参照してください。

期限が切れた項目のスラブクラスを消去します。これにより、バックグラウンドで実行されるプロセスの影響を小さくなります。現在は、手動コマンドを使用して Crawl を起動する必要があります。

一時的に有効にするには、コマンドラインで lru_crawler enable を実行します。

lru_crawler 1,3,5 はスラブクラス 1、3、5 をクロールし、freelist に追加する期限切れの項目を検索します。

値: 0、1

注記

コマンドラインで lru_crawler を有効にして、コマンドラインまたは次の再起動で無効化されるまでクローラを有効にします。永続的に有効にするには、パラメータ値を変更する必要があります。詳細については、「ElastiCache パラメータグループを変更する」を参照してください。
lru_maintainer

デフォルト: 0 (無効)

型: ブール値

変更可能: はい

変更の適用: 起動時

容量に到達すると LRU 間で項目をシャッフルするバックグラウンドスレッドです。値: 0、1。
expirezero_does_not_evict

デフォルト: 0 (無効)

型: ブール値

変更可能: はい

変更の適用: 起動時

lru_maintainer と併用すると、項目の期限切れ時間が 0 (期限切れなし) になります。

警告

これにより、期限切れでクリアされる他の項目をメモリから排除して、メモリを使用できるようにすることができます。

lru_maintainer を無視するよう設定できます。

Memcached 1.4.14 で追加されたパラメータ

Memcached 1.4.14 では、次のパラメータが追加でサポートされます。

パラメータグループファミリー: memcached1.4

Memcached 1.4.14 で追加されたパラメータ
名前 詳細 説明
config_max

デフォルト: 16

タイプ: 整数

変更可能: いいえ

 ElastiCache 設定エントリの最大数。
config_size_max

デフォルト: 65536

タイプ: 整数

変更可能: いいえ

 設定エントリの最大サイズ (バイト単位)。
hashpower_init

デフォルト: 16

タイプ: 整数

変更可能: いいえ

 ElastiCache ハッシュテーブルの初期サイズは、2 の累乗として表されます。デフォルトは 16 (2^16)、つまり 65536 のキーです。
maxconns_fast

デフォルト: 0 (false)

タイプ: ブール値

変更可能: はい

変更の適用: 再起動後

 最大接続制限に達したときに新しい接続リクエストを処理する方法を変更します。このパラメータを 0 (ゼロ) に設定した場合、新しい接続がバックログキューに追加され、他の接続が終了するまで待機します。パラメータを 1 に設定した場合、ElastiCache はクライアントにエラーを送信し、すぐに接続を終了します。
slab_automove

デフォルト: 0

タイプ: 整数

変更可能: はい

変更の適用: 再起動後

 スラブ自動移動アルゴリズムを調整します。このパラメータを 0 (ゼロ) に設定した場合、自動移動アルゴリズムは無効です。1 に設定した場合、ElastiCache は低速で控えめな手法を使用して、スラブを自動的に移動します。2 に設定した場合、削除が生じると必ず ElastiCache はスラブを積極的に移動します (このモードは、テスト目的以外では推奨されません)。
slab_reassign

デフォルト: 0 (false)

タイプ: ブール値

変更可能: はい

変更の適用: 再起動後

 スラブの再割り当てを有効または無効にします。このパラメータを 1 に設定した場合、「slabs reassign」コマンドを使用してメモリを手動で再割り当てできます。

Memcached 1.4.5 でサポートされているパラメータ

パラメータグループファミリー: memcached1.4

Memcached 1.4.5 では、さらに次のパラメータがサポートされています。

Memcached 1.4.5 で追加されたパラメータ
名前 詳細 説明
backlog_queue_limit

デフォルト: 1024

タイプ: 整数

変更可能: いいえ

 バックログキューの制限。
binding_protocol

デフォルト: auto

タイプ: 文字列

変更可能: はい

変更の適用: 再起動後

 バインディングプロトコル。

許可される値は ascii および auto です。

binding_protocol の値を変更する際のガイダンスについては、「ElastiCache パラメータグループを変更する」を参照してください。
cas_disabled

デフォルト: 0 (false)

タイプ: ブール値

変更可能: はい

変更の適用: 再起動後

 1 (true) の場合、CAS (Check and Set) 操作が無効になり、格納されている項目が消費するバイト数は CAS が有効な場合より 8 バイト少なくなります。
chunk_size

デフォルト: 48

タイプ: 整数

変更可能: はい

変更の適用: 再起動後

 最も小さい項目のキー、値、およびフラグ (バイト単位) に割り当てる領域の最小量 (バイト単位)。
chunk_size_growth_factor

デフォルト: 1.25

タイプ: 浮動小数点

変更可能: はい

変更の適用: 再起動後

 連続する各 memcached チャンクのサイズを制御する増加係数。各チャンクは、前のチャンクより chunk_size_growth_factor 倍大きくなります。
error_on_memory_exhausted

デフォルト: 0 (false)

タイプ: ブール値

変更可能: はい

変更の適用: 再起動後

 1 (true) の場合、項目を保存するメモリがないと、Memcached によって項目が削除されるのではなくエラーが返されます。
large_memory_pages

デフォルト: 0 (false)

タイプ: ブール値

変更可能: いいえ

 1 (true) の場合、ElastiCache は大量のメモリページを使用しようとします。
lock_down_paged_memory

デフォルト: 0 (false)

タイプ: ブール値

変更可能: いいえ

 1 (true) の場合、ElastiCache はすべてのページ分割メモリをロックダウンします。
max_item_size

デフォルト: 1048576

タイプ: 整数

変更可能: はい

変更の適用: 再起動後

 クラスターに保存できる最も大きい項目のサイズ (バイト単位)。
max_simultaneous_connections

デフォルト: 65000

タイプ: 整数

変更可能: いいえ

 同時接続の最大数。
maximize_core_file_limit

デフォルト: 0 (false)

タイプ: ブール値

変更可能:

変更の適用: 再起動後

 1 (true) の場合、ElastiCache はコアファイルの制限を最大限に高くします。
memcached_connections_overhead

デフォルト: 100

タイプ: 整数

変更可能: はい

変更の適用: 再起動後

 Memcached 接続および他のさまざまなオーバーヘッド用に予約されるメモリの量。このパラメータの詳細については、「Memcached 接続オーバーヘッド」を参照してください。
requests_per_event

デフォルト: 20

タイプ: 整数

変更可能: いいえ

 特定の接続のイベントごとの最大リクエスト数。この制限は、リソース不足を防ぐために必要です。

Memcached 接続オーバーヘッド

各ノードで、項目の保存に使用可能なメモリは、ノード上の使用可能な合計メモリ (max_cache_memory パラメータ内) から、接続や他のオーバーヘッドに使用されているメモリ (memcached_connections_overhead パラメータ内) を引いた量です。たとえば、 タイプのノードの cache.m5.largeは 6537MB max_cache_memoryです。memcached_connections_overhead デフォルト値が 100MB の場合、Memcached プロセスでは項目を保存するために 6437MB を使用できます。

memcached_connections_overhead パラメータのデフォルト値は、ほとんどのユースケースに適しています。ただし、接続オーバーヘッドの割り当てに必要な量は、リクエストの頻度、ペイロードサイズ、接続数など、複数の要因によって変化します。

アプリケーションのニーズにさらに合うように memcached_connections_overhead の値を変更できます。たとえば、memcached_connections_overhead パラメータの値を大きくすると、項目の保存に使用できるメモリの量が減り、接続のオーバーヘッド用のバッファが増えます。memcached_connections_overhead パラメータの値を小さくすると、項目の保存に使用できるメモリは増えますが、スワップの使用とパフォーマンスの低下のリスクが高くなります。スワップの使用やパフォーマンスの低下が観察される場合、memcached_connections_overhead パラメータの値を大きくしてみてください。

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

ほとんどのパラメータの値は 1 つですが、一部のパラメータには、使用されているノードタイプによって複数の値が設定されることがあります。次の表は、各ノードタイプの max_cache_memory パラメータと num_threads パラメータのデフォルト値を示しています。これらのパラメータの値は変更できません。

ノードタイプ max_cache_memory (メガバイト) num_threads
cache.t2.micro 555 1
cache.t2.small 1588 1
cache.t2.medium 3301 2
cache.t3.micro 512 2
cache.t3.small 1402 2
cache.t3.medium 3364 2
cache.t4g.micro 512 2
cache.t4g.small 1402 2
cache.t4g.medium 3164 2
cache.m4.large 6573 2
cache.m4.xlarge 11496 4
cache.m4.2xlarge 30412 8
cache.m4.4xlarge 62234 16
cache.m4.10xlarge 158355 40
cache.m5.large 6537 2
cache.m5.xlarge 13248 4
cache.m5.2xlarge 26671 8
cache.m5.4xlarge 53516 16
cache.m5.12xlarge 160900 48
cache.m5.24xlarge 321865 96
cache.m6g.large 6537 2
cache.m6g.xlarge 13248 4
cache.m6g.2xlarge 26671 8
cache.m6g.4xlarge 53516 16
cache.m6g.8xlarge 107000 32
cache.m6g.12xlarge 160900 48
cache.m6g.16xlarge 214577 64
cache.m7g.large 6537 2
cache.m7g.xlarge 13248 4
cache.m7g.2xlarge 26671 8
cache.m7g.4xlarge 53516 16
cache.m7g.8xlarge 107000 32
cache.m7g.12xlarge 160900 48
cache.m7g.16xlarge 214577 64
cache.m8g.large 6956 2
cache.m8g.xlarge 14517 4
cache.m8g.2xlarge 30390 8
cache.m8g.4xlarge 62806 16
cache.m8g.8xlarge 127638 32
cache.m8g.12xlarge 192470 48
cache.m8g.16xlarge 257302 64
cache.r4.large 12590 2
cache.r4.xlarge 25652 4
cache.r4.2xlarge 51686 8
cache.r4.4xlarge 103815 16
cache.r4.8xlarge 208144 32
cache.r4.16xlarge 416776 64
cache.r5.large 13387 2
cache.r5.xlarge 26953 4
cache.r5.2xlarge 54084 8
cache.r5.4xlarge 108347 16
cache.r5.12xlarge 325400 48
cache.r5.24xlarge 650869 96
cache.r6g.large 13387 2
cache.r6g.xlarge 26953 4
cache.r6g.2xlarge 54084 8
cache.r6g.4xlarge 108347 16
cache.r6g.8xlarge 214577 32
cache.r6g.12xlarge 325400 48
cache.r6g.16xlarge 429154 64
cache.r7g.large 13387 2
cache.r7g.xlarge 26953 4
cache.r7g.2xlarge 54084 8
cache.r7g.4xlarge 108347 16
cache.r7g.8xlarge 214577 32
cache.r7g.12xlarge 325400 48
cache.r7g.16xlarge 429154 64
cache.r8g.large 14517 2
cache.r8g.xlarge 30390 4
cache.r8g.2xlarge 62806 8
cache.r8g.4xlarge 127638 16
cache.r8g.8xlarge 257302 32
cache.r8g.12xlarge 386966 48
cache.r8g.16xlarge 516630 64
cache.c7gn.large 3164 2
cache.c7gn.xlarge 6537 4
cache.c7gn.2xlarge 13248 8
cache.c7gn.4xlarge 26671 16
cache.c7gn.8xlarge 53516 32
cache.c7gn.12xlarge 325400 48
cache.c7gn.16xlarge 108347 64
cache.c8gn.large 3176 2
cache.c8gn.xlarge 6956 4
cache.c8gn.2xlarge 14517 8
cache.c8gn.4xlarge 30390 16
cache.c8gn.8xlarge 62806 32
cache.c8gn.12xlarge 95222 48
cache.c8gn.16xlarge 127638 64
注記

すべての T2 インスタンスは、Amazon Virtual Private Cloud (Amazon VPC) で作成されます。