转自:Redis命令参考简体中文版
本文是《Redis Command Reference》的简体中文翻译版,原文共十个部分的所有命令均已翻译完毕。
DEL key [key …]
移除给定的一个或多个key
。
如果key
不存在,则忽略该命令。
时间复杂度:
O(N),N为要移除的key
的数量。
移除单个字符串类型的key
,时间复杂度为O(1)。
移除单个列表、集合、有序集合或哈希表类型的key,时间复杂度为O(M),M为以上数据结构内的元素数量。
返回值:
被移除key的数量。
# 情况1: 删除单个key
redis> SET name huangz # 设置一个值
OK
redis> DEL name # 将其删除
(integer) 1
# 情况2: 删除一个不存在的key
redis> EXISTS phone # 检查一个不存在的key
(integer) 0
redis> DEL phone # 试图删除一个不存在的key,失败
(integer) 0
# 情况3: 同时删除多个key
redis> MSET name huangz age 20 blog huangz.iteye.com # 同时设置多个key-value对
OK
redis> DEL name age blog # 同时删除三个key
(integer) 3
KEYS pattern
查找符合给定模式的key
。
KEYS *
命中数据库中所有key
。
KEYS h?llo
命中hello
, hallo and hxllo
等。
KEYS h*llo
命中hllo
和heeeeello
等。
KEYS h[ae]llo
命中hello
和hallo
,但不命中hillo
。
特殊符号用"\"隔开
时间复杂度:
O(N),N为数据库中key
的数量。
返回值:
符合给定模式的key
列表。
Warning: KEYS的速度非常快,但在一个大的数据库中使用它仍然可能造成性能问题,如果你需要从一个数据集中查找特定的key,你最好还是用集合(Set)。 |
redis> mset one 1 two 2 three 3 four 4 # 一次设置4个key
OK
redis> keys *o*
1) "four"
2) "two"
3) "one"
redis> keys t??
1) "two"
redis> keys t[w]*
1) "two"
redis> keys * # 匹配数据库内所有key
1) "four"
2) "three"
3) "two"
4) "one"
RANDOMKEY
从当前数据库中随机返回(不删除)一个key
。
时间复杂度:
O(1)
返回值:
当数据库不为空时,返回一个key
。
当数据库为空时,返回nil
。
# 情况1:数据库不为空
redis> mset fruit "apple" drink "beer" food "cookies" # 设置多个key
OK
redis> randomkey
"fruit"
redis> randomkey
"food"
redis> keys * # 查看数据库内所有key,证明RANDOMKEY并不删除key
1) "food"
2) "drink"
3) "fruit"
# 情况2:数据库为空
redis> flushdb # 删除当前数据库所有key
OK
redis> randomkey
(nil)
TTL key
返回给定key
的剩余生存时间(time to live)(以秒为单位)。
时间复杂度:
O(1)
返回值:
key
的剩余生存时间(以秒为单位)。
当key不存在或没有设置生存时间时,返回-1
。
# 情况1:带TTL的key
redis> set name "huangz" # 设置一个key
OK
redis> expire name 30 # 设置生存时间为30秒
(integer) 1
redis> get name
"huangz"
redis> ttl name
(integer) 25
redis> ttl name # 30秒过去,name过期
(integer) -1
redis> get name # 过期的key将被删除
(nil)
# 情况2:不带TTL的key
redis> SET site wikipedia.org
OK
redis> TTL wikipedia.org
(integer) -1
# 情况3:不存在的key
redis> EXISTS not_exists_key
(integer) 0
redis> TTL not_exists_key
(integer) -1
EXISTS key
检查给定key
是否存在。
时间复杂度:
O(1)
返回值:
若key
存在,返回1
,否则返回0
。
redis> set db "redis"
OK
redis> exists db # key存在
(integer) 1
redis> del db # 删除key
(integer) 1
redis> exists db # key不存在
(integer) 0
MOVE key db
将当前数据库(默认为0)的key
移动到给定的数据库db
当中。
如果当前数据库(源数据库)和给定数据库(目标数据库)有相同名字的给定key
,或者key
不存在于当前数据库,那么MOVE
没有任何效果。
因此,也可以利用这一特性,将MOVE
当作锁(locking)原语。
时间复杂度:
O(1)
返回值:
移动成功返回1
,失败则返回0
。
# 情况1: key存在于当前数据库
redis> SELECT 0 # redis默认使用数据库0,为了清晰起见,这里再显式指定一次。
OK
redis> SET song "secret base - Zone"
OK
redis> MOVE song 1 # 将song移动到数据库1
(integer) 1
redis> EXISTS song # song已经被移走
(integer) 0
redis> SELECT 1 # 使用数据库1
OK
redis:1> EXISTS song # 证实song被移到了数据库1(注意命令提示符变成了"redis:1",表明正在使用数据库1)
(integer) 1
# 情况2:当key不存在的时候
redis:1> EXISTS fake_key
(integer) 0
redis:1> MOVE fake_key 0 # 试图从数据库1移动一个不存在的key到数据库0,失败
(integer) 0
redis:1> select 0 # 使用数据库0
OK
redis> EXISTS fake_key # 证实fake_key不存在
(integer) 0
# 情况3:当源数据库和目标数据库有相同的key时
redis> SELECT 0 # 使用数据库0
OK
redis> SET favorite_fruit "banana"
OK
redis> SELECT 1 # 使用数据库1
OK
redis:1> SET favorite_fruit "apple"
OK
redis:1> SELECT 0 # 使用数据库0,并试图将favorite_fruit移动到数据库1
OK
redis> MOVE favorite_fruit 1 # 因为两个数据库有相同的key,MOVE失败
(integer) 0
redis> GET favorite_fruit # 数据库0的favorite_fruit没变
"banana"
redis> SELECT 1
OK
redis:1> GET favorite_fruit # 数据库1的favorite_fruit也是
"apple"
RENAME key newkey
将key
改名为newkey
。
当key
和newkey
相同或者key
不存在时,返回一个错误。
当newkey
已经存在时,RENAME
命令将覆盖旧值。
时间复杂度:
O(1)
返回值:
改名成功时提示OK
,失败时候返回一个错误。
# 情况1:key存在且newkey不存在
redis> SET message "hello world"
OK
redis> RENAME message greeting
OK
redis> EXISTS message # message不复存在
(integer) 0
redis> EXISTS greeting # greeting取而代之
(integer) 1
# 情况2:当key不存在时,返回错误
redis> RENAME fake_key never_exists
(error) ERR no such key
# 情况3:newkey已存在时,RENAME会覆盖旧newkey
redis> SET pc "lenovo"
OK
redis> SET personal_computer "dell"
OK
redis> RENAME pc personal_computer
OK
redis> GET pc
(nil)
redis:1> GET personal_computer # dell“没有”了
"lenovo"
TYPE key
返回key
所储存的值的类型。
时间复杂度:
O(1)
返回值:
none
(key不存在)
string
(字符串)
list
(列表)
set
(集合)
zset
(有序集)
hash
(哈希表)
redis> SET weather "sunny" # 构建一个字符串
OK
redis> TYPE weather
string
redis> LPUSH book_list "programming in scala" # 构建一个列表
(integer) 1
redis> TYPE book_list
list
redis> SADD pat "dog" # 构建一个集合
(integer) 1
redis> TYPE pat
set
EXPIRE key seconds
为给定key
设置生存时间。
当key
过期时,它会被自动删除。
在Redis中,带有生存时间的key
被称作“易失的”(volatile)。
在低于2.1.3版本的Redis中,已存在的生存时间不可覆盖。
从2.1.3版本开始,key
的生存时间可以被更新,也可以被PERSIST
命令移除。(详情参见 http://redis.io/topics/expire)。
时间复杂度:
O(1)
返回值:
设置成功返回1
。
当key
不存在或者不能为key
设置生存时间时(比如在低于2.1.3中你尝试更新key
的生存时间),返回0
。
redis> SET cache_page "www.twitter.com/huangz1990"
OK
redis> EXPIRE cache_page 30 # 设置30秒后过期
(integer) 1
redis> TTL cache_page # 查看给定key的剩余生存时间
(integer) 24
redis> EXPIRE cache_page 30000 # 更新生存时间,30000秒
(integer) 1
redis> TTL cache_page
(integer) 29996
OBJECT subcommand [arguments [arguments]]
OBJECT
命令允许从内部察看给定key
的Redis对象。
它通常用在除错(debugging)或者了解为了节省空间而对key
使用特殊编码的情况。
当将Redis用作缓存程序时,你也可以通过OBJECT
命令中的信息,决定key
的驱逐策略(eviction policies)。
OBJECT命令有多个子命令:
OBJECT REFCOUNT
返回给定key
引用所储存的值的次数。此命令主要用于除错。OBJECT ENCODING
返回给定key
锁储存的值所使用的内部表示(representation)。OBJECT IDLETIME
返回给定key
自储存以来的空转时间(idle, 没有被读取也没有被写入),以秒为单位。对象可以以多种方式编码:
raw
(一般字符串)或int(用字符串表示64位数字是为了节约空间)。ziplist
或linkedlist
。ziplist
是为节约大小较小的列表空间而作的特殊表示。intset
或者hashtable
。intset
是只储存数字的小集合的特殊表示。zipmap
或者hashtable
。zipmap
是小哈希表的特殊表示。ziplist
或者skiplist
格式。ziplist
用于表示小的有序集合,而skiplist
则用于表示任何大小的有序集合。假如你做了什么让Redis没办法再使用节省空间的编码时(比如将一个只有1个元素的集合扩展为一个有100万个元素的集合),特殊编码类型(specially encoded types)会自动转换成通用类型(general type)。
时间复杂度:
O(1)
返回值:
REFCOUNT
和IDLETIME
返回数字。
ENCODING
返回相应的编码类型。
RENAMENX key newkey
当且仅当newkey
不存在时,将key
改为newkey
。
出错的情况和RENAME一样(key
不存在时报错)。
时间复杂度:
O(1)
返回值:
修改成功时,返回1
。
如果newkey
已经存在,返回0
。
# 情况1:newkey不存在,成功
redis> SET player "MPlyaer"
OK
redis> EXISTS best_player
(integer) 0
redis> RENAMENX player best_player
(integer) 1
# 情况2:newkey存在时,失败
redis> SET animal "bear"
OK
redis> SET favorite_animal "butterfly"
OK
redis> RENAMENX animal favorite_animal
(integer) 0
redis> get animal
"bear"
redis> get favorite_animal
"butterfly"
EXPIREAT key timestamp
EXPIREAT
的作用和EXPIRE一样,都用于为key
设置生存时间。
不同在于EXPIREAT
命令接受的时间参数是UNIX时间戳(unix timestamp)。
时间复杂度:
O(1)
返回值:
如果生存时间设置成功,返回1
。
当key
不存在或没办法设置生存时间,返回0
。
redis> SET cache www.google.com
OK
redis> EXPIREAT cache 1355292000 # 这个key将在2012.12.12过期
(integer) 1
redis> TTL cache
(integer) 45081860
PERSIST key
移除给定key
的生存时间。
时间复杂度:
O(1)
返回值:
当生存时间移除成功时,返回1
.
如果key
不存在或key
没有设置生存时间,返回0
。
redis> SET time_to_say_goodbye "886..."
OK
redis> EXPIRE time_to_say_goodbye 300
(integer) 1
redis> TTL time_to_say_goodbye
(integer) 293
redis> PERSIST time_to_say_goodbye # 移除生存时间
(integer) 1
redis> TTL time_to_say_goodbye # 移除成功
(integer) -1
SORT key [BY pattern] [LIMIT offset count] [GET pattern [GET pattern …]] [ASC | DESC] [ALPHA] [STORE destination]
返回或保存给定列表、集合、有序集合key
中经过排序的元素。
排序默认以数字作为对象,值被解释为双精度浮点数,然后进行比较。
一般SORT用法
最简单的SORT使用方法是SORT key
。
假设today_cost
是一个保存数字的列表,SORT命令默认会返回该列表值的递增(从小到大)排序结果。
# 将数据一一加入到列表中
redis> LPUSH today_cost 30
(integer) 1
redis> LPUSH today_cost 1.5
(integer) 2
redis> LPUSH today_cost 10
(integer) 3
redis> LPUSH today_cost 8
(integer) 4
# 排序
redis> SORT today_cost
1) "1.5"
2) "8"
3) "10"
4) "30"
当数据集中保存的是字符串值时,你可以用ALPHA
修饰符(modifier)进行排序。
# 将数据一一加入到列表中
redis> LPUSH website "www.reddit.com"
(integer) 1
redis> LPUSH website "www.slashdot.com"
(integer) 2
redis> LPUSH website "www.infoq.com"
(integer) 3
# 默认排序
redis> SORT website
1) "www.infoq.com"
2) "www.slashdot.com"
3) "www.reddit.com"
# 按字符排序
redis> SORT website ALPHA
1) "www.infoq.com"
2) "www.reddit.com"
3) "www.slashdot.com"
具体可参考:https://redis.readthedocs.io/en/2.4/key.html
HSET key field value
将哈希表key
中的域field
的值设为value
。
如果key
不存在,一个新的哈希表被创建并进行HSET
操作。
如果域field
已经存在于哈希表中,旧值将被覆盖。
时间复杂度:
O(1)
返回值:
如果field
是哈希表中的一个新建域,并且值设置成功,返回1
。
如果哈希表中域field
已经存在且旧值已被新值覆盖,返回0
。
redis> HSET website google "www.g.cn" # 一个新域
(integer) 1
redis> HSET website google "www.google.com" # 覆盖一个旧域
(integer) 0
HSETNX key field value
将哈希表key
中的域field
的值设置为value
,当且仅当域field
不存在。
若域field
已经存在,该操作无效。
如果key
不存在,一个新哈希表被创建并执行HSETNX
命令。
时间复杂度:
O(1)
返回值:
设置成功,返回1
。
如果给定域已经存在且没有操作被执行,返回0
。
redis> HSETNX nosql key-value-store redis
(integer) 1
redis> HSETNX nosql key-value-store redis # 操作无效,域key-value-store已存在
(integer) 0
HMSET key field value [field value …]
同时将多个field - value
(域-值)对设置到哈希表key
中。
此命令会覆盖哈希表中已存在的域。
如果key
不存在,一个空哈希表被创建并执行HMSET
操作。
时间复杂度:
O(N),N为field - value
对的数量。
返回值:
如果命令执行成功,返回OK
。
当key
不是哈希表(hash)类型时,返回一个错误。
# 情况1: 哈希表
redis> HMSET website google www.google.com yahoo www.yahoo.com
OK
redis> HGET website google
"www.google.com"
redis> HGET website yahoo
"www.yahoo.com"
# 情况2:类型错误时
redis> SET G 10 # 出错情况
OK
redis> HMSET G name huangz age 20
(error) ERR Operation against a key holding the wrong kind of value
HGET key field
返回哈希表key
中给定域field
的值。
时间复杂度:
O(1)
返回值:
给定域的值。
当给定域不存在或是给定key
不存在时,返回nil
。
redis> HSET huangz blog huangz.iteye.com
(integer) 1
redis> HGET huangz blog
"huangz.iteye.com"
HMGET key field [field …]
返回哈希表key
中,一个或多个给定域的值。
如果给定的域不存在于哈希表,那么返回一个nil
值。
因为不存在的key
被当作一个空哈希表来处理,所以对一个不存在的key
进行HMGET
操作将返回一个只带有nil
值的表。
时间复杂度:
O(N),N为给定域的数量。
返回值:
一个包含多个给定域的关联值的表,表值的排列顺序和给定域参数的请求顺序一样。
redis> HMSET pet dog "doudou" cat "nounou" # 一次保存多个值
OK
redis> HMGET pet dog cat fake_pet # 返回值的顺序和传入参数的顺序一样。
1) "doudou"
2) "nounou"
3) (nil) # 不存在的域返回nil值
HGETALL key
返回哈希表key
中,所有的域和值。
在返回值里,紧跟每个域名(field name
)之后是域的值(value
),所以返回值的长度是哈希表大小的两倍。
时间复杂度:
O(N),N为哈希表的大小。
返回值:
以列表形式返回哈希表的域和域的值。 若key
不存在,返回空列表。
redis> HSET hash_name jack "Jack Sparrow"
(integer) 1
redis> HSET hash_name gump "Forrest Gump"
(integer) 1
redis> HGETALL hash_name
1) "jack" # 域
2) "Jack Sparrow" # 值
3) "gump"
4) "Forrest Gump"
HDEL key field [field …]
删除哈希表key
中的一个或多个指定域,不存在的域将被忽略。
时间复杂度:
O(N),N为要删除的域的数量。
返回值:
被成功移除的域的数量,不包括被忽略的域。
Note: 在Redis2.4以下的版本里,HDEL每次只能删除单个域,如果你需要在一个原子时间内删除多个域,请将命令包含在MULTI/ EXEC块内。 |
# 测试数据
redis> HGETALL abbr
1) "a"
2) "apple"
3) "b"
4) "banana"
5) "c"
6) "cat"
7) "d"
8) "dog"
# 删除单个域
redis> HDEL abbr a
(integer) 1
# 删除不存在的域
redis> HDEL abbr not-exists-field
(integer) 0
# 删除多个域
redis> HDEL abbr b c
(integer) 2
redis> HGETALL abbr
1) "d"
2) "dog"
HLEN key
返回哈希表key
中域的数量。
时间复杂度:
O(1)
返回值:
哈希表中域的数量。
当key
不存在时,返回0。
redis> HSET hash_name jack "Jack Sparrow"
(integer) 1
redis> HSET hash_name gump "Forrest Gump"
(integer) 1
redis> HLEN hash_name
(integer) 2
HEXISTS key field
查看哈希表key
中,给定域field
是否存在。
时间复杂度:
O(1)
返回值:
如果哈希表含有给定域,返回1
。
如果哈希表不含有给定域,或key
不存在,返回0
。
redis> HEXISTS phone myphone
(integer) 0
redis> HSET phone myphone nokia-1110
(integer) 1
redis> HEXISTS phone myphone
(integer) 1
HINCRBY key field increment
为哈希表key
中的域field
的值加上增量increment
。
增量也可以为负数,相当于对给定域进行减法操作。
如果key
不存在,一个新的哈希表被创建并执行HINCRBY
命令。
如果域field
不存在,那么在执行命令前,域的值被初始化为0
。
对一个储存字符串值的域field
执行HINCRBY
命令将造成一个错误。
本操作的值限制在64位(bit)有符号数字表示之内。
时间复杂度:
O(1)
返回值:
执行HINCRBY
命令之后,哈希表key
中域field
的值。
# 情况1:increment为正数
redis> HEXISTS counter page_view # 对空域进行设置
(integer) 0
redis> HINCRBY counter page_view 200
(integer) 200
redis> HGET counter page_view
"200"
# 情况2:increment为负数
redis> HGET counter page_view
"200"
redis> HINCRBY counter page_view -50
(integer) 150
redis> HGET counter page_view
"150"
# 情况3:尝试对字符串值的域执行HINCRBY命令
redis> HSET myhash string hello,world # 设定一个字符串值
(integer) 1
redis> HGET myhash string
"hello,world"
redis> HINCRBY myhash string 1 # 命令执行失败,错误。
(error) ERR hash value is not an integer
redis> HGET myhash string # 原值不变
"hello,world"
HKEYS key
返回哈希表key中的所有域。
时间复杂度:
O(N),N为哈希表的大小。
返回值:
一个包含哈希表中所有域的表。
当key不存在时,返回一个空表。
# 情况1:哈希表非空
redis> HMSET website google www.google.com yahoo www.yahoo.com
OK
redis> HKEYS website
1) "google"
2) "yahoo"
# 情况2:空哈希表/key不存在
redis> EXISTS fake_key
(integer) 0
redis> HKEYS fake_key
(empty list or set)
HVALS key
返回哈希表key
中的所有值。
时间复杂度:
O(N),N为哈希表的大小。
返回值:
一个包含哈希表中所有值的表。
当key
不存在时,返回一个空表。
# 情况1:非空哈希表
redis> HMSET website google www.google.com yahoo www.yahoo.com
OK
redis> HVALS website
1) "www.google.com"
2) "www.yahoo.com"
# 情况2:空哈希表/不存在的key
redis> EXISTS not_exists
(integer) 0
redis> HVALS not_exists
(empty list or set)
参考:https://redis.readthedocs.io/en/2.4/string.html
参考:https://redis.readthedocs.io/en/2.4/list.html
参考:https://redis.readthedocs.io/en/2.4/set.html
参考:https://redis.readthedocs.io/en/2.4/sorted_set.html
参考:https://redis.readthedocs.io/en/2.4/pub_sub.html
参考:https://redis.readthedocs.io/en/2.4/transaction.html
参考:https://redis.readthedocs.io/en/2.4/connection.html
参考:https://redis.readthedocs.io/en/2.4/server.html