Redis入门之一 字符串(string)
Redis 中最简单的数据结构,它既可以储存文字(比如 “hello world”),又可以储存数字(比如整数 10086 和浮点数 3.14),还可以储存二进制数据(比如 10010100)。Redis 为这几种类型的值分别设置了相应的操作命令,让用户可以针对不同的值做不同的处理。
一 基本操作
为字符串键设置值、获取字符串键的值、获取字符串值的长度,等等。
1.1 为字符串键设置值
1.1.1 SET key value
将字符串键 key 的值设置为 value ,命令返回 OK 表示设置成功。 如果字符串键 key 已经存在,那么用新值覆盖原来的旧值。复杂度为 O(1)
redis> SET msg "hello world" OK
redis> SET msg "goodbye" # 覆盖原来的值 "hello world" OK
1.1.2 SET key value [NX|XX]
SET 命令还支持可选的 NX 选项和 XX 选项:
- 如果给定了 NX 选项,那么命令仅在*键 key 不存在*的情况下,才进行设置操作;如果键 key 已经存 在,那么 SET … NX 命令不做动作(不会覆盖旧值)。
如果给定了 XX 选项,那么命令仅在键 key 已经存在的情况下,才进行设置操作;如果键 key 不存 在,那么 SET … XX 命令不做动作(一定会覆盖旧值)。
在给定 NX 选项和 XX 选项的情况下,SET 命令在设置成功时返回 OK ,设置失败时返回 nil 。
redis> SET nx-str "this will fail" XX # 键不存在,指定 XX 选项导致设置失败
(nil)
redis> SET nx-str "this will success" NX # 键不存在,所以指定 NX 选项是可行的
OK
redis> SET nx-str "this will fail" NX # 键已经存在,指定 NX 选项导致设置失败
(nil)
redis> SET nx-str "this will success again!" XX # 键已经存在,指定 XX 选项是可行的
OK
1.2 获取字符串的值
1.2.1 GET key
返回字符串键 key 储存的值。复杂度为 O(1) 。
redis> SET msg "hello world"
OK
redis> GET msg
hello world
redis> SET number 10086
OK
redis> GET number
10086
1.3 仅在键不存在的情况下进行设置
1.3.1 SETNX key value
仅在键 key 不存在的情况下,将键 key 的值设置为 value ,效果和 SET key value NX 一样。 NX 的意思为“Not eXists”(不存在)。键不存在并且设置成功时,命令返回 1 ;因为键已经存在而导致设置失败时,命令返回 0 。复杂度为 O(1) 。
redis> SETNX new-key "i am a new key!"
1
redis> SETNX new-key "another new key here!" # 键已经存在,设置失败
0
redis> GET new-key # 键的值没有改变
i am a new key!
1.4 同时设置或获取多个字符串键的值
命令 | 效果 | 复杂度 |
---|---|---|
MSET key value [key value …] | 一次为一个或多个字符串键设置 值,效果和同时执行多个 SET 命 令一样。 命令返回 OK 。 | O(N),N 为要设置的字符串键 数量。 |
MGET key [key …] | 一次返回一个或多个字符串 键的 值,效果和同时执行多个 GET 命 令一样 | O(N),N 为要获取的字符串键 数量。 |
1.5 一次设置多个不存在的键
MSETNX key value [key value …]
只有在所有给定键都不存在的情况下, MSETNX 会为所有给定键设置值,效果和同时执行多个 SETNX 一样。如果给定的键至少有一个是存在的,那么 MSETNX 将不执行任何设置操作。
返回 1 表示设置成功,返回 0 表示设置失败。复杂度为 O(N) , N 为给定的键数量。
redis> MSETNX nx-1 "hello" nx-2 "world" nx-3 "good luck"
1
redis> SET ex-key "bad key here"
OK
redis> MSETNX nx-4 "apple" nx-5 "banana" ex-key "cherry" nx-6 "durian"
0
因为 ex-key 键已经存在,所以第二个 MSETNX 会执行失败,所有键都不会被设置。
1.6 设置新值并返回旧值
GETSET key new-value
将字符串键的值设置为 new-value ,并返回字符串键在设置新值之前储存的旧值(old value)。
复杂度为 O(1) 。
redis> SET getset-str "i'm old value" # 先给字符串键设置一个值
OK
redis> GETSET getset-str "i'm new value" # 更新字符串键的值,并返回之前储存的旧值
i'm old value
redis> GET getset-str # 确认一下,新值已被设置
i'm new value
用伪代码表示 GETSET 的定义
def GETSET(key, new-value):
old-value = GET(key) # 记录旧值
SET(key, new-value) # 设置新值
return old-value # 返回旧值
1.7 追加内容到字符串末尾
APPEND key value
将值 value 推入到字符串键 key 已储存内容的末尾。O(N), 其中 N 为被推入值的长度
redis> SET myPhone "nokia"
OK
redis> APPEND myPhone "-1110"
(integer) 10
redis> GET myPhone
"nokia-1110"
二 数字操作
增加或者减少字符串键储存的数字值。
2.1 增加或者减少数字的值
对于一个保存着数字的字符串 键 key ,我们可以使用 INCRBY 命令来增加它的值,或者使用 DECRBY 命令来减少它的值
命令 | 效果 | 复杂度 |
---|---|---|
INCRBY key increment | 将 key 所储存的值加上增量 increment ,命 令返回操作执行之后,键 key 的当前值。 | O(1) |
DECRBY key decrement | 将 key 所储存的值减去减量 decrement ,命 令返回操作执行之后,键 key 的当前值。 | O(1) |
如果执行 INCRBY 或者 DECRBY 时,键 key 不存在,那么命令会将键 key 的 值初始化为 0 ,然后再执行增加或者减少操作
INCRBY / DECRBY 示例
redis> INCRBY num 100 # 键 num 不存在,命令先将 num 的值初始化为 0 ,# 然后再执行加 100 操作
(integer) 100
redis> INCRBY num 25 # 将值再加上 25
(integer) 125
redis> DECRBY num 10 # 将值减少 10
(integer) 115
redis> DECRBY num 50 # 将值减少 50
(integer) 65
增一和减一
命令 | 效果 | 复杂度 |
---|---|---|
INCR key | 等同于执行 INCRBY key 1 | O(1) |
DECR key | 等同于执行 DECRBY key 1 | O(1) |
redis> SET num 10
OK
redis> INCR num
(integer) 11
redis> DECR num
(integer) 10
2.2 浮点数的自增和自减
INCRBYFLOAT key increment
为字符串键 key 储存的值加上浮点数增量 increment ,命令返回操作执行之后,键 key 的值。
没有相应的 DECRBYFLOAT ,但可以通过给定负值来达到 DECRBYFLOAT 的效果。
复杂度为 O(1) 。
redis> SET num 10
redis> INCRBYFLOAT num 3.14
"13.14"
redis> INCRBYFLOAT num -2.04 # 通过传递负值来达到做减法的效果
"11.1"