サポート対象の Redis 構成

このページでは、Memorystore for Redis で使用できる maxmemory ポリシーとその他の Redis 構成について説明します。構成を調整する場合、Redis インスタンスを再起動する必要はありません。

下記の構成を変更する手順については、Redis インスタンスの構成をご覧ください。

maxmemory ポリシー

Redis インスタンスのメモリがいっぱいになり、新しい書き込みが発生すると、Redis はキーのエビクションを行い、インスタンスの maxmemory ポリシーに基づいて書き込み用にスペースを確保します。Memorystore for Redis のデフォルトの maxmemory ポリシーは volatile-lru です。次のいずれかの maxmemory ポリシーを使用することもできます。

• noeviction: Redis インスタンスが maxmemory に達するとエラーを返します。データの上書きや削除は行いません。
• allkeys-lfu: Redis バージョン 4.0 以降で使用できます。キーセット全体から、使用頻度の最も低い（LFU）キーを削除します。
• allkeys-lru: キーセット全体から、最も長い間使用されていない（LRU）キーを削除します。
• volatile-lfu: Redis バージョン 4.0 以降で使用できます。TTL（有効期間）期限が設定されている、使用頻度の低いキーを削除します。
• volatile-lru: TTL 期限が設定されている、最も長い間使用されていない（LRU）キーを削除します。
• allkeys-random: キースペース全体からランダムにキーを削除します。
• volatile-random：TTL 期限が設定されたキーの中から、ランダムにキーを削除します。
• volatile-ttl: TTL 期限が設定されたキーのうち、最も短い TTL を持つキーを削除します。

変更可能な構成パラメータ

Memorystore for Redis インスタンスを作成または更新する際に、次のパラメータを変更できます。

パラメータ	説明	使用できる値
activedefrag	Redis バージョン 4.0 以降。標準的な OSS Redis メモリ フラグメンテーション動作によって結び付けられたインスタンス メモリを解放します。	no（デフォルト） yes
データベース	Redis バージョン 3.2 以降。Redis サーバー上のデータベースの数を指定します。	1-100 デフォルトは 16 です。
lazyfree-lazy-eviction	Redis バージョン 7.0 以降。Eviction で Lazy Free を有効または無効にします。no は、この構成を無効にします。詳細については、REDIS.CONF をご覧ください。	no（デフォルト） yes
lazyfree-lazy-expire	Redis バージョン 7.0 以降。Expire で Lazy Free を有効または無効にします。no は、この構成を無効にします。詳細については、REDIS.CONF をご覧ください。	no（デフォルト） yes
lazyfree-lazy-user-del	Redis バージョン 7.0 以降。ユーザー DEL の Lazy Free を有効または無効にします。no は、この構成を無効にします。詳細については、REDIS.CONF をご覧ください。	no（デフォルト） yes
lazyfree-lazy-user-flush	Redis バージョン 7.0 以降。User Flash で Lazy Free を有効または無効にします。no は、この構成を無効にします。詳細については、REDIS.CONF をご覧ください。	no（デフォルト） yes
lfu-decay-time	Redis バージョン 4.0 以降。分単位の時間。LFU より前では、指定されたキーの頻度カウンタを 2 で割った値（または、カウンタが 10 未満の場合は 1 減少させた数）。詳細については、REDIS.CONF ファイルをご覧ください。	「long」データ型の正の整数 （デフォルトは 1）
lfu-log-factor	Redis バージョン 4.0 以降。頻度カウンタがキーのヒットを表す方法を決定します。デフォルトの構成を変更する前に、REDIS.CONF ファイルで lfu-log-factor 構成がどのように機能するかをご覧ください。	「long」データ型の正の整数 （デフォルトは 10）
maxmemory-clients	Redis 7.0 以降。この構成を使用すると、ユーザーはクライアントの最大メモリ使用量を制御できます。 通常/pubsub クライアントの合計メモリ使用量。上限に達すると、メモリ使用量が最も多いクライアントが強制排除されます。	デフォルトは 0%（無制限）です。指定できる値は、0%～100% の整数値です。クライアント ストレージが制限されるインスタンスの maxmemory の割合を表します。
maxmemory-gb	エビクション ポリシーを有効にする調整可能な上限を指定します。たとえば、10 GB のインスタンスがあり、maxmemory-gb を 8 に設定した場合、データがインスタンス メモリを 8 GB 占有したときにエビクション ポリシーが有効になります。これにより、オーバーヘッドとして 2 GB のメモリが残ります。デフォルトでは、maxmemory-gb がインスタンスの容量に設定されています。maxmemory-gb 構成の最適な使用方法の詳細については、Memorystore のメモリ管理のベスト プラクティスをご覧ください。 この構成は、Google Cloud コンソールで maxmemory-percent として表示されます。コンソールを使用する場合は、特定の GB 数ではなく、インスタンス容量の割合として maxmemory-percent を設定します。	GB 数。整数または小数で表します。 例: 10 は、10 GB の maxmemory-gb を指定します。 1.5 は 1.5 GB の maxmemory-gb を指定します。 maxmemory-gb はインスタンスの容量の最小 20% に減らすことができます。
maxmemory-policy	インスタンス データが maxmemory-gb の上限に達すると Redis が行う動作を指定します。各ポリシーの動作については、Maxmemory ポリシーをご覧ください。 オープンソースの Redis maxmemory ポリシーについてさらに詳しくは、オープンソースの Redis の LRU キャッシュ ページをご覧ください。	noeviction allkeys-lru volatile-lru（デフォルト） allkeys-random volatile-random volatile-ttl volatile-lfu（Redis バージョン 4.0 以降） allkeys-lfu（Redis バージョン 4.0 以降）
notify-keyspace-events	特定のキースペース イベントの通知をクライアントに登録できるようにします。詳細については、Redis サイトの Redis キースペースの通知のページをご覧ください。	""（デフォルト） K キースペース イベント。__keyspace@__ 接頭辞付きで公開されます。 E キーイベント イベント。__keyevent@__ 接頭辞付きで公開されます。 g DEL、EXPFire、RENAME などの一般的なコマンド $ 文字列コマンド l リストコマンド s セットコマンド h ハッシュ コマンド z ソートされたセットコマンド x 期限切れイベント（キーが期限切れになるたびに生成されるイベント） e 削除イベント（maxmemory のためにキーが削除された場合に生成されるイベント） A g$lshzxe のエイリアス。したがって、"AKE" 文字列は全イベントを意味します。
stream-node-max-bytes	Redis バージョン 5.0 以降。Redis ストリームのデータ構造では、基数ツリーを使用して項目を保存します。stream-node-max-bytes パラメータは、単一のツリーノードにアイテムを格納できる最大バイト数を指定します。この上限に達すると、新しい項目が新しいツリーノードに保存されます。	0 以上の整数。 （デフォルトは 4,096） 0 は、サイズが無制限のツリーノードを示します。
stream-node-max-entries	Redis バージョン 5.0 以降。Redis ストリームのデータ構造では、基数ツリーを使用して項目を保存します。stream-node-max-entries パラメータは、単一ノードに保存できる項目数を指定します。この上限に達すると、新しい項目が新しいツリーノードに保存されます。	0 以上の整数。 （デフォルトは 100） 0 は、アイテム数が無制限のツリーノードを示します。
timeout	アイドル状態のクライアント接続が終了するまでの秒数。ただし、timeout が 0 に設定されている場合、アイドル状態のクライアントはタイムアウトせず、クライアントが終了を発行するまで接続を維持します。	0（デフォルト） 整数 >= 120 単位 = 秒

変更不可の構成パラメータ

次の表に、Redis の Memorystore で変更できない Redis 構成パラメータとそのデフォルト値を示します。これらの構成パラメータの詳細については、Redis の構成ドキュメントをご覧ください。

パラメータ	デフォルト値
lua-time-limit	5000
hash-max-ziplist-entries	2048
hash-max-ziplist-value	1024
list-max-ziplist-size	-2
list-compress-depth .	0
set-max-intset-entries	512
zset-max-ziplist-entries	1024
zset-max-ziplist-value	1024
hll-sparse-max-byte	3000
activerehashing	○
hz	10
databases	16
maxclients	65000
slowlog-log-slower-than	10000
slowlog-max-len	128
repl-diskless-load	swapdb
io-threads-do-reads	○

次のステップ

• オープンソースの [Redis 構成] ページで Redis 構成の詳細を学ぶ。