PDF《Redis 文档》

0 号数据库中所有已过期的键. 事件通过 Redis 的订阅与发布功能(pub/sub)来进行分发, 因此所有支持订阅与发布功能 的客户端都可以在无须做任何修改的情况下, 直接使用键空间通知功能. 因为 Redis 目前的订阅与发布功能采取的是发送即忘(fire and forget)策略, 所以如果你的 程序需要可靠事件通知(reliable notification of events), 那么目前的键空间通知可能并不适 合你: 当订阅事件的客户端断线时, 它会丢失所有在断线期间分发给它的事件. 未来将会支持更可靠的事件分发, 这种支持可能会通过让订阅与发布功能本身变得更可靠来 实现, 也可能会在 Lua 脚本中对消息(message)的订阅与发布进行监听, 从而实现类似将 事件推入到列表这样的操作. 事件的类型 对于每个修改数据库的操作,键空间通知都会发送两种不同类型的事件. 比如说,对

0 号数据库的键 mykey 执行 DEL 命令时, 系统将分发两条消息, 相当于执行 以下两个 PUBLISH 命令: PUBLISH __keyspace@0__:mykey del PUBLISH __keyevent@0__:del mykey Redis 中文文档

10 键空间通知(keyspace notification) 订阅第一个频道 __keyspace@0__:mykey 可以接收

0 号数据库中所有修改键 mykey 的事 件, 而订阅第二个频道 __keyevent@0__:del 则可以接收

0 号数据库中所有执行 del 命令 的键. 以 keyspace 为前缀的频道被称为键空间通知(key-space notification), 而以 keyevent 为前缀的频道则被称为键事件通知(key-event notification). 当 del mykey 命令执行时: 键空间频道的订阅者将接收到被执行的事件的名字,在这个例子中,就是 del . 键事件频道的订阅者将接收到被执行事件的键的名字,在这个例子中,就是 mykey . 配置 因为开启键空间通知功能需要消耗一些 CPU , 所以在默认配置下, 该功能处于关闭状态. 可以通过修改 redis.conf 文件, 或者直接使用 CONFIG SET 命令来开启或关闭键空间通知 功能: 当 notify-keyspace-events 选项的参数为空字符串时,功能关闭. 另一方面,当参数不是空字符串时,功能开启. notify-keyspace-events 的参数可以是以下字符的任意组合, 它指定了服务器该发送哪些类 型的通知: 字符 发送的通知 K 键空间通知,所有通知以 __keyspace@<

db>

__ 为前缀 E 键事件通知,所有通知以 __keyevent@<

db>

__ 为前缀 g DEL 、 EXPIRE 、 RENAME 等类型无关的通用命令的通知 $ 字符串命令的通知 l 列表命令的通知 s 集合命令的通知 h 哈希命令的通知 z 有序集合命令的通知 x 过期事件:每当有过期键被删除时发送 e 驱逐(evict)事件:每当有键因为 maxmemory 政策而被删除时发送 A 参数 g$lshzxe 的别名 输入的参数中至少要有一个 K 或者 E , 否则的话, 不管其余的参数是什么, 都不会有任 何通知被分发. Redis 中文文档

11 键空间通知(keyspace notification) 举个例子, 如果只想订阅键空间中和列表相关的通知, 那么参数就应该设为 Kl , 诸如此 类. 将参数设为字符串 AKE 表示发送所有类型的通知. 命令产生的通知 以下列表记录了不同命令所产生的不同通知: DEL 命令为每个被删除的键产生一个 del 通知. RENAME 产生两个通知:为来源键(source key)产生一个 rename_from 通知,并为目 标键(destination key)产生一个 rename_to 通知. EXPIRE 和 EXPIREAT 在键被正确设置过期时间时产生一个 expire 通知.当EXPIREAT 设置的时间已经过期,或者 EXPIRE 传入的时间为负数值时,键被删除,并 产生一个 del 通知. SORT 在命令带有 STORE 参数时产生一个 sortstore 事件.如果 STORE 指示的用于保 存排序结果的键已经存在,那么程序还会发送一个 del 事件. SET 以及它的所有变种(SETEX 、 SETNX 和 GETSET)都产生 set 通知.其中 SETEX 还会产生 expire 通知. MSET 为每个键产生一个 set 通知. SETRANGE 产生一个 setrange 通知. INCR 、 DECR 、 INCRBY 和 DECRBY 都产生 incrby 通知. INCRBYFLOAT 产生 incrbyfloat 通知. APPEND 产生 append 通知. LPUSH 和 LPUSHX 都产生单个 lpush 通知,即使有多个输入元素时,也是如此. RPUSH 和 RPUSHX 都产生单个 rpush 通知,即使有多个输入元素时,也是如此. RPOP 产生 rpop 通知.如果被弹出的元素是列表的最后一个元素,那么还会产生一个 del 通知. LPOP 产生 lpop 通知.如果被弹出的元素是列表的最后一个元素,那么还会产生一个 del 通知. LINSERT 产生一个 linsert 通知. LSET 产生一个 lset 通知. LTRIM 产生一个 ltrim 通知.如果 LTRIM 执行之后,列表键被清空,那么还会产生一 个 del 通知. RPOPLPUSH 和 BRPOPLPUSH 产生一个 rpop 通知,以及一个 lpush 通知.两个命 令都会保证 rpop 的通知在 lpush 的通知之前分发.如果从键弹出元素之后,被弹出 的列表键被清空,那么还会产生一个 del 通知. HSET 、 HSETNX 和 HMSET 都只产生一个 hset 通知. HINCRBY 产生一个 hincrby 通知. HINCRBYFLOAT 产生一个 hincrbyfloat 通知. HDEL 产生一个 hdel 通知.如果执行 HDEL 之后,哈希键被清空,那么还会产生一个 Redis 中文文档