Redis LINSERTコマンドの使い方 – ピボット要素の前後にリストへ要素を挿入する方法
このチュートリアルでは、RedisのLINSERTコマンドを使用して、キーに保存されたリスト値の中で、ピボット(基準)となる要素の前または後に新しい要素を挿入する方法を解説します。
LINSERTコマンドとは
LINSERTコマンドは、指定したキーに保存されているリスト値に対して、特定の要素(ピボット)の前か後に新しい要素を挿入します。キーが存在しない場合は空のリストとして扱われ、戻り値として0が返されます。また、キー自体は存在するものの、ピボットとなる要素がリスト内に見つからない場合は-1が返されます。
Redis LINSERTコマンドの構文は以下の通りです。
構文
redis host:post> LINSERT <key name> [BEFORE|AFTER] <pivot element> <new element>
戻り値
- (integer) リスト内の要素数を表す整数値。 - -1:キーは存在するが、ピボット要素がリスト内に存在しない場合。 - 0:キーが存在しない場合。 - エラー:キーは存在するが、そのキーに保存されている値がリスト型ではない場合。
使用例

参考資料
- LINSERTコマンド公式ドキュメント
まとめ
以上、Redisデータストアに保存されたリスト値に対して、LINSERTコマンドを使ってピボット要素の前または後に新しい要素を挿入する方法についての解説でした。リストの途中に柔軟に要素を追加できるため、順序付きデータの管理に非常に便利なコマンドです。
この記事が役に立ったと感じていただけたなら、ぜひコメント欄でご感想をお聞かせください。また、周囲の方々とのシェアも大歓迎です。
<- リストコマンド一覧へ戻る
-
Redisリスト入門:リスト型の値を管理するための主要コマンド一覧
Redisリストとは Redisのリスト(List)は、挿入された順番どおりに並べられた文字列のシーケンスです。Redisでは、このリストをキーに対する値として保存することができます。さらに、さまざまなRedisコマンドを組み合わせることで、データベースに格納されたリスト値の保存・管理・取得を柔軟に行えます。 構文 redis host:post> <Command Name> <key name> 実行例 Redisリスト操作の主なコマンド一覧 Redisデータベース内のリスト値を管理するうえで押さえておきたい重要なコマンドを、以下の表にまとめました。
-
Redis LRANGEコマンドの使い方 – リスト値の全要素を取得する方法を解説
このチュートリアルでは、Redisデータストアに保存されたキーのリスト値から、すべての要素を取得する方法を解説します。そのために使用するのが、RedisのLRANGEコマンドです。 LRANGEコマンドとは LRANGEコマンドは、指定したキーに保存されているリスト値から、指定されたオフセット(範囲)に基づいて1つ以上の要素を返すコマンドです。開始位置(start)と終了位置(end)の2つの引数を受け取り、どちらも範囲に含まれます。 これらのオフセットは0始まりのインデックスで指定します。つまり、「0」が最初の要素、「1」が2番目の要素を意味します。また、負の数を使うことでリストの末尾からの