d28f005552
Fix limit for databases other than sqlite go mod tidy && go mod vendor Remove unneeded break statements Make everything work with the new xorm version Fix xorm logging Fix lint Fix redis init Fix using id field Fix database init for testing Change default database log level Add xorm logger Use const for postgres go mod tidy Merge branch 'master' into update/xorm # Conflicts: # go.mod # go.sum # vendor/modules.txt go mod vendor Fix loading fixtures for postgres Go mod vendor1 Update xorm to version 1 Co-authored-by: kolaente <k@knt.li> Reviewed-on: https://kolaente.dev/vikunja/api/pulls/323
125 lines
4.1 KiB
Markdown
125 lines
4.1 KiB
Markdown
# Redis client for Golang
|
|
|
|
[](https://travis-ci.org/go-redis/redis)
|
|
[](https://godoc.org/github.com/go-redis/redis)
|
|
[](https://airbrake.io)
|
|
|
|
Supports:
|
|
|
|
- Redis 3 commands except QUIT, MONITOR, SLOWLOG and SYNC.
|
|
- Automatic connection pooling with [circuit breaker](https://en.wikipedia.org/wiki/Circuit_breaker_design_pattern) support.
|
|
- [Pub/Sub](https://godoc.org/github.com/go-redis/redis#PubSub).
|
|
- [Transactions](https://godoc.org/github.com/go-redis/redis#example-Client-TxPipeline).
|
|
- [Pipeline](https://godoc.org/github.com/go-redis/redis#example-Client-Pipeline) and [TxPipeline](https://godoc.org/github.com/go-redis/redis#example-Client-TxPipeline).
|
|
- [Scripting](https://godoc.org/github.com/go-redis/redis#Script).
|
|
- [Timeouts](https://godoc.org/github.com/go-redis/redis#Options).
|
|
- [Redis Sentinel](https://godoc.org/github.com/go-redis/redis#NewFailoverClient).
|
|
- [Redis Cluster](https://godoc.org/github.com/go-redis/redis#NewClusterClient).
|
|
- [Cluster of Redis Servers](https://godoc.org/github.com/go-redis/redis#example-NewClusterClient--ManualSetup) without using cluster mode and Redis Sentinel.
|
|
- [Ring](https://godoc.org/github.com/go-redis/redis#NewRing).
|
|
- [Instrumentation](https://godoc.org/github.com/go-redis/redis#ex-package--Instrumentation).
|
|
- [Cache friendly](https://github.com/go-redis/cache).
|
|
- [Rate limiting](https://github.com/go-redis/redis_rate).
|
|
- [Distributed Locks](https://github.com/bsm/redislock).
|
|
|
|
API docs: https://godoc.org/github.com/go-redis/redis.
|
|
Examples: https://godoc.org/github.com/go-redis/redis#pkg-examples.
|
|
|
|
## Installation
|
|
|
|
go-redis requires a Go version with [Modules](https://github.com/golang/go/wiki/Modules) support and uses import versioning. So please make sure to initialize a Go module before installing go-redis:
|
|
|
|
``` shell
|
|
go mod init github.com/my/repo
|
|
go get github.com/go-redis/redis/v7
|
|
```
|
|
|
|
Import:
|
|
|
|
``` go
|
|
import "github.com/go-redis/redis/v7"
|
|
```
|
|
|
|
## Quickstart
|
|
|
|
``` go
|
|
func ExampleNewClient() {
|
|
client := redis.NewClient(&redis.Options{
|
|
Addr: "localhost:6379",
|
|
Password: "", // no password set
|
|
DB: 0, // use default DB
|
|
})
|
|
|
|
pong, err := client.Ping().Result()
|
|
fmt.Println(pong, err)
|
|
// Output: PONG <nil>
|
|
}
|
|
|
|
func ExampleClient() {
|
|
client := redis.NewClient(&redis.Options{
|
|
Addr: "localhost:6379",
|
|
Password: "", // no password set
|
|
DB: 0, // use default DB
|
|
})
|
|
err := client.Set("key", "value", 0).Err()
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
|
|
val, err := client.Get("key").Result()
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
fmt.Println("key", val)
|
|
|
|
val2, err := client.Get("key2").Result()
|
|
if err == redis.Nil {
|
|
fmt.Println("key2 does not exist")
|
|
} else if err != nil {
|
|
panic(err)
|
|
} else {
|
|
fmt.Println("key2", val2)
|
|
}
|
|
// Output: key value
|
|
// key2 does not exist
|
|
}
|
|
```
|
|
|
|
## Howto
|
|
|
|
Please go through [examples](https://godoc.org/github.com/go-redis/redis#pkg-examples) to get an idea how to use this package.
|
|
|
|
## Look and feel
|
|
|
|
Some corner cases:
|
|
|
|
``` go
|
|
// SET key value EX 10 NX
|
|
set, err := client.SetNX("key", "value", 10*time.Second).Result()
|
|
|
|
// SORT list LIMIT 0 2 ASC
|
|
vals, err := client.Sort("list", &redis.Sort{Offset: 0, Count: 2, Order: "ASC"}).Result()
|
|
|
|
// ZRANGEBYSCORE zset -inf +inf WITHSCORES LIMIT 0 2
|
|
vals, err := client.ZRangeByScoreWithScores("zset", redis.ZRangeBy{
|
|
Min: "-inf",
|
|
Max: "+inf",
|
|
Offset: 0,
|
|
Count: 2,
|
|
}).Result()
|
|
|
|
// ZINTERSTORE out 2 zset1 zset2 WEIGHTS 2 3 AGGREGATE SUM
|
|
vals, err := client.ZInterStore("out", redis.ZStore{Weights: []int64{2, 3}}, "zset1", "zset2").Result()
|
|
|
|
// EVAL "return {KEYS[1],ARGV[1]}" 1 "key" "hello"
|
|
vals, err := client.Eval("return {KEYS[1],ARGV[1]}", []string{"key"}, "hello").Result()
|
|
|
|
// custom command
|
|
res, err := client.Do("set", "key", "value").Result()
|
|
```
|
|
|
|
## See also
|
|
|
|
- [Golang PostgreSQL ORM](https://github.com/go-pg/pg)
|
|
- [Golang msgpack](https://github.com/vmihailenco/msgpack)
|
|
- [Golang message task queue](https://github.com/vmihailenco/taskq)
|