• j3_liuliang
• Redis常用API即应用场景开始系列（key），如果觉得有用可以关注博主，不定时更新哦！

一、键(key)

1.1 TYPE（type）

Redis Type 命令用于返回 key 所储存的值的类型。

语法：

127.0.0.1:6379> TYPE KEY_NAME 

可用版本： >= 1.0.0

返回值

返回 key 的数据类型，数据类型有：

• none (key不存在)
• string (字符串)
• list (列表)
• set (集合)
• zset (有序集)
• hash (哈希表)

案例：

127.0.0.1:6379> set stringkey stringvalue		#设置String类型
OK
127.0.0.1:6379> type stringkey					#返回String
string
127.0.0.1:6379> lpush listkey list01 list02		#设置list类型
(integer) 2
127.0.0.1:6379> type listkey					#返回list
list
127.0.0.1:6379> sadd setkey setvalue			#设置set类型
(integer) 1
127.0.0.1:6379> type setkey						#返回set
set
127.0.0.1:6379> zadd zsetkey 1 "liuliang"		#设置zset类型
(integer) 1
127.0.0.1:6379> type zsetkey					#返回zset
zset
127.0.0.1:6379> hset hashkey name liuliang		#设置hash类型
(integer) 1
127.0.0.1:6379> type hashkey					#返回hash
hash

1.2 PEXPIREAT（pexpireat）

Redis PEXPIREAT 命令用于设置 key 的过期时间，亿毫秒记。key 过期后将不再可用。

语法

127.0.0.1:6379> PEXPIREAT KEY_NAME TIME_IN_MILLISECONDS_IN_UNIX_TIMESTAMP

可以版本：>= 1.0.0

返回值：设置成功返回 1 。 当 key 不存在或者不能为 key 设置过期时间时(比如在低于 2.1.3 版本的 Redis 中你尝试更新 key 的过期时间)返回 0 。

案例

127.0.0.1:6379> set k3 v3						#创建key 并赋值
OK
127.0.0.1:6379> pexpireat k3 5000000000000		#设置过期时间，大于等于这个输才行1000000000000
(integer) 1
127.0.0.1:6379> ttl k3							#查看剩余过期时间
(integer) 3398395525							#单位秒
127.0.0.1:6379> ttl k3
(integer) 3398395522
127.0.0.1:6379> 

1.3 RENAME（rename）

Redis RENAME命令用于修改 key 的名称 。

语法

127.0.0.1:6379> RENAME OLD_KEY_NAME NEW_KEY_NAME

可以版本：>= 1.0.0

返回值：

改名成功时提示 OK ，失败时候返回一个错误。

当 OLD_KEY_NAME 和 NEW_KEY_NAME 相同，或者 OLD_KEY_NAME 不存在时，返回一个错误。 当 NEW_KEY_NAME 已经存在时， RENAME 命令 将覆盖旧值。

案例

################### 第一种情况：重命名的新key不存在 ###################

127.0.0.1:6379> set j3-liuliang 18				#设置key并赋值
OK
127.0.0.1:6379> rename j3-liuliang liuliang		#重命名key，新key不存在
OK
127.0.0.1:6379> exists j3-liuliang				#exists判断key是否存在，0不存在，1存在
(integer) 0
127.0.0.1:6379> exists liuliang
(integer) 1

################### 第二种情况：重命名的新key存在 ###################

127.0.0.1:6379> set xiaozhang 28				#设置key并赋值
OK
127.0.0.1:6379> rename liuliang xiaozhang		#重命名key（liuliang），新key（xiaozhang）存在
OK												#重命名成功
127.0.0.1:6379> exists liuliang					#查看key是否存在
(integer) 0
127.0.0.1:6379> exists xiaozhang
(integer) 1
127.0.0.1:6379> get xiaozhang					#可以发现，如果重命名的key存在，则会覆盖新key的值
"18"

1.4 PERSIST （persist）

Redis PERSIST 命令用于移除给定 key 的过期时间，使得 key 永不过期。

语法

127.0.0.1:6379> PERSIST KEY_NAME

可以版本：>= 2.2.0

返回值：当过期时间移除成功时，返回 1 。 如果 key 不存在或 key 没有设置过期时间，返回 0 。

案例

127.0.0.1:6379> set j3-liuliang 18			#设置key并赋值
OK
127.0.0.1:6379> expire j3-liuliang 100		#设置过期时间
(integer) 1
127.0.0.1:6379> ttl j3-liuliang				#查看剩余过期时间
(integer) 98
127.0.0.1:6379> persist j3-liuliang			#移除key的过期时间
(integer) 1
127.0.0.1:6379> ttl j3-liuliang				#查看key状态，-1永久有效
(integer) -1

1.5 MOVE（move）

Redis MOVE 命令用于将当前数据库的 key 移动到给定的数据库 db 当中。

语法

127.0.0.1:6379> MOVE KEY_NAME DESTINATION_DATABASE

可以版本：>= 1.0.0

返回值：移动成功返回 1 ，失败则返回 0 。

案例

################### 第一种情况：key存在于当前数据库中（移动成功，当前库不存在key目标库存在key） ###################
127.0.0.1:6379> select 0					#切换数据库，默认就是 0 号数据库
OK
127.0.0.1:6379> set j3-liuliang 18			#设置key并复制
OK
127.0.0.1:6379> move j3-liuliang 1			#移动key到 1 号数据库
(integer) 1
127.0.0.1:6379> exists j3-liuliang			#查看当前数据库是否存在key
(integer) 0
127.0.0.1:6379> select 1					#切换数据库
OK
127.0.0.1:6379[1]> exists j3-liuliang		#查看当前数据库是否存在key
(integer) 1
127.0.0.1:6379[1]> 

################### 第二种情况：key不存在于当前数据库中（移动失败，因为key根本不存在） #################
127.0.0.1:6379> flushall					#清空所有数据库数据 0-15
OK
127.0.0.1:6379> exists j3-liuliang			#查看当前数据库是否存在key
(integer) 0
127.0.0.1:6379> move j3-liuliang 1			#将一个不存在的key移动到 1 号数据库
(integer) 0									#返回 0 说明已经失败了
127.0.0.1:6379> select 1					#切换数据库
OK
127.0.0.1:6379[1]> exists j3-liuliang		#查看当前数据库是否存在key
(integer) 0									#显然不存在
127.0.0.1:6379[1]> 

################### 第三种情况：当源数据库和目标数据库有相同的 key 时（结论移动失败，不做任何变化） ####
127.0.0.1:6379[1]> flushall					#清空所有数据库数据 0-15
OK
127.0.0.1:6379[1]> set j3-liuliang 28		#在当前数据库设置一个key
OK
127.0.0.1:6379[1]> select 0					#切换数据库
OK
127.0.0.1:6379> set j3-liuliang 18			#设置和上一个数据库中相同的一个key，值不要一样，便于区分
OK
127.0.0.1:6379> move j3-liuliang 1			#将当前数据库中key移动到上一个数据库中
(integer) 0									#发现，移动失败，说明，当两个数据库中有相同的key时，会移动失败
127.0.0.1:6379> get j3-liuliang				#获取当前数据库中key，发现没有变化
"18"
127.0.0.1:6379> select 1					#切换数据库
OK
127.0.0.1:6379[1]> get j3-liuliang			#发现也没有变化
"28"
127.0.0.1:6379[1]> 

1.6 RANDOMKEY（randomkey）

Redis RANDOMKEY 命令从当前数据库中随机返回一个 key 。

语法

127.0.0.1:6379> RANDOMKEY 

可以版本：>= 1.0.0

返回值：当数据库不为空时，返回一个 key 。 当数据库为空时，返回 nil 。

案例

127.0.0.1:6379> flushall								#清空所有数据库数据
OK
127.0.0.1:6379> mset k1 v1 k2 v2 k3 v3 k4 v4 k5 v5		#一次设置多个key value
OK
127.0.0.1:6379> keys *									#查看数据库说有key
1) "k4"
2) "k5"
3) "k1"
4) "k2"
5) "k3"
127.0.0.1:6379> randomkey								#随机输出一个key
"k4"
127.0.0.1:6379> randomkey
"k4"
127.0.0.1:6379> randomkey
"k4"
127.0.0.1:6379> randomkey
"k1"
127.0.0.1:6379> flushall								#情况所有数据库数据
OK
127.0.0.1:6379> randomkey								#发现输出为 nil
(nil)
127.0.0.1:6379> 

1.7 DUMP（dump）

Redis DUMP 命令用于序列化给定 key ，并返回被序列化的值。

语法

127.0.0.1:6379> DUMP KEY_NAME

可以版本：>= 2.6.0

返回值：如果 key 不存在，那么返回 nil 。 否则，返回序列化之后的值。

案例

127.0.0.1:6379> flushall					#清空所有数据库
OK
127.0.0.1:6379> set j3-liuliang 18			#设置key并赋值
OK
127.0.0.1:6379> dump j3-liuliang			#将给定的key序列化
"\x00\xc0\x12\t\x00\x9d+/\x83A\xa7'\x9a"	#key序列后的值
127.0.0.1:6379> dump not-exists-key			#序列化不存在的值
(nil)										#返回nil
127.0.0.1:6379> 

1.8 TTL（ttl）

Redis TTL 命令以秒为单位返回 key 的剩余过期时间。

语法

127.0.0.1:6379> TTL KEY_NAME

可以版本：>= 1.0.0

返回值：

当 key 不存在时，返回 -2 。 当 key 存在但没有设置剩余生存时间时，返回 -1 。 否则，以毫秒为单位，返回 key 的剩余生存时间。

**注意：**在 Redis 2.8 以前，当 key 不存在，或者 key 没有设置剩余生存时间时，命令都返回 -1 。

案例

127.0.0.1:6379> flushall					#清空所有数据库数据
OK
127.0.0.1:6379> ttl j3-liuliang				#判断一个不存在的key
(integer) -2
127.0.0.1:6379> set j3-liuliang 18			#设置key并赋值
OK
127.0.0.1:6379> ttl j3-liuliang				#查看存在的key但没有设置过期时间
(integer) -1
127.0.0.1:6379> expire j3-liuliang 100		#给存在的key设置过期时间
(integer) 1
127.0.0.1:6379> ttl j3-liuliang				#查看剩余过期时间（秒）
(integer) 98
127.0.0.1:6379> 

1.9 EXPIRE（expire）

Redis Expire 命令用于设置 key 的过期时间。key 过期后将不再可用。

语法

127.0.0.1:6379> Expire KEY_NAME TIME_IN_SECONDS

可以版本：>= 1.0.0

返回值：

设置成功返回 1 。 当 key 不存在或者不能为 key 设置过期时间时(比如在低于 2.1.3 版本的 Redis 中你尝试更新 key 的过期时间)返回 0 。

案例

127.0.0.1:6379> flushall					#清空所有数据库数据
OK
127.0.0.1:6379> set j3-liuliang 18			#设置key并赋值
OK
127.0.0.1:6379> expire j3-liuliang 100		#给存在的key设置过期时间
(integer) 1
127.0.0.1:6379> ttl j3-liuliang				#查看剩余过期时间（秒）
(integer) 88
127.0.0.1:6379> 

以上实例中我们为键 j3-liuliang设置了过期时间为 100秒，100秒后该键会自动删除。

1.10 DEL（del）

Redis DEL 命令用于删除已存在的键。不存在的 key 会被忽略。

语法

127.0.0.1:6379> DEL KEY_NAME

可以版本：>= 1.0.0

返回值：被删除 key 的数量。

案例

127.0.0.1:6379> flushall		#清空所有数据库数据
OK
127.0.0.1:6379> set k1 v1		#设置key并赋值
OK
127.0.0.1:6379> del k1			#删除key
(integer) 1						#返回删除的数量
127.0.0.1:6379> del k2			
(integer) 0						#返回删除的数量 0 说明没有改变什么，表明该值不存在
127.0.0.1:6379> 

1.11 PTTL（pttl）

Redis PTTL命令以毫秒为单位返回 key 的剩余过期时间。

语法

127.0.0.1:6379> PTTL KEY_NAME

可以版本：>= 2.6.0

返回值：

当 key 不存在时，返回 -2 。 当 key 存在但没有设置剩余生存时间时，返回 -1 。 否则，以毫秒为单位，返回 key 的剩余生存时间。

**注意：**在 Redis 2.8 以前，当 key 不存在，或者 key 没有设置剩余生存时间时，命令都返回 -1 。

案例

127.0.0.1:6379> flushall					#清空所有数据库数据
OK
127.0.0.1:6379> set j3-liuliang 18			#设置key并赋值
OK
127.0.0.1:6379> expire j3-liuliang 100		#设置过期时间
(integer) 1
127.0.0.1:6379> pttl j3-liuliang			#返回key的剩余时间，毫秒
(integer) 91266
127.0.0.1:6379> pttl key					#查看不存在key的剩余时间，毫秒
(integer) -2
127.0.0.1:6379> set k1 v1					#设置key并赋值
OK
127.0.0.1:6379> pttl k1						#查看没有设置过期时间的key
(integer) -1
127.0.0.1:6379> 

1.12 RENAMENX（renamenx）

Redis Renamenx 命令用于在新的 key 不存在时修改 key 的名称 。

语法

127.0.0.1:6379> RENAMENX OLD_KEY_NAME NEW_KEY_NAME

可以版本：>= 1.0.0

返回值：修改成功时，返回 1 。 如果 NEW_KEY_NAME 已经存在，返回 0 。

案例

################### 第一种情况：newkey不存在（改名成功） ###################
127.0.0.1:6379> flushall						#清空数据库
OK
127.0.0.1:6379> set j3-liuliang 18				#设置key并赋值
OK
127.0.0.1:6379> renamenx j3-liuliang liuliang	#将key设置新值，新值不存在
(integer) 1
127.0.0.1:6379> exists j3-liuliang				#判断老key是否还存在
(integer) 0
127.0.0.1:6379> get j3-liuliang					#判断是否还可以取到老key的值
(nil)
127.0.0.1:6379> exists liuliang					#判断新key是否存在
(integer) 1
127.0.0.1:6379> get liuliang					#获取新key的值
"18"
127.0.0.1:6379>

################### 第二种情况：newkey存在（改名失败，不做变化） ###################
127.0.0.1:6379> flushall			#清空数据库
OK
127.0.0.1:6379> set k1 v1			#设置key并赋值
OK
127.0.0.1:6379> set k2 v2
OK
127.0.0.1:6379> renamenx k1 k2		#将key设置新值，新值存在
(integer) 0							#重命名失败
127.0.0.1:6379> get k1				#没有任何变化
"v1"
127.0.0.1:6379> get k2				#没有任何变化
"v2"
127.0.0.1:6379>

1.13 EXISTS（exists）

Redis EXISTS 命令用于检查给定 key 是否存在。

语法

127.0.0.1:6379> EXISTS KEY_NAME

可以版本：>= 1.0.0

返回值：若 key 存在返回 1 ，否则返回 0 。

案例

127.0.0.1:6379> flushall		#清空数据库
OK
127.0.0.1:6379> exists k1		#判断key是否存在
(integer) 0						#不存在
127.0.0.1:6379> set k1 v1		#设置key并赋值
OK
127.0.0.1:6379> exists k1		#判断key是否存在
(integer) 1						#存在
127.0.0.1:6379>

1.14 EXPIREAT（expireat）

EXPIREAT 的作用和 EXPIRE 类似，都用于为 key 设置过期时间。 不同在于 EXPIREAT 命令接受的时间参数是 UNIX 时间戳(unix timestamp)。

Redis Expireat 命令用于以 UNIX 时间戳(unix timestamp)格式设置 key 的过期时间。key 过期后将不再可用。

语法

127.0.0.1:6379> Expireat KEY_NAME TIME_IN_UNIX_TIMESTAMP

可以版本：>= 1.0.0

返回值：

设置成功返回 1 。 当 key 不存在或者不能为 key 设置过期时间时(比如在低于 2.1.3 版本的 Redis 中你尝试更新 key 的过期时间)返回 0 。

案例

127.0.0.1:6379> flushall							#清空数据库
OK
127.0.0.1:6379> set j3-liuliang 18					#设置key并赋值
OK
127.0.0.1:6379> expireat j3-liuliang 1293840000		#给key设置过期时间，时间是时间戳
(integer) 1
127.0.0.1:6379> ttl j3-liuliang						#查看剩余过期时间
(integer) -2
127.0.0.1:6379> exists j3-liuliang					#查看key是否还存在
(integer) 0
127.0.0.1:6379> 

1.15 KEYS（keys）

Redis Keys 命令用于查找所有符合给定模式 pattern 的 key 。。

语法

127.0.0.1:6379> KEYS PATTERN

可以版本：>= 1.0.0

返回值：符合给定模式的 key 列表 (Array)。

案例

127.0.0.1:6379> flushall		#清空数据库
OK
127.0.0.1:6379> set k1 v1		#创建一些key
OK
127.0.0.1:6379> set k2 v2
OK
127.0.0.1:6379> set m1 n1
OK
127.0.0.1:6379> set m2 n2
OK
127.0.0.1:6379> keys k*			#查找所有符合 k* 的key
1) "k1"
2) "k2"
127.0.0.1:6379> keys m*			#查找所有符合 m* 的key
1) "m2"
2) "m1"
127.0.0.1:6379> keys *			#查找所有的key
1) "m2"
2) "k1"
3) "m1"
4) "k2"
127.0.0.1:6379> 

结束语

• 本文结合Redis中文网和博主的实践案例所写，下期写String类型
• 由于博主才疏学浅，难免会有纰漏，假如你发现了错误或偏见的地方，还望留言给我指出来，我会对其加以修正。
• 如果你觉得文章还不错，你的转发、分享、点赞、留言就是对我最大的鼓励。
• 感谢您的阅读，十分欢迎并感谢您的关注。