一篇文章让你彻底学会 Redis !【全文两万字详细解说】 ...

打印 上一主题 下一主题

主题 1836|帖子 1836|积分 5508

目录
Redis 下令
语法
实例
在长途服务上执行下令
语法
实例
Redis 键(key)
语法
实例
Redis keys 下令
Redis 字符串(String)
语法
实例
Redis 字符串下令
Redis 哈希(Hash)
实例
Redis hash 下令
Redis 列表(List)
实例
Redis 列表下令
Redis 聚集(Set)
实例
Redis 聚集下令
Redis 有序聚集(sorted set)
实例
Redis 有序聚集下令
Redis HyperLogLog
什么是基数?
实例
Redis HyperLogLog 下令
Redis 发布订阅
实例
第一个 redis-cli 客户端
第二个 redis-cli 客户端
Redis 发布订阅下令
Redis 事务
实例
Redis 事务下令
Redis 脚本
语法
实例
Redis 脚本下令
Redis 连接
实例
Redis 连接下令
Redis 服务器
实例
Redis 服务器下令
Redis GEO
geoadd
实例
geopos
实例
geodist
实例
georadius、georadiusbymember
实例
实例
geohash
实例
Redis Stream
XADD
实例
XTRIM
实例
XDEL
实例
XLEN
实例
XRANGE
实例
XREVRANGE
实例
XREAD
实例
XGROUP CREATE
XREADGROUP GROUP

Redis 下令

Redis 下令用于在 redis 服务上执行操作。
要在 redis 服务上执行下令须要一个 redis 客户端。Redis 客户端在我们之前下载的的 redis 的安装包中。
语法

Redis 客户端的基本语法为:
  1. $ redis-cli
复制代码
实例

以下实例解说了如何启动 redis 客户端:
启动 redis 服务器,打开终端并输入下令 redis-cli,该下令会连接本地的 redis 服务。
  1. $ redis-cli
  2. redis 127.0.0.1:6379>
  3. redis 127.0.0.1:6379> PING
  4. PONG
复制代码
在以上实例中我们连接到本地的 redis 服务并执行 PING 下令,该下令用于检测 redis 服务是否启动。

在长途服务上执行下令

如果须要在长途 redis 服务上执行下令,同样我们使用的也是 redis-cli 下令。
语法

  1. $ redis-cli -h host -p port -a password
复制代码
实例

以下实例演示了如何连接到主机为 127.0.0.1,端口为 6379 ,密码为 mypass 的 redis 服务上。
  1. $redis-cli -h 127.0.0.1 -p 6379 -a "mypass"
  2. redis 127.0.0.1:6379>
  3. redis 127.0.0.1:6379> PING
  4. PONG
复制代码
Redis 键(key)

Redis 键下令用于管理 redis 的键。
语法

Redis 键下令的基本语法如下:
  1. redis 127.0.0.1:6379> COMMAND KEY_NAME
复制代码
实例

  1. redis 127.0.0.1:6379> SET runoobkey redis
  2. OK
  3. redis 127.0.0.1:6379> DEL runoobkey
  4. (integer) 1
复制代码
在以上实例中 DEL 是一个下令, runoobkey 是一个键。 如果键被删除成功,下令执行后输出 (integer) 1,否则将输出 (integer) 0

Redis keys 下令

下表给出了与 Redis 键相干的基本下令:
序号下令及形貌1DEL key
该下令用于在 key 存在时删除 key。2DUMP key
序列化给定 key ,并返回被序列化的值。3EXISTS key
检查给定 key 是否存在。4EXPIRE key seconds
为给定 key 设置逾期时间,以秒计。5EXPIREAT key timestamp
EXPIREAT 的作用和 EXPIRE 雷同,都用于为 key 设置逾期时间。 不同在于 EXPIREAT 下令担当的时间参数是 UNIX 时间戳(unix timestamp)。6PEXPIRE key milliseconds
设置 key 的逾期时间以毫秒计。7PEXPIREAT key milliseconds-timestamp
设置 key 逾期时间的时间戳(unix timestamp) 以毫秒计8KEYS pattern
查找所有符合给定模式( pattern)的 key 。9MOVE key db
将当前数据库的 key 移动到给定的数据库 db 当中。10PERSIST key
移除 key 的逾期时间,key 将长期保持。11PTTL key
以毫秒为单位返回 key 的剩余的逾期时间。12TTL key
以秒为单位,返回给定 key 的剩余生存时间(TTL, time to live)。13RANDOMKEY
从当前数据库中随机返回一个 key 。14RENAME key newkey
修改 key 的名称15RENAMENX key newkey
仅当 newkey 不存在时,将 key 改名为 newkey 。16SCAN cursor [MATCH pattern] [COUNT count]
迭代数据库中的数据库键。17TYPE key
返回 key 所储存的值的类型。 更多下令请参考:Commands | Docs
Redis 字符串(String)

Redis 字符串数据类型的相干下令用于管理 redis 字符串值,基本语法如下:
语法

  1. redis 127.0.0.1:6379> COMMAND KEY_NAME
复制代码
实例

  1. redis 127.0.0.1:6379> SET runoobkey redis
  2. OK
  3. redis 127.0.0.1:6379> GET runoobkey
  4. "redis"
复制代码
在以上实例中我们使用了 SET 和 GET 下令,键为 runoobkey

Redis 字符串下令

下表列出了常用的 redis 字符串下令:
序号下令及形貌1SET key value
设置指定 key 的值。2GET key
获取指定 key 的值。3GETRANGE key start end
返回 key 中字符串值的子字符4GETSET key value
将给定 key 的值设为 value ,并返回 key 的旧值(old value)。5GETBIT key offset
对 key 所储存的字符串值,获取指定偏移量上的位(bit)。6MGET key1 [key2..]
获取所有(一个或多个)给定 key 的值。7SETBIT key offset value
对 key 所储存的字符串值,设置或扫除指定偏移量上的位(bit)。8SETEX key seconds value
将值 value 关联到 key ,并将 key 的逾期时间设为 seconds (以秒为单位)。9SETNX key value
只有在 key 不存在时设置 key 的值。10SETRANGE key offset value
用 value 参数覆写给定 key 所储存的字符串值,从偏移量 offset 开始。11STRLEN key
返回 key 所储存的字符串值的长度。12MSET key value [key value ...]
同时设置一个或多个 key-value 对。13MSETNX key value [key value ...]
同时设置一个或多个 key-value 对,当且仅当所有给定 key 都不存在。14PSETEX key milliseconds value
这个下令和 SETEX 下令相似,但它以毫秒为单位设置 key 的生存时间,而不是像 SETEX 下令那样,以秒为单位。15INCR key
将 key 中储存的数字值增一。16INCRBY key increment
将 key 所储存的值加上给定的增量值(increment) 。17INCRBYFLOAT key increment
将 key 所储存的值加上给定的浮点增量值(increment) 。18DECR key
将 key 中储存的数字值减一。19DECRBY key decrement
key 所储存的值减去给定的减量值(decrement) 。20APPEND key value
如果 key 已经存在并且是一个字符串, APPEND 下令将指定的 value 追加到该 key 原来值(value)的末尾。 更多下令请参考:Commands | Docs
Redis 哈希(Hash)

Redis hash 是一个 string 类型的 field(字段) 和 value(值) 的映射表,hash 特殊得当用于存储对象。
Redis 中每个 hash 可以存储 232 - 1 键值对(40多亿)。
实例

  1. 127.0.0.1:6379>  HMSET runoobkey name "redis tutorial" description "redis basic commands for caching" likes 20 visitors 23000
  2. OK
  3. 127.0.0.1:6379>  HGETALL runoobkey
  4. 1) "name"
  5. 2) "redis tutorial"
  6. 3) "description"
  7. 4) "redis basic commands for caching"
  8. 5) "likes"
  9. 6) "20"
  10. 7) "visitors"
  11. 8) "23000"
复制代码
在以上实例中,我们设置了 redis 的一些形貌信息(name, description, likes, visitors) 到哈希表的 runoobkey 中。

Redis hash 下令

下表列出了 redis hash 基本的相干下令:
序号下令及形貌1HDEL key field1 [field2]
删除一个或多个哈希表字段2HEXISTS key field
查看哈希表 key 中,指定的字段是否存在。3HGET key field
获取存储在哈希表中指定字段的值。4HGETALL key
获取在哈希表中指定 key 的所有字段和值5HINCRBY key field increment
为哈希表 key 中的指定字段的整数值加上增量 increment 。6HINCRBYFLOAT key field increment
为哈希表 key 中的指定字段的浮点数值加上增量 increment 。7HKEYS key
获取哈希表中的所有字段8HLEN key
获取哈希表中字段的数量9HMGET key field1 [field2]
获取所有给定字段的值10HMSET key field1 value1 [field2 value2 ]
同时将多个 field-value (域-值)对设置到哈希表 key 中。11HSET key field value
将哈希表 key 中的字段 field 的值设为 value 。12HSETNX key field value
只有在字段 field 不存在时,设置哈希表字段的值。13HVALS key
获取哈希表中所有值。14HSCAN key cursor [MATCH pattern] [COUNT count]
迭代哈希表中的键值对。 更多下令请参考:Commands | Docs
Redis 列表(List)

Redis列表是简朴的字符串列表,按照插入顺序排序。你可以添加一个元素到列表的头部(左边)大概尾部(右边)
一个列表最多可以包罗 232 - 1 个元素 (4294967295, 每个列表凌驾40亿个元素)。
实例

  1. redis 127.0.0.1:6379> LPUSH runoobkey redis
  2. (integer) 1
  3. redis 127.0.0.1:6379> LPUSH runoobkey mongodb
  4. (integer) 2
  5. redis 127.0.0.1:6379> LPUSH runoobkey mysql
  6. (integer) 3
  7. redis 127.0.0.1:6379> LRANGE runoobkey 0 10
  8. 1) "mysql"
  9. 2) "mongodb"
  10. 3) "redis"
复制代码
在以上实例中我们使用了 LPUSH 将三个值插入了名为 runoobkey 的列表当中。
Redis 列表下令

下表列出了列表相干的基本下令:
序号下令及形貌1BLPOP key1 [key2 ] timeout
移出并获取列表的第一个元素, 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。2BRPOP key1 [key2 ] timeout
移出并获取列表的末了一个元素, 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。3BRPOPLPUSH source destination timeout
从列表中弹出一个值,将弹出的元素插入到别的一个列表中并返回它; 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。4LINDEX key index
通过索引获取列表中的元素5LINSERT key BEFORE|AFTER pivot value
在列表的元素前大概后插入元素6LLEN key
获取列表长度7LPOP key
移出并获取列表的第一个元素8LPUSH key value1 [value2]
将一个或多个值插入到列表头部9LPUSHX key value
将一个值插入到已存在的列表头部10LRANGE key start stop
获取列表指定范围内的元素11LREM key count value
移除列表元素12LSET key index value
通过索引设置列表元素的值13LTRIM key start stop
对一个列表进行修剪(trim),就是说,让列表只保留指定区间内的元素,不在指定区间之内的元素都将被删除。14RPOP key
移除列表的末了一个元素,返回值为移除的元素。15RPOPLPUSH source destination
移除列表的末了一个元素,并将该元素添加到另一个列表并返回16RPUSH key value1 [value2]
在列表中添加一个或多个值到列表尾部17RPUSHX key value
为已存在的列表添加值
Redis 聚集(Set)

Redis 的 Set 是 String 类型的无序聚集。聚集成员是唯一的,这就意味着聚集中不能出现重复的数据。
聚集对象的编码可以是 intset 大概 hashtable。
Redis 中聚集是通过哈希表实现的,所以添加,删除,查找的复杂度都是 O(1)。
聚集中最大的成员数为 232 - 1 (4294967295, 每个聚集可存储40多亿个成员)。
实例

  1. redis 127.0.0.1:6379> SADD runoobkey redis
  2. (integer) 1
  3. redis 127.0.0.1:6379> SADD runoobkey mongodb
  4. (integer) 1
  5. redis 127.0.0.1:6379> SADD runoobkey mysql
  6. (integer) 1
  7. redis 127.0.0.1:6379> SADD runoobkey mysql
  8. (integer) 0
  9. redis 127.0.0.1:6379> SMEMBERS runoobkey
  10. 1) "mysql"
  11. 2) "mongodb"
  12. 3) "redis"
复制代码
在以上实例中我们通过 SADD 下令向名为 runoobkey 的聚集插入的三个元素。

Redis 聚集下令

下表列出了 Redis 聚集基本下令:
序号下令及形貌1SADD key member1 [member2]
向聚集添加一个或多个成员2SCARD key
获取聚集的成员数3SDIFF key1 [key2]
返回第一个聚集与其他聚集之间的差异。4SDIFFSTORE destination key1 [key2]
返回给定所有聚集的差集并存储在 destination 中5SINTER key1 [key2]
返回给定所有聚集的交集6SINTERSTORE destination key1 [key2]
返回给定所有聚集的交集并存储在 destination 中7SISMEMBER key member
判断 member 元素是否是聚集 key 的成员8SMEMBERS key
返回聚集中的所有成员9SMOVE source destination member
将 member 元素从 source 聚集移动到 destination 聚集10SPOP key
移除并返回聚集中的一个随机元素11SRANDMEMBER key [count]
返回聚集中一个或多个随机数12SREM key member1 [member2]
移除聚集中一个或多个成员13SUNION key1 [key2]
返回所有给定聚集的并集14SUNIONSTORE destination key1 [key2]
所有给定聚集的并集存储在 destination 聚集中15SSCAN key cursor [MATCH pattern] [COUNT count]
迭代聚集中的元素
Redis 有序聚集(sorted set)

Redis 有序聚集和聚集一样也是 string 类型元素的聚集,且不允许重复的成员。
不同的是每个元素都会关联一个 double 类型的分数。redis 正是通太过数来为聚集中的成员进行从小到大的排序。
有序聚集的成员是唯一的,但分数(score)却可以重复。
聚集是通过哈希表实现的,所以添加,删除,查找的复杂度都是 O(1)。 聚集中最大的成员数为 232 - 1 (4294967295, 每个聚集可存储40多亿个成员)。
实例

  1. redis 127.0.0.1:6379> ZADD runoobkey 1 redis
  2. (integer) 1
  3. redis 127.0.0.1:6379> ZADD runoobkey 2 mongodb
  4. (integer) 1
  5. redis 127.0.0.1:6379> ZADD runoobkey 3 mysql
  6. (integer) 1
  7. redis 127.0.0.1:6379> ZADD runoobkey 3 mysql
  8. (integer) 0
  9. redis 127.0.0.1:6379> ZADD runoobkey 4 mysql
  10. (integer) 0
  11. redis 127.0.0.1:6379> ZRANGE runoobkey 0 10 WITHSCORES
  12. 1) "redis"
  13. 2) "1"
  14. 3) "mongodb"
  15. 4) "2"
  16. 5) "mysql"
  17. 6) "4"
复制代码
在以上实例中我们通过下令 ZADD 向 redis 的有序聚集中添加了三个值并关联上分数。

Redis 有序聚集下令

下表列出了 redis 有序聚集的基本下令:
序号下令及形貌1ZADD key score1 member1 [score2 member2]
向有序聚集添加一个或多个成员,大概更新已存在成员的分数2ZCARD key
获取有序聚集的成员数3ZCOUNT key min max
盘算在有序聚集中指定区间分数的成员数4ZINCRBY key increment member
有序聚集中对指定成员的分数加上增量 increment5ZINTERSTORE destination numkeys key [key ...]
盘算给定的一个或多个有序集的交集并将结果集存储在新的有序聚集 destination 中6ZLEXCOUNT key min max
在有序聚集中盘算指定字典区间内成员数量7ZRANGE key start stop [WITHSCORES]
通过索引区间返回有序聚集指定区间内的成员8ZRANGEBYLEX key min max [LIMIT offset count]
通过字典区间返回有序聚集的成员9ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT]
通太过数返回有序聚集指定区间内的成员10ZRANK key member
返回有序聚集中指定成员的索引11ZREM key member [member ...]
移除有序聚集中的一个或多个成员12ZREMRANGEBYLEX key min max
移除有序聚集中给定的字典区间的所有成员13ZREMRANGEBYRANK key start stop
移除有序聚集中给定的排名区间的所有成员14ZREMRANGEBYSCORE key min max
移除有序聚集中给定的分数区间的所有成员15ZREVRANGE key start stop [WITHSCORES]
返回有序集中指定区间内的成员,通过索引,分数从高到低16ZREVRANGEBYSCORE key max min [WITHSCORES]
返回有序集中指定分数区间内的成员,分数从高到低排序17ZREVRANK key member
返回有序聚集中指定成员的排名,有序集成员按分数值递减(从大到小)排序18ZSCORE key member
返回有序集中,成员的分数值19ZUNIONSTORE destination numkeys key [key ...]
盘算给定的一个或多个有序集的并集,并存储在新的 key 中20ZSCAN key cursor [MATCH pattern] [COUNT count]
迭代有序聚集中的元素(包罗元素成员和元素分值)
Redis HyperLogLog

Redis 在 2.8.9 版本添加了 HyperLogLog 布局。
Redis HyperLogLog 是用来做基数统计的算法,HyperLogLog 的优点是,在输入元素的数量大概体积非常非常大时,盘算基数所需的空间总是固定 的、并且是很小的。
在 Redis 里面,每个 HyperLogLog 键只须要花费 12 KB 内存,就可以盘算接近 2^64 个不同元素的基 数。这和盘算基数时,元素越多泯灭内存就越多的聚集形成鲜明对比。
但是,因为 HyperLogLog 只会根据输入元向来盘算基数,而不会储存输入元素本身,所以 HyperLogLog 不能像聚集那样,返回输入的各个元素。

什么是基数?

比如数据集 {1, 3, 5, 7, 5, 7, 8}, 那么这个数据集的基数集为 {1, 3, 5 ,7, 8}, 基数(不重复元素)为5。 基数估计就是在误差可担当的范围内,快速盘算基数。

实例

以下实例演示了 HyperLogLog 的工作过程:
  1. redis 127.0.0.1:6379> PFADD runoobkey "redis"
  2. 1) (integer) 1
  3. redis 127.0.0.1:6379> PFADD runoobkey "mongodb"
  4. 1) (integer) 1
  5. redis 127.0.0.1:6379> PFADD runoobkey "mysql"
  6. 1) (integer) 1
  7. redis 127.0.0.1:6379> PFCOUNT runoobkey
  8. (integer) 3
复制代码

Redis HyperLogLog 下令

下表列出了 redis HyperLogLog 的基本下令:
序号下令及形貌1PFADD key element [element ...]
添加指定元素到 HyperLogLog 中。2PFCOUNT key [key ...]
返回给定 HyperLogLog 的基数估算值。3PFMERGE destkey sourcekey [sourcekey ...]
将多个 HyperLogLog 合并为一个 HyperLogLog
Redis 发布订阅

Redis 发布订阅 (pub/sub) 是一种消息通信模式:发送者 (pub) 发送消息,订阅者 (sub) 接收消息。
Redis 客户端可以订阅任意数量的频道。
下图展示了频道 channel1 , 以及订阅这个频道的三个客户端 —— client2 、 client5 和 client1 之间的关系:


当有新消息通过 PUBLISH 下令发送给频道 channel1 时, 这个消息就会被发送给订阅它的三个客户端:



实例

以下实例演示了发布订阅是如何工作的,须要开启两个 redis-cli 客户端。
在我们实例中我们创建了订阅频道名为 runoobChat:
第一个 redis-cli 客户端

  1. redis 127.0.0.1:6379> SUBSCRIBE runoobChat
  2. Reading messages... (press Ctrl-C to quit)
  3. 1) "subscribe"
  4. 2) "runoobChat"
  5. 3) (integer) 1
复制代码
现在,我们先重新开启个 redis 客户端,然后在同一个频道 runoobChat 发布两次消息,订阅者就能接收到消息。
第二个 redis-cli 客户端

  1. redis 127.0.0.1:6379> PUBLISH runoobChat "Redis PUBLISH test"
  2. (integer) 1
  3. redis 127.0.0.1:6379> PUBLISH runoobChat "Learn redis by runoob.com"
  4. (integer) 1
  5. # 订阅者的客户端会显示如下消息
  6.  1) "message"
  7. 2) "runoobChat"
  8. 3) "Redis PUBLISH test"
  9.  1) "message"
  10. 2) "runoobChat"
  11. 3) "Learn redis by runoob.com"
复制代码
gif 演示如下:


  • 开启本地 Redis 服务,开启两个 redis-cli 客户端。
  • 第一个 redis-cli 客户端输入 SUBSCRIBE runoobChat,意思是订阅 runoobChat 频道。
  • 第二个 redis-cli 客户端输入 PUBLISH runoobChat "Redis PUBLISH test" 往 runoobChat 频道发送消息,这个时候在第一个 redis-cli 客户端就会看到由第二个 redis-cli 客户端发送的测试消息。



Redis 发布订阅下令

下表列出了 redis 发布订阅常用下令:
序号下令及形貌1PSUBSCRIBE pattern [pattern ...]
订阅一个或多个符合给定模式的频道。2PUBSUB subcommand [argument [argument ...]]
查看订阅与发布体系状态。3PUBLISH channel message
将信息发送到指定的频道。4PUNSUBSCRIBE [pattern [pattern ...]]
退订所有给定模式的频道。5SUBSCRIBE channel [channel ...]
订阅给定的一个或多个频道的信息。6UNSUBSCRIBE [channel [channel ...]]
指退订给定的频道。
Redis 事务

Redis 事务可以一次执行多个下令, 并且带有以下三个重要的包管:


  • 批量操作在发送 EXEC 下令前被放入队列缓存。
  • 收到 EXEC 下令后进入事务执行,事务中任意下令执行失败,其余的下令依然被执行。
  • 在事务执行过程,其他客户端提交的下令请求不会插入到事务执行下令序列中。
一个事务从开始到执行会履历以下三个阶段:


  • 开始事务。
  • 下令入队。
  • 执行事务。

实例

以下是一个事务的例子, 它先以 MULTI 开始一个事务, 然后将多个下令入队到事务中, 末了由 EXEC 下令触发事务, 一并执行事务中的所有下令:
  1. redis 127.0.0.1:6379> MULTI
  2. OK
  3. redis 127.0.0.1:6379> SET book-name "Mastering C++ in 21 days"
  4. QUEUED
  5. redis 127.0.0.1:6379> GET book-name
  6. QUEUED
  7. redis 127.0.0.1:6379> SADD tag "C++" "Programming" "Mastering Series"
  8. QUEUED
  9. redis 127.0.0.1:6379> SMEMBERS tag
  10. QUEUED
  11. redis 127.0.0.1:6379> EXEC
  12. 1) OK
  13. 2) "Mastering C++ in 21 days"
  14. 3) (integer) 3
  15. 4) 1) "Mastering Series"
  16.    2) "C++"
  17.    3) "Programming"
复制代码
单个 Redis 下令的执行是原子性的,但 Redis 没有在事务上增加任何维持原子性的机制,所以 Redis 事务的执行并不是原子性的。
事务可以理解为一个打包的批量执行脚本,但批量指令并非原子化的操作,中间某条指令的失败不会导致前面已做指令的回滚,也不会造成后续的指令不做。
   这是官网上的说明 From redis docs on transactions:
  It's important to note that even when a command fails, all the other commands in the queue are processed – Redis will not stop the processing of commands.
  比如:
  1. redis 127.0.0.1:7000> multi
  2. OK
  3. redis 127.0.0.1:7000> set a aaa
  4. QUEUED
  5. redis 127.0.0.1:7000> set b bbb
  6. QUEUED
  7. redis 127.0.0.1:7000> set c ccc
  8. QUEUED
  9. redis 127.0.0.1:7000> exec
  10. 1) OK
  11. 2) OK
  12. 3) OK
复制代码
如果在 set b bbb 处失败,set a 已成功不会回滚,set c 还会继续执行。

Redis 事务下令

下表列出了 redis 事务的相干下令:
序号下令及形貌1DISCARD
取消事务,放弃执行事务块内的所有下令。2EXEC
执行所有事务块内的下令。3MULTI
标记一个事务块的开始。4UNWATCH
取消 WATCH 下令对所有 key 的监视。5WATCH key [key ...]
监视一个(或多个) key ,如果在事务执行之前这个(或这些) key 被其他下令所改动,那么事务将被打断。
Redis 脚本

Redis 脚本使用 Lua 表明器来执行脚本。 Redis 2.6 版本通过内嵌支持 Lua 环境。执行脚本的常用下令为 EVAL
语法

Eval 下令的基本语法如下:
  1. redis 127.0.0.1:6379> EVAL script numkeys key [key ...] arg [arg ...]
复制代码
实例

以下实例演示了 redis 脚本工作过程:
  1. redis 127.0.0.1:6379> EVAL "return {KEYS[1],KEYS[2],ARGV[1],ARGV[2]}" 2 key1 key2 first second
  2. 1) "key1"
  3. 2) "key2"
  4. 3) "first"
  5. 4) "second"
复制代码

Redis 脚本下令

下表列出了 redis 脚本常用下令:
序号下令及形貌1EVAL script numkeys key [key ...] arg [arg ...]
执行 Lua 脚本。2EVALSHA sha1 numkeys key [key ...] arg [arg ...]
执行 Lua 脚本。3SCRIPT EXISTS script [script ...]
查看指定的脚本是否已经被保存在缓存当中。4SCRIPT FLUSH
从脚本缓存中移除所有脚本。5SCRIPT KILL
杀死当前正在运行的 Lua 脚本。6SCRIPT LOAD script
将脚本 script 添加到脚本缓存中,但并不立即执行这个脚本。
Redis 连接

Redis 连接下令重要是用于连接 redis 服务。
实例

以下实例演示了客户端如何通过密码验证连接到 redis 服务,并检测服务是否在运行:
  1. redis 127.0.0.1:6379> AUTH "password"
  2. OK
  3. redis 127.0.0.1:6379> PING
  4. PONG
复制代码

Redis 连接下令

下表列出了 redis 连接的基本下令:
序号下令及形貌1AUTH password
验证密码是否正确2ECHO message
打印字符串3PING
查看服务是否运行4QUIT
关闭当前连接5SELECT index
切换到指定的数据库
Redis 服务器

Redis 服务器下令重要是用于管理 redis 服务。
实例

以下实例演示了如何获取 redis 服务器的统计信息:
  1. redis 127.0.0.1:6379> INFO
  2. # Server
  3. redis_version:2.8.13
  4. redis_git_sha1:00000000
  5. redis_git_dirty:0
  6. redis_build_id:c2238b38b1edb0e2
  7. redis_mode:standalone
  8. os:Linux 3.5.0-48-generic x86_64
  9. arch_bits:64
  10. multiplexing_api:epoll
  11. gcc_version:4.7.2
  12. process_id:3856
  13. run_id:0e61abd297771de3fe812a3c21027732ac9f41fe
  14. tcp_port:6379
  15. uptime_in_seconds:11554
  16. uptime_in_days:0
  17. hz:10
  18. lru_clock:16651447
  19. config_file:
  20. # Clients
  21. connected_clients:1
  22. client-longest_output_list:0
  23. client-biggest_input_buf:0
  24. blocked_clients:0
  25. # Memory
  26. used_memory:589016
  27. used_memory_human:575.21K
  28. used_memory_rss:2461696
  29. used_memory_peak:667312
  30. used_memory_peak_human:651.67K
  31. used_memory_lua:33792
  32. mem_fragmentation_ratio:4.18
  33. mem_allocator:jemalloc-3.6.0
  34. # Persistence
  35. loading:0
  36. rdb_changes_since_last_save:3
  37. rdb_bgsave_in_progress:0
  38. rdb_last_save_time:1409158561
  39. rdb_last_bgsave_status:ok
  40. rdb_last_bgsave_time_sec:0
  41. rdb_current_bgsave_time_sec:-1
  42. aof_enabled:0
  43. aof_rewrite_in_progress:0
  44. aof_rewrite_scheduled:0
  45. aof_last_rewrite_time_sec:-1
  46. aof_current_rewrite_time_sec:-1
  47. aof_last_bgrewrite_status:ok
  48. aof_last_write_status:ok
  49. # Stats
  50. total_connections_received:24
  51. total_commands_processed:294
  52. instantaneous_ops_per_sec:0
  53. rejected_connections:0
  54. sync_full:0
  55. sync_partial_ok:0
  56. sync_partial_err:0
  57. expired_keys:0
  58. evicted_keys:0
  59. keyspace_hits:41
  60. keyspace_misses:82
  61. pubsub_channels:0
  62. pubsub_patterns:0
  63. latest_fork_usec:264
  64. # Replication
  65. role:master
  66. connected_slaves:0
  67. master_repl_offset:0
  68. repl_backlog_active:0
  69. repl_backlog_size:1048576
  70. repl_backlog_first_byte_offset:0
  71. repl_backlog_histlen:0
  72. # CPU
  73. used_cpu_sys:10.49
  74. used_cpu_user:4.96
  75. used_cpu_sys_children:0.00
  76. used_cpu_user_children:0.01
  77. # Keyspace
  78. db0:keys=94,expires=1,avg_ttl=41638810
  79. db1:keys=1,expires=0,avg_ttl=0
  80. db3:keys=1,expires=0,avg_ttl=0
复制代码

Redis 服务器下令

下表列出了 redis 服务器的相干下令:
序号下令及形貌1BGREWRITEAOF
异步执行一个 AOF(AppendOnly File) 文件重写操作2BGSAVE
在后台异步保存当前数据库的数据到磁盘3CLIENT KILL [ip:port] [ID client-id]
关闭客户端连接4CLIENT LIST
获取连接到服务器的客户端连接列表5CLIENT GETNAME
获取连接的名称6CLIENT PAUSE timeout
在指定时间内终止运行来自客户端的下令7CLIENT SETNAME connection-name
设置当前连接的名称8CLUSTER SLOTS
获取集群节点的映射数组9COMMAND
获取 Redis 下令详情数组10COMMAND COUNT
获取 Redis 下令总数11COMMAND GETKEYS
获取给定下令的所有键12TIME
返回当前服务器时间13COMMAND INFO command-name [command-name ...]
获取指定 Redis 下令形貌的数组14CONFIG GET parameter
获取指定配置参数的值15CONFIG REWRITE
对启动 Redis 服务器时所指定的 redis.conf 配置文件进行改写16CONFIG SET parameter value
修改 redis 配置参数,无需重启17CONFIG RESETSTAT
重置 INFO 下令中的某些统计数据18DBSIZE
返回当前数据库的 key 的数量19DEBUG OBJECT key
获取 key 的调试信息20DEBUG SEGFAULT
让 Redis 服务崩溃21FLUSHALL
删除所有数据库的所有key22FLUSHDB
删除当前数据库的所有key23INFO [section]
获取 Redis 服务器的各种信息和统计数值24LASTSAVE
返回近来一次 Redis 成功将数据保存到磁盘上的时间,以 UNIX 时间戳格式表示25MONITOR
实时打印出 Redis 服务器接收到的下令,调试用26ROLE
返回主从实例所属的角色27SAVE
同步保存数据到硬盘28SHUTDOWN [NOSAVE] [SAVE]
异步保存数据到硬盘,并关闭服务器29SLAVEOF host port
将当前服务器变化为指定服务器的从属服务器(slave server)30SLOWLOG subcommand [argument]
管理 redis 的慢日志31SYNC
用于复制功能(replication)的内部下令
Redis GEO

Redis GEO 重要用于存储地理位置信息,并对存储的信息进行操作,该功能在 Redis 3.2 版本新增。
Redis GEO 操作方法有:


  • geoadd:添加地理位置的坐标。
  • geopos:获取地理位置的坐标。
  • geodist:盘算两个位置之间的间隔。
  • georadius:根据用户给定的经纬度坐标来获取指定范围内的地理位置聚集。
  • georadiusbymember:根据储存在位置聚集里面的某个所在获取指定范围内的地理位置聚集。
  • geohash:返回一个或多个位置对象的 geohash 值。
geoadd

geoadd 用于存储指定的地理空间位置,可以将一个或多个经度(longitude)、纬度(latitude)、位置名称(member)添加到指定的 key 中。
geoadd 语法格式如下:
  1. GEOADD key longitude latitude member [longitude latitude member ...]
复制代码
以下实例中 key 为 Sicily,Palermo 和 Catania 为位置名称 :
实例

  1. redis> GEOADD Sicily 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania"
  2. (integer) 2
  3. redis> GEODIST Sicily Palermo Catania
  4. "166274.1516"
  5. redis> GEORADIUS Sicily 15 37 100 km
  6. 1) "Catania"
  7. redis> GEORADIUS Sicily 15 37 200 km
  8. 1) "Palermo"
  9. 2) "Catania"
  10. redis>
复制代码
geopos

geopos 用于从给定的 key 里返回所有指定名称(member)的位置(经度和纬度),不存在的返回 nil。
geopos 语法格式如下:
  1. GEOPOS key member [member ...]
复制代码
实例

  1. redis> GEOADD Sicily 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania"
  2. (integer) 2
  3. redis> GEOPOS Sicily Palermo Catania NonExisting
  4. 1) 1) "13.36138933897018433"
  5.    2) "38.11555639549629859"
  6. 2) 1) "15.08726745843887329"
  7.    2) "37.50266842333162032"
  8. 3) (nil)
  9. redis>
复制代码
geodist

geodist 用于返回两个给定位置之间的间隔。
geodist 语法格式如下:
  1. GEODIST key member1 member2 [m|km|ft|mi]
复制代码
member1 member2 为两个地理位置。
末了一个间隔单位参数说明:


  • m :米,默认单位。
  • km :千米。
  • mi :英里。
  • ft :英尺。
  • > 盘算 Palermo 与 Catania 之间的间隔:
    实例

    1. redis> GEOADD Sicily 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania"
    2. (integer) 2
    3. redis> GEODIST Sicily Palermo Catania
    4. "166274.1516"
    5. redis> GEODIST Sicily Palermo Catania km
    6. "166.2742"
    7. redis> GEODIST Sicily Palermo Catania mi
    8. "103.3182"
    9. redis> GEODIST Sicily Foo Bar
    10. (nil)
    11. redis>
    复制代码
    georadius、georadiusbymember

    georadius 以给定的经纬度为中心, 返回键包罗的位置元素当中, 与中心的间隔不凌驾给定最大间隔的所有位置元素。
    georadiusbymember 和 GEORADIUS 下令一样, 都可以找出位于指定范围内的元素, 但是 georadiusbymember 的中心点是由给定的位置元素决定的, 而不是使用经度和纬度来决定中心点。
    georadius 与 georadiusbymember 语法格式如下:
    1. GEORADIUS key longitude latitude radius m|km|ft|mi [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count] [ASC|DESC] [STORE key] [STOREDIST key]
    2. GEORADIUSBYMEMBER key member radius m|km|ft|mi [WITHCOORD] [WITHDIST] [WITHHASH] [COUNT count] [ASC|DESC] [STORE key] [STOREDIST key]
    复制代码
    参数说明:

    • m :米,默认单位。
    • km :千米。
    • mi :英里。
    • ft :英尺。
    • WITHDIST: 在返回位置元素的同时, 将位置元素与中心之间的间隔也一并返回。
    • WITHCOORD: 将位置元素的经度和纬度也一并返回。
    • WITHHASH: 以 52 位有符号整数的形式, 返回位置元素经过原始 geohash 编码的有序聚集分值。 这个选项重要用于底层应用大概调试, 实际中的作用并不大。
    • COUNT 限定返回的纪录数。
    • ASC: 查找结果根据间隔从近到远排序。
    • DESC: 查找结果根据从远到近排序。
    georadius 实例:
    实例

    1. redis> GEOADD Sicily 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania"
    2. (integer) 2
    3. redis> GEORADIUS Sicily 15 37 200 km WITHDIST
    4. 1) 1) "Palermo"
    5.    2) "190.4424"
    6. 2) 1) "Catania"
    7.    2) "56.4413"
    8. redis> GEORADIUS Sicily 15 37 200 km WITHCOORD
    9. 1) 1) "Palermo"
    10.    2) 1) "13.36138933897018433"
    11.       2) "38.11555639549629859"
    12. 2) 1) "Catania"
    13.    2) 1) "15.08726745843887329"
    14.       2) "37.50266842333162032"
    15. redis> GEORADIUS Sicily 15 37 200 km WITHDIST WITHCOORD
    16. 1) 1) "Palermo"
    17.    2) "190.4424"
    18.    3) 1) "13.36138933897018433"
    19.       2) "38.11555639549629859"
    20. 2) 1) "Catania"
    21.    2) "56.4413"
    22.    3) 1) "15.08726745843887329"
    23.       2) "37.50266842333162032"
    24. redis>
    复制代码
    georadiusbymember 实例:
    实例

    1. redis> GEOADD Sicily 13.583333 37.316667 "Agrigento"
    2. (integer) 1
    3. redis> GEOADD Sicily 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania"
    4. (integer) 2
    5. redis> GEORADIUSBYMEMBER Sicily Agrigento 100 km
    6. 1) "Agrigento"
    7. 2) "Palermo"
    8. redis>
    复制代码
    geohash

    Redis GEO 使用 geohash 来保存地理位置的坐标。
    geohash 用于获取一个或多个位置元素的 geohash 值。
    geohash 语法格式如下:
    1. GEOHASH key member [member ...]
    复制代码
    实例:
    实例

    1. redis> GEOADD Sicily 13.361389 38.115556 "Palermo" 15.087269 37.502669 "Catania"
    2. (integer) 2
    3. redis> GEOHASH Sicily Palermo Catania
    4. 1) "sqc8b49rny0"
    5. 2) "sqdtr74hyu0"
    6. redis>
    7.  
    复制代码


Redis Stream

Redis Stream 是 Redis 5.0 版本新增加的数据布局。
Redis Stream 重要用于消息队列(MQ,Message Queue),Redis 本身是有一个 Redis 发布订阅 (pub/sub) 来实现消息队列的功能,但它有个缺点就是消息无法长期化,如果出现网络断开、Redis 宕机等,消息就会被抛弃。
简朴来说发布订阅 (pub/sub) 可以分发消息,但无法纪录汗青消息。
而 Redis Stream 提供了消息的长期化和主备复制功能,可以让任何客户端访问任何时刻的数据,并且能记着每一个客户端的访问位置,还能包管消息不丢失。
Redis Stream 的布局如下所示,它有一个消息链表,将所有加入的消息都串起来,每个消息都有一个唯一的 ID 和对应的内容:


每个 Stream 都有唯一的名称,它就是 Redis 的 key,在我们初次使用 xadd 指令追加消息时主动创建。
上图解析:


  • Consumer Group :消费组,使用 XGROUP CREATE 下令创建,一个消费组有多个消费者(Consumer)。
  • last_delivered_id :游标,每个消费组会有个游标 last_delivered_id,任意一个消费者读取了消息都会使游标 last_delivered_id 往前移动。
  • pending_ids :消费者(Consumer)的状态变量,作用是维护消费者的未确认的 id。 pending_ids 纪录了当前已经被客户端读取的消息,但是还没有 ack (Acknowledge character:确认字符)。
消息队列相干下令:


  • XADD - 添加消息到末尾
  • XTRIM - 对流进行修剪,限制长度
  • XDEL - 删除消息
  • XLEN - 获取流包罗的元素数量,即消息长度
  • XRANGE - 获取消息列表,会主动过滤已经删除的消息
  • XREVRANGE - 反向获取消息列表,ID 从大到小
  • XREAD - 以阻塞或非阻塞方式获取消息列表
消费者组相干下令:


  • XGROUP CREATE - 创建消费者组
  • XREADGROUP GROUP - 读取消费者组中的消息
  • XACK - 将消息标记为"已处理"
  • XGROUP SETID - 为消费者组设置新的末了递送消息ID
  • XGROUP DELCONSUMER - 删除消费者
  • XGROUP DESTROY - 删除消费者组
  • XPENDING - 显示待处理消息的相干信息
  • XCLAIM - 转移消息的归属权
  • XINFO - 查看流和消费者组的相干信息;
  • XINFO GROUPS - 打印消费者组的信息;
  • XINFO STREAM - 打印流信息
XADD

使用 XADD 向队列添加消息,如果指定的队列不存在,则创建一个队列,XADD 语法格式:
  1. XADD key ID field value [field value ...]
复制代码


  • key :队列名称,如果不存在就创建
  • ID :消息 id,我们使用 * 表示由 redis 天生,可以自定义,但是要本身包管递增性。
  • field value : 纪录。
实例

  1. redis> XADD mystream * name Sara surname OConnor
  2. "1601372323627-0"
  3. redis> XADD mystream * field1 value1 field2 value2 field3 value3
  4. "1601372323627-1"
  5. redis> XLEN mystream
  6. (integer) 2
  7. redis> XRANGE mystream - +
  8. 1) 1) "1601372323627-0"
  9.    2) 1) "name"
  10.       2) "Sara"
  11.       3) "surname"
  12.       4) "OConnor"
  13. 2) 1) "1601372323627-1"
  14.    2) 1) "field1"
  15.       2) "value1"
  16.       3) "field2"
  17.       4) "value2"
  18.       5) "field3"
  19.       6) "value3"
  20. redis>
复制代码
XTRIM

使用 XTRIM 对流进行修剪,限制长度, 语法格式:
  1. XTRIM key MAXLEN [~] count
复制代码


  • key :队列名称
  • MAXLEN :长度
  • count :数量
实例

  1. 127.0.0.1:6379> XADD mystream * field1 A field2 B field3 C field4 D
  2. "1601372434568-0"
  3. 127.0.0.1:6379> XTRIM mystream MAXLEN 2
  4. (integer) 0
  5. 127.0.0.1:6379> XRANGE mystream - +
  6. 1) 1) "1601372434568-0"
  7.    2) 1) "field1"
  8.       2) "A"
  9.       3) "field2"
  10.       4) "B"
  11.       5) "field3"
  12.       6) "C"
  13.       7) "field4"
  14.       8) "D"
  15. 127.0.0.1:6379>
  16. redis>
复制代码
XDEL

使用 XDEL 删除消息,语法格式:
  1. XDEL key ID [ID ...]
复制代码


  • key:队列名称
  • ID :消息 ID
实例

  1. > XADD mystream * a 1
  2. 1538561698944-0
  3. > XADD mystream * b 2
  4. 1538561700640-0
  5. > XADD mystream * c 3
  6. 1538561701744-0
  7. > XDEL mystream 1538561700640-0
  8. (integer) 1
  9. 127.0.0.1:6379> XRANGE mystream - +
  10. 1) 1) 1538561698944-0
  11.    2) 1) "a"
  12.       2) "1"
  13. 2) 1) 1538561701744-0
  14.    2) 1) "c"
  15.       2) "3"
复制代码
XLEN

使用 XLEN 获取流包罗的元素数量,即消息长度,语法格式:
  1. XLEN key
复制代码


  • key:队列名称
实例

  1. redis> XADD mystream * item 1
  2. "1601372563177-0"
  3. redis> XADD mystream * item 2
  4. "1601372563178-0"
  5. redis> XADD mystream * item 3
  6. "1601372563178-1"
  7. redis> XLEN mystream
  8. (integer) 3
  9. redis>
复制代码
XRANGE

使用 XRANGE 获取消息列表,会主动过滤已经删除的消息 ,语法格式:
  1. XRANGE key start end [COUNT count]
复制代码


  • key :队列名
  • start :开始值, - 表示最小值
  • end :竣事值, + 表示最大值
  • count :数量
实例

  1. redis> XADD writers * name Virginia surname Woolf
  2. "1601372577811-0"
  3. redis> XADD writers * name Jane surname Austen
  4. "1601372577811-1"
  5. redis> XADD writers * name Toni surname Morrison
  6. "1601372577811-2"
  7. redis> XADD writers * name Agatha surname Christie
  8. "1601372577812-0"
  9. redis> XADD writers * name Ngozi surname Adichie
  10. "1601372577812-1"
  11. redis> XLEN writers
  12. (integer) 5
  13. redis> XRANGE writers - + COUNT 2
  14. 1) 1) "1601372577811-0"
  15.    2) 1) "name"
  16.       2) "Virginia"
  17.       3) "surname"
  18.       4) "Woolf"
  19. 2) 1) "1601372577811-1"
  20.    2) 1) "name"
  21.       2) "Jane"
  22.       3) "surname"
  23.       4) "Austen"
  24. redis>
复制代码
XREVRANGE

使用 XREVRANGE 获取消息列表,会主动过滤已经删除的消息 ,语法格式:
  1. XREVRANGE key end start [COUNT count]
复制代码


  • key :队列名
  • end :竣事值, + 表示最大值
  • start :开始值, - 表示最小值
  • count :数量
实例

  1. redis> XADD writers * name Virginia surname Woolf
  2. "1601372731458-0"
  3. redis> XADD writers * name Jane surname Austen
  4. "1601372731459-0"
  5. redis> XADD writers * name Toni surname Morrison
  6. "1601372731459-1"
  7. redis> XADD writers * name Agatha surname Christie
  8. "1601372731459-2"
  9. redis> XADD writers * name Ngozi surname Adichie
  10. "1601372731459-3"
  11. redis> XLEN writers
  12. (integer) 5
  13. redis> XREVRANGE writers + - COUNT 1
  14. 1) 1) "1601372731459-3"
  15.    2) 1) "name"
  16.       2) "Ngozi"
  17.       3) "surname"
  18.       4) "Adichie"
  19. redis>
复制代码
XREAD

使用 XREAD 以阻塞或非阻塞方式获取消息列表 ,语法格式:
  1. XREAD [COUNT count] [BLOCK milliseconds] STREAMS key [key ...] id [id ...]
复制代码


  • count :数量
  • milliseconds :可选,阻塞毫秒数,没有设置就黑白阻塞模式
  • key :队列名
  • id :消息 ID
实例

  1. # 从 Stream 头部读取两条消息
  2. > XREAD COUNT 2 STREAMS mystream writers 0-0 0-0
  3. 1) 1) "mystream"
  4.    2) 1) 1) 1526984818136-0
  5.          2) 1) "duration"
  6.             2) "1532"
  7.             3) "event-id"
  8.             4) "5"
  9.             5) "user-id"
  10.             6) "7782813"
  11.       2) 1) 1526999352406-0
  12.          2) 1) "duration"
  13.             2) "812"
  14.             3) "event-id"
  15.             4) "9"
  16.             5) "user-id"
  17.             6) "388234"
  18. 2) 1) "writers"
  19.    2) 1) 1) 1526985676425-0
  20.          2) 1) "name"
  21.             2) "Virginia"
  22.             3) "surname"
  23.             4) "Woolf"
  24.       2) 1) 1526985685298-0
  25.          2) 1) "name"
  26.             2) "Jane"
  27.             3) "surname"
  28.             4) "Austen"
复制代码
XGROUP CREATE

使用 XGROUP CREATE 创建消费者组,语法格式:
  1. XGROUP [CREATE key groupname id-or-$] [SETID key groupname id-or-$] [DESTROY key groupname] [DELCONSUMER key groupname consumername]
复制代码


  • key :队列名称,如果不存在就创建
  • groupname :组名。
  • $ : 表示从尾部开始消费,只担当新消息,当前 Stream 消息会全部忽略。
从头开始消费:
  1. XGROUP CREATE mystream consumer-group-name 0-0  
复制代码
从尾部开始消费:
  1. XGROUP CREATE mystream consumer-group-name $
复制代码
XREADGROUP GROUP

使用 XREADGROUP GROUP 读取消费组中的消息,语法格式:
  1. XREADGROUP GROUP group consumer [COUNT count] [BLOCK milliseconds] [NOACK] STREAMS key [key ...] ID [ID ...]
复制代码


  • group :消费组名
  • consumer :消费者名。
  • count : 读取数量。
  • milliseconds : 阻塞毫秒数。
  • key : 队列名。
  • ID : 消息 ID。
  1. XREADGROUP GROUP consumer-group-name consumer-name COUNT 1 STREAMS mystream >
复制代码

如果小假的内容对你有帮助,请点赞,评论,收藏。创作不易,大家的支持就是我坚持下去的动力! 


免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

x
回复

使用道具 举报

0 个回复

倒序浏览

快速回复

您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

欢乐狗

论坛元老
这个人很懒什么都没写!
快速回复 返回顶部 返回列表