KVSとしてのRedisに入門しgo-redisとrueidisから触ってみる
はじめに
この記事はRedis
のKVS機能に入門しつつGoライブラリのgo-redis
とrueidis
を比較してみようという内容です。
先日、twitterを眺めていたところrueidis
というRedis
のGoライブラリを知りました。
これまで私はgo-redis
を使っていたのですが、supports client side caching.
という一文が気になり使ってみたくなりました。
ついでにこのタイミングでなんとなく使っていたRedisについて改めて入門してみようと思いました。
Redis
に入門するにあたって公式ドキュメントだと私には分かりづらいところがあったので以下の書籍も参考にしています。
「実践Redis入門 技術の仕組みから現場の活用まで」
Redisとは
公式サイトには以下のような記載があります。
The open source, in-memory data store used by millions of developers as a database, cache, streaming engine, and message broker.
データベース、キャッシュ、ストリーミングエンジン、メッセージブローカーです。
インメモリのデータストアであるので高速に動作することが可能です。
データストアの形式としてはNoSQL
と呼ばれるものに分類されます。
KVS
として気軽に利用できる一方でRDB
のような柔軟さはないかと思います。
また、Redis
はデータ型さまざまなものをサポートしています。
- String型
- List型
- Hash型
- Set型
- Sorted Set型
いまのところ、私的にString型しか需要がないので今回の記事としてはスコープをString型に絞っています。
String型:文字列
シンプルなキーと値の組みあわせです。
Redis
においては数値なども文字列に含まれます。
また、バイナリーセーフなため、画像や実行ファイルなど文字列以外もこの型で保存できます。
go-redis
基本の使い方
import goredis "github.com/redis/go-redis/v9"
func main() {
ctx := context.Background()
// クライアントの初期化
redis := goredis.NewClient(&goredis.Options{Addr: "127.0.0.1:6370"})
// 疎通確認
if err := redis.Ping(ctx).Err(); err != nil {
panic(err)
}
defer redis.Close()
// コマンドの組み立て
cmd := redis.Set(ctx, "key", "value", goredis.KeepTTL)
// 実行(取得系:結果が必要な場合)
if val, err := cmd.Result(); err != nil {
panic(err)
} else {
log.Printf("%s", val)
}
// 実行(保存系:結果が不要な場合)
if err := cmd.Err(); err != nil {
panic(err)
}
}
- メソッドの引数に必要な要素を与えてコマンドを作成する
- 結果が必要な場合は
Result()
を実行し第一戻り値特定の型(実行するコマンドによって異なる)を受け取る - 結果が不要な場合は
Err()
を実行しエラーを受け取る
rueidis
基本の使い方
import "github.com/redis/rueidis"
func main() {
ctx := context.Background()
// クライアントの初期化
redis, err := rueidis.NewClient(rueidis.ClientOption{InitAddress: []string{"127.0.0.1:6370"}})
if err != nil {
panic(err)
}
// 疎通確認
if err := redis.Do(ctx, redis.B().Ping().Build()).Error(); err != nil {
panic(err)
}
defer redis.Close()
// コマンドの組み立て
cmd := redis.B().Set().Key("key").Value("value").Build()
// 実行(取得系:結果が必要な場合)
// ToXxx or AsXxxで型を指定できる
if val, err := redis.Do(ctx, cmd).ToString(); err != nil {
panic(err)
} else {
log.Printf("%s", val)
}
// 実行(保存系:結果が不要な場合)
if err := redis.Do(ctx, cmd).Error(); err != nil {
panic(err)
}
}
- ビルダーパターンでコマンドを組み立てる
- 結果が必要な場合は
ToXxx()
またはAsXxx()
で型を指定する - 結果が不要な場合は
Error()
を実行しエラーを受け取る
Commands
ここから標準的なユースケースで使いそうなRedis
のCommandsにredis-cliを使って動作を確認し、
そのコマンドがGoライブラリでどのように実装できるのか見ていきます。
SET <key> <value>
指定したキーに対して値を設定することができます。
※ TTL: Time To Live (有効期限)
# redis-cli
127.0.0.1:6379:> SET key value
OK
127.0.0.1:6379:> GET key
"value"
// go-redis
// TTLを設定しない場合は`goredis.KeepTTL`を指定する
cmd := redis.Set(ctx, "key", "value", goredis.KeepTTL)
if err := cmd.Err(); err != nil {
log.Println(err)
}
// rueidis
cmd := redis.B().Set().Key("key").Value("value").Build()
if err := redis.Do(ctx, cmd).Error(); err != nil {
log.Println(err)
}
EXオプションを使用してTTLを設定することができます。
# redis-cli
127.0.0.1:6379> SET key value EX 10
OK
127.0.0.1:6379> GET key
"value"
# 10秒後
127.0.0.1:6379> GET key
(nil)
// go-redis
cmd := redis.Set(ctx, "key", "value", 10*time.Second)
if err := cmd.Err(); err != nil {
log.Println(err)
}
// rueidis
cmd := redis.B().Set().Key("key").Value("value").ExSeconds(10).Build()
if err := redis.Do(ctx, cmd).Error(); err != nil {
log.Println(err)
}
NXオプションを使用すると、キーが存在しない場合のみ値をセットすることができます。
# redis-cli
127.0.0.1:6379> SET key value NX
OK
127.0.0.1:6379> SET key val NX
(nil)
127.0.0.1:6379> GET key
"value"
// go-redis
cmd := redis.SetNX(ctx, "key", "value", 10*time.Second)
if err := cmd.Err(); err != nil {
log.Println(err)
}
// rueidis
cmd := redis.B().Set().Key("key").Value("value").Nx().Build()
if err := redis.Do(ctx, cmd).Error(); err != nil {
log.Println(err)
}
XXオプションを使用すると、キーが存在する場合のみ値をセットすることができます。
# redis-cli
127.0.0.1:6379> SET key value XX
(nil)
127.0.0.1:6379> GET key
(nil)
127.0.0.1:6379> SET key value
OK
127.0.0.1:6379> GET key
"value"
127.0.0.1:6379> SET key val XX
OK
127.0.0.1:6379> GET key
"val"
// go-redis
cmd := redis.SetXX(ctx, "key", "value", 10*time.Second)
if err := cmd.Err(); err != nil {
log.Println(err)
}
// rueidis
cmd := redis.B().Set().Key("key").Value("value").Xx().Build()
if err := redis.Do(ctx, cmd).Error(); err != nil {
log.Println(err)
}
GET <key>
SETを用いて保存したkeyの値を取得します。
指定したkeyが存在しない場合はnilを返します。
# redis-cli
127.0.0.1:6379> SET key value
OK
127.0.0.1:6379> GET key
"value"
127.0.0.1:6379> GET k
(nil)
// go-redis
cmd := redis.Get(ctx, "key")
if res, err := cmd.Result(); err != nil {
log.Println(err)
} else {
log.Printf("%s", res)
}
// rueidis
cmd := redis.B().Get().Key(key).Build()
if val, err := redis.Do(ctx, cmd).ToString(); err != nil {
log.Println(err)
} else {
log.Printf("GET key: %s, value: %s", key, val)
}
MSET <key> <value> [<key> <value> ...]
指定したキーと値のペアを複数設定することができます。
MSETはアトミックであるため指定されたすべてのキーを一度に設定することができます。
# redis-cli
127.0.0.1:6379:> MSET key1 value1 key2 value2 key3 value3
OK
// go-redis
cmd := redis.MSet(ctx, "key1", "value1", "key2", "value2", "key3", "value3")
if err := cmd.Err(); err != nil {
log.Println(err)
}
// rueidis
cmd1 := redis.B().Set().Key("key1").Value("val1").Build()
cmd2 := redis.B().Set().Key("key2").Value("val2").Build()
cmd3 := redis.B().Set().Key("key3").Value("val3").Build()
for _, res := range redis.DoMulti(ctx, cmd1, cmd2, cmd3) {
if err := res.Error(); err != nil {
log.Println(err)
}
}
MGET <key> [<key> ...]
指定されたキーの値を取得することができます。
# redis-cli
127.0.0.1:6379:> MGET key1 key2 key3
1) "value1"
2) "value2"
3) "value3"
// go-redis
cmd := redis.MGet(ctx, "key1", "key2", "key3")
if res, err := cmd.Result(); err != nil {
log.Println(err)
} else {
log.Printf("%v", res)
}
// rueidis
cmd1 := redis.B().Get().Key("key1").Build()
cmd2 := redis.B().Get().Key("key2").Build()
cmd3 := redis.B().Get().Key("key3").Build()
for _, res := range redis.DoMulti(ctx, cmd1, cmd2, cmd3) {
if val, err := res.ToString(); err != nil {
log.Println(err)
} else {
log.Printf("GET value: %s", val)
}
}
APPEND <key> <value>
キーが存在する場合は、キーの値の末尾に引数の内容を追加します。キーが存在しない場合は、SETと同じ挙動となります。
取得した結果はSETしたvalueの文字数が表示されます。
# redis-cli
127.0.0.1:6379> APPEND key value
(integer) 5
// go-redis
cmd := redis.Append(ctx, "key", "value")
if err := cmd.Err(); err != nil {
log.Println(err)
}
// rueidis
cmd := redis.B().Append().Key("key").Value("val").Build()
if err := redis.Do(ctx, cmd).Error(); err != nil {
log.Println(err)
}
STRLEN <key>
キーで指定した値の文字列の長さを取得します。
# redis-cli
127.0.0.1:6379> STRLEN key
(integer) 5
// go-redis
cmd := redis.StrLen(ctx, "key")
if res, err := cmd.Result(); err != nil {
log.Println(err)
} else {
log.Printf("%v", res)
}
// rueidis
cmd := redis.B().Strlen().Key("key").Build()
if val, err := redis.Do(ctx, cmd).ToInt64(); err != nil {
log.Println(err)
} else {
log.Printf("LEN %d", val)
}
GETRANGE <key> <start> <end>
キーで指定した値の文字列のうち、指定した範囲の文字列を取得します。
# redis-cli
127.0.0.1:6379> GETRANGE key 1 3
"alu" # valueのうち[1]から[3]までの文字列を取得
// go-redis
cmd := redis.GetRange(ctx, "key", 1, 3)
if res, err := cmd.Result(); err != nil {
log.Println(err)
} else {
log.Printf("%v", res)
}
// rueidis
cmd := redis.B().Getrange().Key("key").Start(1).End(3).Build()
if val, err := redis.Do(ctx, cmd).ToString(); err != nil {
log.Println(err)
} else {
log.Printf("GETRANGE %s", val)
}
SETRANGE <key> <offset> <value>
指定したオフセットの位置を起点としてキーに値をセットします。
# redis-cli
127.0.0.1:6379> SET key HelloWorld
OK
127.0.0.1:6379> SETRANGE key 5 Redis
(integer) 11
127.0.0.1:6379> GET key
"HelloRedis"
// go-redis
cmd := redis.SetRange(ctx, "key", 6, "Redis")
if err := cmd.Err(); err != nil {
log.Println(err)
}
// rueidis
cmd := redis.B().Setrange().Key("key").Offset(6).Value("Redis").Build()
if err := redis.Do(ctx, cmd).Error(); err != nil {
log.Println(err)
}
INCR <key>
キーの値をインクリメントします。指定したキーが存在しない場合には、操作前に0がセットされます。
# redis-cli
127.0.0.1:6379> INCR key
(integer) 1
127.0.0.1:6379> GET key
"1"
127.0.0.1:6379> INCR key
(integer) 2
127.0.0.1:6379> GET key
"2"
// go-redis
cmd := redis.Incr(ctx, "key")
if res, err := cmd.Result(); err != nil {
log.Println(err)
} else {
log.Printf("%v", res)
}
// rueidis
cmd := redis.B().Incr().Key("key").Build()
if val, err := redis.Do(ctx, cmd).ToInt64(); err != nil {
log.Println(err)
} else {
log.Printf("INCR %d", val)
}
INCRBY <key> <increment>
キーと値を指定した整数だけ増加します。指定したキーが存在しない場合には、操作前に0がセットされます。
# redis-cli
127.0.0.1:6379> INCRBY key 4
(integer) 4
// go-redis
cmd := redis.IncrBy(ctx, "key", 4)
if res, err := cmd.Result(); err != nil {
log.Println(err)
} else {
log.Printf("%v", res)
}
// rueidis
cmd := redis.B().Incrby().Key("key").Increment(5).Build()
if val, err := redis.Do(ctx, cmd).ToInt64(); err != nil {
log.Println(err)
} else {
log.Printf("INCRBY %d", val)
}
INCRBYFLOAT <key> <increment>
浮動小数点数を指定した値だけ増加します。指定したキーが存在しない場合には、操作前に0がセットされます。
数値を減らす場合は、マイナスを指定します。
# redis-cli
127.0.0.1:6379> INCRBYFLOAT key 4.6
"4.6"
// go-redis
cmd := redis.IncrByFloat(ctx, "key", 4.6)
if res, err := cmd.Result(); err != nil {
log.Println(err)
} else {
log.Printf("%v", res)
}
// rueidis
cmd := redis.B().Incrbyfloat().Key("key").Increment(4.6).Build()
if val, err := redis.Do(ctx, cmd).AsFloat64(); err != nil {
log.Println(err)
} else {
log.Printf("INCRBYFLOAT %v", val)
}
DECR <key>
キーの値を1だけ減少します。指定したキーが存在しない場合には、操作前に0がセットされます。
# redis-cli
127.0.0.1:6379> DECR key
(integer) -1
// go-redis
cmd := redis.Decr(ctx, "key")
if res, err := cmd.Result(); err != nil {
log.Println(err)
} else {
log.Printf("%v", res)
}
// rueidis
cmd := redis.B().Decr().Key("key").Build()
if val, err := redis.Do(ctx, cmd).ToInt64(); err != nil {
log.Println(err)
} else {
log.Printf("DECR %d", val)
}
DECRBY <key> <decrement>
キーの値を指定した整数だけ減少します。指定したキーが存在しない場合には、操作前に0がセットされます。
# redis-cli
127.0.0.1:6379> DECRBY key 4
(integer) -4
// go-redis
cmd := redis.DecrBy(ctx, "key", 4)
if res, err := cmd.Result(); err != nil {
log.Println(err)
} else {
log.Printf("%v", res)
}
// rueidis
cmd := redis.B().Decrby().Key("key").Decrement(4).Build()
if val, err := redis.Do(ctx, cmd).ToInt64(); err != nil {
log.Println(err)
} else {
log.Printf("DECRBY %d", val)
}
GETDEL <key>
キーの値を取得し、同時にそのキーを削除します。
# redis-cli
127.0.0.1:6379> SET key value
OK
127.0.0.1:6379> GETDEL key
"value"
127.0.0.1:6379> GET key
(nil)
// go-redis
cmd := redis.GetDel(ctx, "key")
if res, err := cmd.Result(); err != nil {
log.Println(err)
} else {
log.Printf("%v", res)
}
// rueidis
cmd := redis.B().Getdel().Key("key").Build()
if val, err := redis.Do(ctx, cmd).ToString(); err != nil {
log.Println(err)
} else {
log.Printf("GETDEL %s", val)
}
KEYS <pattern>
キーの一覧を取得します。パターンを指定することで、キーの一覧を絞り込むことができます。
ただし、KEYSコマンドはパフォーマンスが悪いため、本番環境ではSCAN系のコマンドを使用することが推奨されています。
# redis-cli
127.0.0.1:6379> KEYS *
1) "key3"
2) "key1"
3) "key2"
4) "foo"
5) "key"
127.0.0.1:6379> KEYS key*
1) "key3"
2) "key1"
3) "key2"
4) "key"
// go-redis
cmd := redis.Keys(ctx, "key*")
if res, err := cmd.Result(); err != nil {
log.Println(err)
} else {
log.Printf("%v", res)
}
// rueidis
cmd := redis.B().Keys().Pattern("key*").Build()
if val, err := redis.Do(ctx, cmd).AsStrSlice(); err != nil {
log.Println(err)
} else {
for _, v := range val {
log.Printf("KEYS %s", v)
}
}
EXEISTS <key> [<key> ...]
指定したキーが存在するかどうかを確認します。
# redis-cli
127.0.0.1:6379> SET key velue
OK
127.0.0.1:6379> EXISTS key
(integer) 1
127.0.0.1:6379> EXISTS k
(integer) 0
// go-redis
cmd := redis.Exists(ctx, "key")
if res, err := cmd.Result(); err != nil {
log.Println(err)
} else {
log.Printf("%v", res)
}
// rueidis
cmd := redis.B().Exists().Key("key").Build()
if val, err := redis.Do(ctx, cmd).AsBool(); err != nil {
log.Println(err)
} else {
log.Printf("EXISTS %v", val)
}
DEL <key>
指定したキーを削除します。キーが存在しない場合は無視されます。
# redis-cli
127.0.0.1:6379> SET key velue
OK
127.0.0.1:6379> DEL key
(integer) 1
127.0.0.1:6379> DEL key
(integer) 0
// go-redis
cmd := redis.Del(ctx, "key")
if err := cmd.Err(); err != nil {
log.Println(err)
}
// rueidis
cmd := redis.B().Del().Key("key").Build()
if err := redis.Do(ctx, cmd).Error(); err != nil {
log.Println(err)
}
おわりに
Redis
の基本的なString型コマンドについてredis-cli
と2つのGoライブラリを使って実行する方法を紹介しました。
どちらのライブラリも基本的にはredis-cli
と同様の使い方ができると感じました。
ただ、go-redis
の方がコマンドの実行結果が決まっているので使いやすそうな気もしました。
この記事ではrueidis
のsupports client side caching.
について言及できませんでしたが、使い心地がgo-redis
と変わらなかったので趣味開発でのRedis
クライアントはrueidis
に乗り変えていろいろ試してみようと思います。
本記事で紹介した各種コードは以下のリポジトリにも置いておきます。
Discussion
Hi takokun, thank you for trying rueidis and sharing a detailed comparison with go-redis with us!
I am also encouraging you to try the client-side caching as well which is a killer feature since Redis 6. Hoping that you can get huge benefit from it.