【Redis】Redis基本命令（1）

KEYS

返回所有满足样式（pattern）的key。

• KEY * 返回所有key，不简易使用

  性能问题：当 Redis 存储百万级键时，会消耗大量 CPU 和内存资源，Redis 是单线程模型，KEYS * 执行期间会阻塞其他所有命令（包括读写操作），导致服务短暂不可用。

  生产环境风险：

  阻塞导致请求堆积

  客户端超时重试

  最终导致 Redis 崩溃

  返回大量键名时可能撑爆客户端内存

• yid?i 其中 ？匹配任意一个字符，比如 yidai 、 yidei 、yidii
  

• yid*i 其中 * 匹配任意一串字符，比如 yidai 、 yideeeeei 、yidi
  

• yi[ae]ai 其中 [ae] 代表匹配 a 或者 e 任意一个字符，比如 yidai 、 yidei
  

• yi[^e]ai 其中 [^e] 代表匹配除了 e 的任意一个字符，比如 yidai 但不匹配 yidei
  

• yi[a-e]ai 其中 [a-e] 代表匹配 a 到 e 任意一个字符，比如 yidai 、 yidei 、yidbi

  用法：KEYS pattern
  

  命令有效版本：1.0.0 以后

  时间复杂度为O（N）

  返回值为匹配 pattern 的所有 key

EXIST

判断某个key是否存在

语法：EXISTS key [key ...]

可以一次查找一个或者多个key

 127.0.0.1:6379> EXISTS yidai 
(integer) 1
127.0.0.1:6379> EXISTS yidai yidi hello
(integer) 3

时间复杂度为O（1）

返回值为 key 存在的个数

DEL

删除指定的 key

可以一次删除一个或者多个key

语法：DEL key [key ...]

127.0.0.1:6379> DEL yidai yidi 
(integer) 2

返回值：删除key的个数

时间复杂度：O（1）

EXPIRE

为指定的 key 添加秒级的过期时间（Time To Live TTL）

语法：EXPIRE key seconds

时间复杂度：O（1）

返回值：成功时返回1，失败返回0

127.0.0.1:6379> EXPIRE hello 10
(integer) 1

TTL

获取指定 key 的过期时间，秒级。

语法：TTL key

时间复杂度：O(1)

返回值：剩余过期时间。-1 表示没有关联过期时间，-2 表示 key 不存在。

127.0.0.1:6379> TTL yidei
(integer) -1

TYPE

Redis TYPE 命令返回值详解

返回值	对应的数据结构	示例或说明
string	字符串类型	SET name "Alice" → TYPE name 返回 string
list	列表类型	LPUSH fruits "apple" → TYPE fruits 返回 list
hash	哈希类型	HSET user:1 name "Bob" → TYPE user:1 返回 hash
set	集合类型	SADD tags "red" → TYPE tags 返回 set
zset	有序集合类型	ZADD leaderboard 100 "player1" → TYPE leaderboard 返回 zset
stream	流类型（Redis 5.0+）	XADD mystream * field1 "value1" → TYPE mystream 返回 stream
none	key 不存在	TYPE non_existent_key 返回 none

语法​​：TYPE key_name

​​时间复杂度​​：O(1)
​​特殊场景​​：

• 已过期的 key 仍会返回原类型,直到 redis 清除
• 空数据结构（如空列表）仍返回对应类型
• 模块扩展类型可能返回自定义类型名

127.0.0.1:6379> SET greeting "Hello"
OK
127.0.0.1:6379> TYPE greeting
string
127.0.0.1:6379> TYPE missing_key
none

redis 的5种数据类型内部编码

Redis 数据结构内部编码对照表

数据结构	内部编码	说明
string	raw	普通字符串编码（长度大于44字节时使用）
	int	整数值编码（当字符串可表示为64位整数时）
	embstr	嵌入式字符串编码（长度≤44字节时使用，内存连续分配）
hash	hashtable	标准哈希表实现（元素较多时使用）
	ziplist	压缩列表实现（元素较少且值较小时默认使用）
list	linkedlist	双向链表实现（Redis 3.2前使用）
	ziplist	压缩列表实现（Redis 3.2前默认）
	quicklist	快速列表实现（Redis 3.2+默认，由ziplist组成的双向链表）
set	hashtable	标准哈希表实现
	intset	整数集合实现（当元素均为整数且数量较少时使用）
zset	skiplist	跳表+哈希表组合实现（元素较多时使用）
	ziplist	压缩列表实现（元素较少且值较小时默认使用）

关键说明：

1. 编码转换阈值 （可通过配置文件调整）：

   # redis.conf 示例配置
   hash-max-ziplist-entries 512  # hash元素超过512时转hashtable
   hash-max-ziplist-value 64      # hash字段值超过64字节时转hashtable

object encoding

可以查看数据结构内部编码

127.0.0.1:6379> set hello world
OK
127.0.0.1:6379> lpush mylist a b c
(integer) 3
127.0.0.1:6379> object encoding hello
"embstr"
127.0.0.1:6379> object encoding mylist
"quicklist"

Redis 这样设计有两个好处：

内存效率​​：针对不同数据特征选择最优编码

​​性能优化​​：平衡读写速度与存储开销

​​弹性扩展​​：自动适应数据规模变化

String字符串

字符串类型是 Redis 最基础的数据类型，关于字符串需要特别注意：

1）⾸先 Redis 中所有的键的类型都是字符串类型，⽽且其他⼏种数据结构也都是在字符串类似基础上构建的，例如列表和集合的元素类型是字符串类型

2）字符串类型的值实际可以是字符串，包含⼀般格式的字符串或者类似 JSON、XML 格式的字符串；数字，可以是整型或者浮点型；甚⾄是⼆进制流数据，例如图片、⾳频、视频等。不过⼀个字符串的最大值不能超过 512 MB。

注意：由于 Redis 内部存储字符串完全是按照⼆进制流的形式保存的，所以 Redis 是不处理字符集编码问题的，客⼾端传⼊的命令中使⽤的是什么字符集编码，就存储什么字符集编码。

SET

将 string 类型的 value 设置到 key 中。如果 key 之前存在，则覆盖，⽆论原来的数据类型是什么。之前关于此 key 的 TTL 也全部失效。

语法：SET key value [expiration EX seconds|PX milliseconds] [NX|XX]

时间复杂度：O(1)

选项：

SET 命令⽀持多种选项来影响它的⾏为：

• EX seconds⸺使⽤秒作为单位设置 key 的过期时间。
• PX milliseconds⸺使⽤毫秒作为单位设置 key 的过期时间。
• NX ⸺只在 key 不存在时才进行设置，即如果 key 之前已经存在，设置不执行。
• XX ⸺只在 key 存在时才进行设置，即如果 key 之前不存在，设置不执行。
  返回值：
• 如果设置成功，返回 OK。
• 如果由于 SET 指定了 NX 或者 XX 但条件不满足，SET 不会执行，并返回 (nil)。

127.0.0.1:6379> SET hello 1  EX 10 
OK
127.0.0.1:6379> ttl hello
(integer) 8
127.0.0.1:6379> set hello 2 px 1000
OK
127.0.0.1:6379> pttl hello
(integer) -2
127.0.0.1:6379> set hello 2 px 1000
OK
127.0.0.1:6379> pttl hello
(integer) 490
127.0.0.1:6379> set hello 111 NX
OK
127.0.0.1:6379> set hello 111 NX
(nil)
127.0.0.1:6379> set yidai 123 EX 10 XX
(nil)
127.0.0.1:6379> set yidai 123 EX 10 NX
OK
127.0.0.1:6379> set yidai 123 EX 10 XX
OK

SETNX

设置 key-value 但只允许在 key 之前不存在的情况下

语法：SETNX key value

时间复杂度：O(1)

返回值：1 表示设置成功。0 表示没有设置。

127.0.0.1:6379> SETNX YIDAI 123
(integer) 1
127.0.0.1:6379> SETNX YIDAI 123
(integer) 0

GET

获取 key 对应的 value。

语法：GET key

时间复杂度：O（1）

返回值：key 对应的 value，或者 nil 当 key 不存在。如果 value 的数据类型不是 string，会报错。

127.0.0.1:6379> lpush yidai 1 2 3
(integer) 3
127.0.0.1:6379> TYPE yidai
list
127.0.0.1:6379> GET yidai
(error) WRONGTYPE Operation against a key holding the wrong kind of value
127.0.0.1:6379> set key 1
OK
127.0.0.1:6379> get key
"1"

MGET

⼀次性获取多个 key 的值。如果对应的 key 不存在或者对应的数据类型不是 string，返回 nil

语法：MGET key [key ...]

时间复杂度：O（K）,K是key的个数

返回值：对应value的列表

127.0.0.1:6379> set hello 1
OK
127.0.0.1:6379> set yidai 2
OK
127.0.0.1:6379> mget hello yidai
1) "1"
2) "2"

MSET

⼀次性设置多个 key 的值。

语法：MSET key value [key value ...]

时间复杂度：O（K）,K是key的个数

返回值：OK

127.0.0.1:6379> MSET key1 1 key2 2
OK

多次GET 和 MGET的区别

其中 MGET 有效减少了网络通信的时间，一次查找完了多个key值，而 get

需要多次查询，增加了网络通信时间消耗，降低了效率
注意：用MGET也需要注意查询建的个数，不能过于庞大，否则可能导致命令执行时间过长，导致Redis阻塞

计数命令

INCR

将 key 对应的 string 表⽰的数字加⼀。如果 key 不存在，则视为 key 对应的 value 是 0。如果 key 对应的 string 不是⼀个整型或者范围超过了 64 位有符号整型，则报错。

语法：INCR key

时间复杂度：O（1）

返回值：integer 类型的加完后的数值

127.0.0.1:6379> EXISTS LL
(integer) 0
127.0.0.1:6379> INCR LL
(integer) 1
127.0.0.1:6379> INCR LL
(integer) 2
127.0.0.1:6379> SET KK 10
OK
127.0.0.1:6379> INCR KK
(integer) 11
127.0.0.1:6379> SET NUM 239204940933333333333333333335333333333333
OK
127.0.0.1:6379> INCR NUM
(error) ERR value is not an integer or out of range
127.0.0.1:6379> SET str dsdaf
OK
127.0.0.1:6379> INCR str
(error) ERR value is not an integer or out of range

INCRBY

将 key 对应的 string 表示的数字加上对应的值。如果 key 不存在，则视为 key 对应的 value 是 0。如果 key 对应的 string 不是⼀个整型或者范围超过了 64 位有符号整型，则报错。

语法：INCRBY key decrement

时间复杂度：O（1）

返回值：integer 类型的加完后的数值

127.0.0.1:6379> EXISTS ky
(integer) 0
127.0.0.1:6379> INCRBY ky 2
(integer) 2
127.0.0.1:6379> INCRBY by -1
(integer) -1

DECR

将 key 对应的 string 表⽰的数字减⼀。如果 key 不存在，则视为 key 对应的 value 是 0。如果 key 对应的 string 不是⼀个整型或者范围超过了 64 位有符号整型，则报错

语法：DECR key

时间复杂度：O（1）

返回值：integer 类型的减完后的数值

127.0.0.1:6379> EXISTS ui
(integer) 0
127.0.0.1:6379> DECR ui
(integer) -1

DECRBY

将 key 对应的 string 表示的数字减上对应的值。如果 key 不存在，则视为 key 对应的 value 是 0。如果 key 对应的 string 不是⼀个整型或者范围超过了 64 位有符号整型，则报错。

语法：DECRBY key decrement

时间复杂度：O（1）

返回值：integer 类型的加完后的数值

127.0.0.1:6379> EXISTS we 
(integer) 0
127.0.0.1:6379> DECRBY we -2
(integer) 2

INCRBYFLOAT

将 key 对应的 string 表⽰的浮点数加上对应的值。如果对应的值是负数，则视为减去对应的值。如果key 不存在，则视为 key 对应的 value 是 0。如果 key 对应的不是 string，或者不是⼀个浮点数，则报错。允许采⽤科学计数法表示浮点数。

语法：INCRBYFLOAT key increment

时间复杂度：O（1）

返回值：加/减完后的数值

127.0.0.1:6379> EXISTS float
(integer) 0
127.0.0.1:6379> INCRBY float -1
(integer) -1
127.0.0.1:6379> INCRBYFLOAT float -1
"-2"
127.0.0.1:6379> INCRBYFLOAT float -0.5
"-2.5"
127.0.0.1:6379> INCRBYFLOAT float 10.5
"8"
127.0.0.1:6379> INCRBYFLOAT float 1e5
"100008"

APPEND

如果 key 已经存在并且是⼀个 string，命令会将 value 追加到原有 string 的后边。如果 key 不存在，则效果等同于 SET 命令。

语法：APPEND KEY VALUE

时间复杂度：O（1）

返回值：追加完成之后 string 的⻓度。

127.0.0.1:6379> EXISTS ss
(integer) 0
127.0.0.1:6379> APPEND ss 1
(integer) 1
127.0.0.1:6379> GET ss
"1"
127.0.0.1:6379> APPEND ss sdad
(integer) 5
127.0.0.1:6379> GET ss
"1sdad"

GETRANGE

返回 key 对应的 string 的子串，由 start 和 end 确定（左闭右闭）。可以使用负数表示倒数。-1 代表倒数第⼀个字符，-2 代表倒数第⼆个，其他的与此类似。超过范围的偏移量会根据 string 的长度调整成正确的值

语法：GETRANGE key start end

时间复杂度：O（N）

返回值：string类型的子串

127.0.0.1:6379> SET yidai "i am yidai"
OK
127.0.0.1:6379> GETRANGE yidayi 0 4
""
127.0.0.1:6379> GETRANGE yidai 0 4
"i am "
127.0.0.1:6379> GETRANGE yidai 0 7
"i am yid"
127.0.0.1:6379> GETRANGE yidai 0 9
"i am yidai"

SETRANGE

覆盖字符串的⼀部分，从指定的偏移开始

语法：SETRANGE key offset value

时间复杂度：O（N）

返回值：替换后 string类型的长度

127.0.0.1:6379> SET key "hello world"
OK
127.0.0.1:6379> SETRANGE key 6 redis
(integer) 11
127.0.0.1:6379> GET key
"hello redis"

STRLEN

获取 key 对应的 string 的⻓度。当 key 存放的类似不是 string 时，报错。

语法：STRLEN key

时间复杂度：O（1）

返回值：string 的长度。或者当 key 不存在时，返回 0。

127.0.0.1:6379> SET yidai yidai
OK
127.0.0.1:6379> STRLEN yidia
(integer) 0
127.0.0.1:6379> STRLEN yidai
(integer) 5