Redisで整数値をインクリメントする方法 – INCR・INCRBYコマンドの使い方
このチュートリアルでは、Redisデータストア内のキーに保存された整数値を表す文字列を、INCRコマンドとINCRBYコマンドを使ってインクリメント(数値を増加させる)する方法を解説します。アクセスカウンターやいいね数の管理など、カウンター機能の実装で頻繁に使われる重要なコマンドなので、しっかり理解しておきましょう。
INCRコマンドとは
INCRコマンドは、指定したキーに保存されている整数値を表す文字列を「1」だけ増加させます。主な仕様は以下の通りです。
- キーが存在しない場合は、まず新しく作成され、値が「0」に設定された上でインクリメントが実行されます(結果として「1」が返ります)。
- キーが存在していても、値のデータ型が文字列型以外の場合や、整数として解釈できない文字列が格納されている場合は、エラーが返されます。
- この操作は64ビット符号付き整数の範囲に制限されます。
構文
redis host:post> INCR <keyname>
戻り値
- (integer) インクリメント操作後のキーの値
実行例

INCRBYコマンドとは
INCRBYコマンドは、キーに保存されている整数値を、指定した値だけ増加させます。INCRコマンドとの違いは、INCRが常に「1」ずつ増加させるのに対し、INCRBYでは任意の増分(increment)を指定できる点です。たとえば、カウンターを一度に10ずつ増やしたい場合などに便利です。
構文
redis host:post> INCRBY <keyname> <increment>
戻り値
- (integer) インクリメント操作後のキーの値
実行例

参考リンク
- INCRコマンド公式ドキュメント
- INCRBYコマンド公式ドキュメント
以上、Redisデータストアに保存された整数値をインクリメントする方法についての解説でした。この記事が役に立ったと思ったら、ぜひコメント欄でご意見をお聞かせください。また、周りの方にもシェアしていただけると嬉しいです。
< 文字列(String)コマンド一覧へ戻る
-
Redis ZINCRBYコマンドの使い方 – Redisでソート済みセットの要素スコアをインクリメントする方法
このチュートリアルでは、Redisデータストアに保存されたソート済みセット(Sorted Set)型の値について、特定の要素のスコアをインクリメントする方法を学びます。この操作には、redis-cliでZINCRBYコマンドを使用します。 ZINCRBYコマンドは、キーに保存されているソート済みセットの値の中から指定した要素を探し、そのスコアを指定した値(increment)だけ増加させるために使用します。もし指定した要素がソート済みセット内に存在しない場合は、その要素が新しく追加され、指定したincrement値がスコアとして設定されます。また、キー自体が存在しない場合には、指定した要素のみ
-
Redis GEOPOSコマンドの使い方 – 地理空間データからメンバーの経度・緯度を取得する方法
このチュートリアルでは、Redisに保存された地理空間値(ジオ空間データ)から、1つまたは複数のメンバーの経度・緯度を取得する方法を解説します。この操作には、RedisのGEOPOSコマンドを使用します。 GEOPOSコマンドとは GEOPOSコマンドは、キーに保存された地理空間値(ソート済みセット)の中から、指定した1つ以上のメンバーの経度・緯度を返すためのコマンドです。 GEOADDコマンドで座標(経度・緯度)を地理空間値に挿入する際、それらの値は52ビットのGeohashに変換されます。そのため、GEOPOSで取得される座標は、挿入時に入力した値と完全に一致するとは限らず、わずかな誤差が