REDIS 键命令整理
redis 键命令
Redis 键命令用于管理 redis 的键. 原文
语法
COMMAND key [key ...]
键命令
DEL
删除指定键, 返回被删除键的数量, 若键不存在直接忽略. 官方文档
语法
DEL key [key ...]
返回值
- 被删除键的数量
示例
redis> SET key1 "Hello"
"OK"
redis> SET key2 "World"
"OK"
redis> DEL key1 key2 key3
(integer) 2
EXISTS
检测指定键是否存在. 官方文档
语法
EXISTS key [key ...]
返回值
- 存在的键的数量
示例
redis> SET key1 "Hello"
"OK"
redis> EXISTS key1
(integer) 1
redis> EXISTS nosuchkey
(integer) 0
redis> SET key2 "World"
"OK"
redis> EXISTS key1 key2 nosuchkey
(integer) 2
EXPIRE
设置键 key 的有效期, 若 key 有效期已存在则更新. 过了有效期后, 键 key 会被自动删除 官方文档
语法
EXPIRE key seconds
- seconds 有效期, 单位秒.
返回值
- 1 有效期被设值成功
- 0 key 不存在
示例
redis> SET mykey "Hello"
"OK"
redis> EXPIRE mykey 10
(integer) 1
redis> TTL mykey
(integer) 10
redis> TTL mykey -- 10 秒执行
(integer) -2 -- key 不存在返回 -2
redis> SET mykey "Hello World"
"OK"
redis> TTL mykey
(integer) -1 -- key 没有有效期关联返回 -1
PEXPIRE 同 EXPIRE, 区别 PEXPIRE 单位为毫秒
EXPIREAT
功能类似 EXPIRE, 不过此命令设置的有效期是时间点, 值为自1970年1月1日以来的秒数. 官方文档
语法
EXPIREAT key timestamp
- timestamp 时间戳
返回值
- 1 有效期被设值成功
- 0 key 不存在
示例
redis> SET mykey "Hello"
"OK"
redis> EXISTS mykey
(integer) 1
redis> EXPIREAT mykey 1293840000
(integer) 1
redis> EXISTS mykey
(integer) 0
PEXPIREAT 同 EXPIREAT, 区别 PEXPIREAT 单位为毫秒
KEYS
返回所有匹配指定模式的 KEY. 该指令通常用于调试问题, 尽量避免在应用代码中使用, 若有类似需求可以考虑使用 SCAN 命令或者 sets 数据结构. 官方文档
语法
KEYS pattern
支持的模式 pattern 的规则如下:
- h?llo 匹配 hello, hallo, hxllo ...
- h*llo 匹配 hllo, heeeello ...
- h[ae]llo 匹配 hello, hallo. 不能匹配 hillo
- h[^e]llo 匹配 hallo, hbllo ... 不能匹配 hello
- h[a-b]llo 匹配 hallo and hbllo
返回值
- 匹配 key 列表
示例
redis> MSET firstname Jack lastname Stuntman age 35
"OK"
redis> KEYS *name*
1) "lastname"
2) "firstname"
redis> KEYS a??
1) "age"
redis> KEYS *
1) "lastname"
2) "age"
3) "firstname"
MIGATE
迁移指定 KEY. 官方文档
语法
MIGRATE host port key|"" destination-db timeout [COPY] [REPLACE] [KEYS key [key ...]]
选项
- COPY 不删除当前实例中的 KEY
- REPLACE 替换远程实例已存在的 KEY
- KEYS 指定 KEY, 若为空则为所有 KEY
返回值
- OK 命令执行成功
- NOKEY 当前实例为空
实例
MIGRATE 192.168.1.34 6379 "" 0 5000 KEYS key1 key2 key3
MOVE
将指定 KEY 移至指定 DB. 官方文档
语法
MOVE key db
返回值
- 1 指定 KEY 被移动成功
- 0 指定 KEY 不存在
OBJECT
查看 Redis 的内部对象, 通常用于调试. 官方文档
语法
OBJECT subcommand [arguments [arguments ...]]
OBJECT 命令支持的子命令:
- OBJECT REFCOUNT <key> 返回指定 KEY 关联值引用的数量.
- OBJECT ENCODING <key> 返回指定 KEY 关联值存贮的编码方式
- OBJECT IDLETIME <key> 返回指定 KEY 未使用的时长
- OBJECT FREQ <key> 返回指定 KEY 使用频率
- OBJECT HELP 打印该命令帮助信息
示例
redis> lpush mylist "Hello World"
(integer) 4
redis> object refcount mylist
(integer) 1
redis> object encoding mylist
"ziplist"
redis> object idletime mylist
(integer) 10
PERSIST
移除 key 的过期时间. 官方文档
语法
PERSIST key
返回值
- 1 指定 key 的过期时间被移除
- 0 指定 key 不存在或未设置过期时间
示例
redis> SET mykey "Hello"
"OK"
redis> EXPIRE mykey 10
(integer) 1
redis> TTL mykey
(integer) 10
redis> PERSIST mykey
(integer) 1
redis> TTL mykey
(integer) -1
RANDOMKEY
从当前数据库中返回一个随机 KEY. 官方文档
返回值
- key 一个随机 KEY
- nil 数据库为空时返回
RENAME
重命名 KEY, 若新 KEY 已存在则会被覆盖. 官方文档
语法
RENAME key newkey
示例
redis> SET mykey "Hello"
"OK"
redis> RENAME mykey myotherkey
"OK"
redis> GET myotherkey
"Hello"
RENAME
重命名 KEY, 若新 KEY 已存在则会出错. 官方文档
语法
RENAMENX key newkey
示例
redis> SET mykey "Hello"
"OK"
redis> SET myotherkey "World"
"OK"
redis> RENAMENX mykey myotherkey
(integer) 0
redis> GET myotherkey
"World"
SCAN
遍历当前数据库 key. 官方文档
语法
RENAMENX cursor
- cursor 起始光标
返回值
- cursor 下次 SCAN 的其实位置
示例
redis> SET mykey "Hello"
"OK"
redis> SET myotherkey "World"
"OK"
redis> RENAMENX mykey myotherkey
(integer) 0
redis> GET myotherkey
"World"
SORT
排序数据结构 list, set, sorted set 的 key. 官方文档
示例
SORT mylist # 默认升序 key 为数字
SORT mylist DESC # 降序 key 为数字
SORT mylist ALPHA # 字典序 key 为字符串
SORT mylist LIMIT 0 10 # 分页
SORT mylist LIMIT 0 5 ALPHA DESC # 选项组合
SORT mylist BY weight_* # 外部 KEY 排序 weight_1, weight_2, ...
SORT mylist BY nosort # 跳过排序 KEY, 获取外部 KEY
SORT mylist BY weight_* GET object_* # 获取指定外部 KEY, GET 选项可以使用多次, 获取 GET 本身使用模式符 #, 如: SORT mylist BY weight_* GET object_* GET #
SORT mylist BY weight_* STORE resultkey # 存贮排序结果
SORT mylist BY weight_*->fieldname GET object_*->fieldname # 指定对象排序的 KEY
TOUCH
更新 KEY 的最后访问时间, 若 KEY 不存在则忽略. 官方文档
语法
TOUCH key [key ...]
返回值
- 返回被更新 KEY 的个数.
示例
redis> SET key1 "Hello"
"OK"
redis> SET key2 "World"
"OK"
redis> TOUCH key1 key2
(integer) 2
TTL
获取的 KEY 的过期时间. 官方文档
语法
TTL key
返回值
- 指定 key 的过期时间
- -2 指定 key 不存在
- -1 指定 key 未设置过期时间
示例
redis> SET mykey "Hello"
"OK"
redis> EXPIRE mykey 10
(integer) 1
redis> TTL mykey
(integer) 10
** PTTL 同 TTL, 区别 PTTL 返回时间单位是毫秒**
TYPE
获取指定 KEY 的数据类型. 官方文档
语法
TYPE key
返回值
- 指定 key 的过期时间
- none 指定 key 不存在
示例
redis> SET key1 "value"
"OK"
redis> LPUSH key2 "value"
(integer) 1
redis> SADD key3 "value"
(integer) 1
redis> TYPE key1
"string"
redis> TYPE key2
"list"
redis> TYPE key3
"set"
UNLINK
同 DEL 指令, UNLINK 是从 KEY 空间中移除指定 KEY, 是内存级删除非阻塞. 实际删除将在后续持久化中发生. 官方文档
语法
UNLINK key [key ...]
返回值
- 被移除 KEY 的数量.
示例
redis> SET key1 "Hello"
"OK"
redis> SET key2 "World"
"OK"
redis> UNLINK key1 key2 key3
(integer) 2
WAIT (待完善)
阻塞当前客户端直到之前所有写命令被成功备份或到达指定的备份命令的数量, 若指定的超时(单位毫秒)到达将返回还未成功备份的命令数量. 官方文档
语法
WAIT numreplicas timeout
- numreplicas 备份的数量
- timeout 阻塞超时时间
返回值
- 备份的数量
示例
> SET foo bar
OK
> WAIT 1 0
(integer) 1
> WAIT 2 1000
(integer) 1
