Redis GETSETコマンドの使い方 – キーに新しい文字列値を設定し、古い値を取得する方法

このチュートリアルでは、RedisのGETSETコマンドを使って、指定したキーに新しい文字列値を設定すると同時に、古い文字列値を取得する方法を解説します。

GETSETコマンドとは

GETSETコマンドは、指定したキーに新しい文字列値を設定し、そのキーに以前保存されていた古い文字列値を返すコマンドです。このコマンドは「値の読み取りと書き込みをアトミック（不可分）に実行したい場合」などに便利で、カウンターのリセットや状態の入れ替え処理などによく使われます。

動作のポイントは以下の通りです。

• キーが存在しない場合は (nil) を返します
• キーは存在するが、保存されている値が文字列型ではない場合はエラーを返します

構文

redis host:port> GETSET <keyname> <value>

戻り値

(string) キーに保存されていた古い文字列値を返します。
(nil) キーが存在しない場合に返します。
エラー キーは存在するが、値が文字列型ではない場合に返します。

使用例

以下は、GETSETコマンドを実行した際の実際の出力例です。まず SET コマンドでキーに値を設定し、その後 GETSET コマンドで新しい値を設定すると、古い値が返されていることが確認できます。

# キーに初期値を設定
redis host:port> SET mykey "old-value"
OK

# 新しい値を設定し、古い値を取得
redis host:port> GETSET mykey "new-value"
"old-value"

# 存在しないキーに対して実行
redis host:port> GETSET newkey "value"
(nil)

参考資料

1. Redis公式ドキュメント：GETSETコマンド

以上が、Redisデータストア内のキーに新しい文字列値を設定しつつ、古い文字列値を取得する方法の解説でした。この記事が役に立ったと思われた方は、ぜひコメント欄でご意見をお聞かせください。また、他の方にもシェアしていただけると嬉しいです。