Redis 命令速查表

作者

Prasan Kumar, Redis 的技术解决方案开发人员

作者

Will Johnston, Redis 的开发者增长经理

连接#

注意

要设置本地或云中的 Redis，请参考教程

字符串/数字#

通用#

哈希#

集合#

排序集#

列表#

流#

REDIS 堆栈命令

Redis 堆栈扩展了 Redis OSS 的核心功能，如跨哈希和 JSON 文档查询、时间序列数据支持、全文搜索等

JSON#

搜索和查询#

最后更新于 2024 年 5 月 24 日

上一页Heroku 上的 Redis

下一页使用编程语言开发您的应用程序

在本页

# Syntax
redis-cli -u redis://host:port
redis-cli -u redis://username:password@host:port

# Examples
redis-cli
redis-cli -u redis://localhost:6379
redis-cli -u redis://myuser:mypassword@localhost:6379

# If you run Redis through Docker
docker exec -it <container-id-or-name> redis-cli

命令	语法	示例	输出
SET	SET key value	`SET myKey "Hello"`	"OK"
描述: 将 key 设置为保存字符串值。如果 key 已保存值，则无论其类型如何，都将被覆盖。时间复杂度: O(1)
GET	GET key	`GET myKey`	"Hello"
描述: 获取 key 的字符串值。如果 key 不存在，则返回特殊值 nil。时间复杂度: O(1)
MGET	MGET key [key ...]	`MGET myKey nonExistentKey`	1) "Hello" 2) (nil)
描述: 返回所有指定 key 的值。对于每个 key，如果它不保存字符串值或不存在，则返回特殊值 nil。时间复杂度: O(N)
INCR	INCR key	`INCR myCounter`	(integer) 1
描述: 将 key 中存储的数字加 1。如果 key 不存在，则在执行操作之前将其设置为 0。时间复杂度: O(1)

命令	语法	示例	输出
KEYS	KEYS pattern	`KEYS my*`	1) "myKey" 2) "myCounter"
描述: 返回与模式匹配的所有 key。时间复杂度: O(N)
EXISTS	EXISTS key [key ...]	`EXISTS myKey`	(integer) 1
描述: 检查一个或多个 key 是否存在。时间复杂度: O(N)
EXPIRE	EXPIRE key seconds	`EXPIRE myKey 120`	(integer) 1
描述: 为 key 设置超时。超时到期后，key 将自动删除。时间复杂度:O(1)
TTL	TTL key	`TTL myKey`	(integer) 113
描述: 返回具有超时的 key 的剩余生存时间。时间复杂度: O(1)
PERSIST	PERSIST key	`PERSIST myKey`	(integer) 1
描述: 删除 key 的过期时间。时间复杂度:O(1)
SCAN	SCAN cursor [MATCH pattern] [COUNT count]	`SCAN 0 MATCH my* COUNT 2`	1) "3" 2) 1) "myCounter" 2) "myKey"
描述: 迭代当前选定 Redis 数据库中的 key 集。时间复杂度: 每次调用 O(1)。对于完整的迭代，O(N)。
DEL	DEL key [key ...]	`DEL myKey`	(integer) 1
描述: 删除指定的 key。时间复杂度: O(N)
INFO	INFO [section]	`INFO server INFO keyspace`	# Server redis_version:6.2.5 redis_git_sha1:00000000 redis_build_id:9893b2a-dirty redis_mode:standalone os:Linux 5.4.72-microsoft-standard-WSL2 x86_64 arch_bits:64 ... # Keyspace db0:keys=2,expires=0,avg_ttl=0
描述:返回有关服务器的信息和统计信息，包括不同的部分，例如 - 服务器、客户端、内存、持久性、统计信息、复制、cpu、commandstats、latencystats、sentinel、cluster、modules、keyspace、errorstats。时间复杂度: O(1)

命令	语法	示例	输出
HSET	HSET key field value [field value ...]	`HSET h_employee_profile:101 name "Nicol" age 33`	(integer) 2
描述: 将指定的字段设置为存储在 key 中的哈希中各自的值。时间复杂度: O(N)
HGET	HGET key field	`HGET h_employee_profile:101 name`	"Nicol"
描述: 返回与存储在 key 中的哈希中的 field 关联的值。时间复杂度: O(1)
HGETALL	HGETALL key	`HGETALL h_employee_profile:101`	1) "name" 2) "Nicol" 3) "age" 4) "33"
描述: 返回存储在 key 中的哈希的所有字段和值。时间复杂度: O(N)
HMGET	HMGET key field1 [field2]	`HMGET h_employee_profile:101 name age`	1) "Nicol" 2) "33"
描述: 返回与存储在 key 中的哈希中的指定字段关联的值。时间复杂度: O(N)

命令	语法	示例	输出
XADD	XADD key field value [field value ...]	`XADD myStream * sensorId "1234" temperature "19.8"`	1518951480106-0
描述: 将指定的流条目追加到指定 key 的流中。时间复杂度: 添加新条目时为 O(1)。
XREAD	XREAD [COUNT count] [BLOCK milliseconds] STREAMS key [key ...] ID [ID ...]	`XREAD COUNT 2 STREAMS myStream 0`	1) 1) "myStream" 2) 1) 1) "1518951480106-0" 2) 1) "sensorId" 2) "1234" 3) "temperature" 4) "19.8"
描述: 从一个或多个流中读取数据，仅返回ID 大于调用者报告的最后一个接收到的 ID 的条目。
XRANGE	XRANGE key start end [COUNT count]	`XRANGE myStream 1518951480106-0 1518951480106-0`	1) 1) 1) "1518951480106-0" 2) 1) "sensorId" 2) "1234" 3) "temperature" 4) "19.8"
描述: 返回与流中的一系列 ID 匹配的条目。时间复杂度: O(N)，其中 N 是要返回的元素数量。如果 N 是常数（例如，始终要求使用 COUNT 返回前 10 个元素），则可以将其视为 O(1)。
XLEN	XLEN key	`XLEN myStream`	(integer) 1
描述: 返回流的条目数量。时间复杂度: O(1)
XDEL	XDEL key ID [ID ...]	`XDEL myStream 1518951480106-0`	(integer) 1
描述: 从流中删除指定的条目。时间复杂度: 在流中删除每个单个项目时为 O(1)
XTRIM	XTRIM key MAXLEN [~] count	`XTRIM myStream MAXLEN 0`	(integer) 0
描述: 将流修剪到不同的长度。时间复杂度: O(N)，其中 N 是被逐出的条目数量。但是，常数时间非常小，因为条目在包含多个条目的宏节点中组织，这些条目可以使用单个释放来释放。

命令	语法	示例	输出
ZADD	ZADD key score member [score member ...]	`ZADD myZSet 1 "one" 2 "two"`	(integer) 2
描述：将指定成员与其相应的得分添加到键存储的排序集中。时间复杂度： O(log(N))
ZRANGE	ZRANGE key start stop [WITHSCORES]	`ZRANGE myZSet 0 -1`	1) "one" 2)"two"
描述：返回键存储的排序集中指定范围内的元素。时间复杂度： O(log(N)+M)，其中 M 是返回的元素数量

命令	语法	示例	输出
LPUSH	LPUSH key value [value ...]	`LPUSH myList "World"`	(integer) 1
描述：将指定值插入键存储的列表的头部。时间复杂度： O(N)
RPUSH	RPUSH key value [value ...]	`RPUSH myList "Hello"`	(integer) 2
描述：将指定值插入键存储的列表的尾部。时间复杂度： O(N)
LRANGE	LRANGE key start stop	`LRANGE myList 0 -1`	1) "World" 2) "Hello"
描述：返回键存储的列表中指定范围内的元素。时间复杂度： O(S+N)，其中 S 是 start 的距离，N 是指定范围内的元素数量。
LLEN	LLEN key	`LLEN myList`	(integer) 2
描述：返回键存储的列表的长度。时间复杂度： O(1)
LPOP	LPOP key [count]	`LPOP myList`	"World"
描述：删除并返回键存储的列表中的第一个元素。时间复杂度： O(N)
RPOP	RPOP key [count]	`RPOP myList`	"Hello"
描述：删除并返回键存储的列表中的最后一个元素。时间复杂度： O(N)

命令	语法	示例	输出
LPUSH	LPUSH key value [value ...]	`LPUSH myList "World"`	(integer) 1
描述：将指定值插入键存储的列表的头部。时间复杂度： O(N)
RPUSH	RPUSH key value [value ...]	`RPUSH myList "Hello"`	(integer) 2
描述：将指定值插入键存储的列表的尾部。时间复杂度： O(N)
LRANGE	LRANGE key start stop	`LRANGE myList 0 -1`	1) "World" 2) "Hello"
描述：返回键存储的列表中指定范围内的元素。时间复杂度： O(S+N)，其中 S 是 start 的距离，N 是指定范围内的元素数量。
LLEN	LLEN key	`LLEN myList`	(integer) 2
描述：返回键存储的列表的长度。时间复杂度： O(1)
LPOP	LPOP key [count]	`LPOP myList`	"World"
描述：删除并返回键存储的列表中的第一个元素。时间复杂度： O(N)
RPOP	RPOP key [count]	`RPOP myList`	"Hello"
描述：删除并返回键存储的列表中的最后一个元素。时间复杂度： O(N)

命令	语法	示例	输出
JSON.SET	JSON.SET key path value	`JSON.SET employee_profile:1 . '{"name":"Alice"}'`	OK
描述：在 key 中的 path 设置 JSON 值。时间复杂度： O(M+N)，其中 M 是原始大小，N 是新大小
JSON.GET	JSON.GET key [path [path ...]]	`JSON.GET employee_profile:1`	`{ "name": 'Alice' }`
描述：返回 key 中 path 的 JSON 值。时间复杂度：当 path 被评估为单个值时为 O(N)，其中 N 是值的大小，当 path 被评估为多个值时为 O(N)，其中 N 是键的大小
JSON.NUMINCRBY	JSON.NUMINCRBY key path number	`JSON.SET employee_profile:1 .age 30 JSON.NUMINCRBY employee_profile:1 .age 5`	35
描述：增加 JSON 文档中的一个数字。时间复杂度：当 path 被评估为单个值时为 O(1)，当 path 被评估为多个值时为 O(N)，其中 N 是键的大小
JSON.OBJKEYS	JSON.OBJKEYS key [path]	`JSON.OBJKEYS employee_profile:1`	1) "name" 2) "age"
描述：返回 path 引用的对象中的键。时间复杂度：当 path 被评估为单个值时为 O(N)，其中 N 是对象中的键的数量，当 path 被评估为多个值时为 O(N)，其中 N 是键的大小
JSON.OBJLEN	JSON.OBJLEN key [path]	`JSON.OBJLEN employee_profile:1`	(integer) 2
描述：报告 key 中 path 的 JSON 对象中的键的数量。时间复杂度：当 path 被评估为单个值时为 O(1)，当 path 被评估为多个值时为 O(N)，其中 N 是键的大小
JSON.ARRAPPEND	JSON.ARRAPPEND key [path] value [value ...]	`JSON.SET employee_profile:1 .colors '["red", "green", "blue"]' JSON.ARRAPPEND employee_profile:1 .colors '"yellow"'`	(integer) 4
描述：将 JSON 值附加到 path 的数组中最后一个元素之后。时间复杂度：为每个添加的值 O(1)，为添加多个值 O(N)，其中 N 是键的大小
JSON.ARRINSERT	JSON.ARRINSERT key path index value [value ...]	`JSON.ARRINSERT employee_profile:1 .colors 2 '"purple"'`	(integer) 5
描述：将 JSON 值插入 path 数组中的索引之前（向右移动）。时间复杂度：当 path 被评估为单个值时为 O(N)，其中 N 是数组的大小，当 path 被评估为多个值时为 O(N)，其中 N 是键的大小
JSON.ARRINDEX	JSON.ARRINDEX key path value [start [stop]]	`JSON.ARRINDEX employee_profile:1 .colors '"purple"'`	(integer) 2
描述：在数组中搜索 JSON 值的第一次出现。时间复杂度：当 path 被评估为单个值时为 O(N)，其中 N 是数组的大小，当 path 被评估为多个值时为 O(N)，其中 N 是键的大小

命令	语法	示例	输出
FT.CREATE	`FT.CREATE index [ON HASH \| JSON] [PREFIX count prefix [prefix ...]] [FILTER {filter}] SCHEMA field_name [AS alias] TEXT \| TAG \| NUMERIC \| GEO \| VECTOR \| GEOSHAPE [ SORTABLE [UNF]] [NOINDEX] ...`	`FT.CREATE staff:index ON JSON PREFIX 1 staff: SCHEMA "$.name" AS name TEXT "$.age" AS age NUMERIC "$.isSingle" AS isSingle TAG '$["skills"][*]' AS skills TAG SEPARATOR "\|"`	OK
描述：使用给定的规范创建索引。时间复杂度： O(K)，其中 K 是文档中的字段数量，对于 keySpace 中的键 O(N)
FT.SEARCH	`FT.SEARCH index query [FILTER numeric_field min max [ FILTER numeric_field min max ...]] [RETURN count identifier [AS property] [ identifier [AS property] ...]] [SORTBY sortby [ ASC \| DESC] [WITHCOUNT]] [LIMIT offset num] [PARAMS nargs name value [ name value ...]]`	`JSON.SET "staff:1" "$" '{"name":"Bob","age":22,"isSingle":true,"skills":["NodeJS","MongoDB","React"]}' JSON.SET "staff:2" "$" '{"name":"Alex","age":45,"isSingle":true,"skills":["Python","MySQL","Angular"]}' FT.SEARCH staff:index "(@name:'alex')" RETURN 1 $ LIMIT 0 10 FT.SEARCH staff:index "((@isSingle:{true}) (@age:[(18 +inf]))" RETURN 1 $ LIMIT 0 10`	匹配的文档数据
描述：使用查询搜索索引，返回文档或仅返回 ID。时间复杂度： O(N)
FT.AGGREGATE	`FT.AGGREGATE index query [LOAD count field [field ...]] [ GROUPBY nargs property [property ...] [ REDUCE function nargs arg [arg ...] [AS name] ... [ SORTBY nargs [ property ASC \| DESC [ property ASC \| DESC ...]] [MAX num] [WITHCOUNT] [ APPLY expression AS name ... [ LIMIT offset num] [FILTER filter] [ PARAMS nargs name value [ name value ...]]`	`FT.AGGREGATE staff:index "(@age:[(18 +inf])" GROUPBY 1 @age REDUCE COUNT_DISTINCT 1 @name AS staff_count`	`\| age \| staff_count \| \| ----\| ------------\| \| 22 \| 1 \| \| 45 \| 1 \|`
描述：对索引运行搜索查询，并对结果执行聚合转换。
FT.INFO	FT.INFO index	`FT.INFO staff:index`	索引的配置参数和统计信息列表。
描述：返回索引的信息和统计信息。时间复杂度： O(1)
FT.DROPINDEX	FT.DROPINDEX index [DD]	`FT.DROPINDEX staff:index`	OK
描述：删除现有索引。时间复杂度：O(1) 或 O(N) 如果文档被删除，其中 N 是 keyspace 中的键数量