Redis鍵空間通知（keyspace notification）

本文檔翻譯自：?http://redis.io/topics/notifications?。

鍵空間通知功能目前仍在開發(fā)中，這個(gè)文檔所描述的內(nèi)容，以及功能的具體實(shí)現(xiàn)，可能會(huì)在未來數(shù)周內(nèi)改變，敬請(qǐng)知悉。

功能概覽

鍵空間通知使得客戶端可以通過訂閱頻道或模式， 來接收那些以某種方式改動(dòng)了 Redis 數(shù)據(jù)集的事件。

以下是一些鍵空間通知發(fā)送的事件的例子：

• 所有修改鍵的命令。
• 所有接收到?LPUSH?命令的鍵。
• 0?號(hào)數(shù)據(jù)庫中所有已過期的鍵。

事件通過 Redis 的訂閱與發(fā)布功能（pub/sub）來進(jìn)行分發(fā)， 因此所有支持訂閱與發(fā)布功能的客戶端都可以在無須做任何修改的情況下， 直接使用鍵空間通知功能。

因?yàn)?Redis 目前的訂閱與發(fā)布功能采取的是發(fā)送即忘（fire and forget）策略， 所以如果你的程序需要可靠事件通知（reliable notification of events）， 那么目前的鍵空間通知可能并不適合你： 當(dāng)訂閱事件的客戶端斷線時(shí)， 它會(huì)丟失所有在斷線期間分發(fā)給它的事件。

未來將會(huì)支持更可靠的事件分發(fā)， 這種支持可能會(huì)通過讓訂閱與發(fā)布功能本身變得更可靠來實(shí)現(xiàn)， 也可能會(huì)在 Lua 腳本中對(duì)消息（message）的訂閱與發(fā)布進(jìn)行監(jiān)聽， 從而實(shí)現(xiàn)類似將事件推入到列表這樣的操作。

事件的類型

對(duì)于每個(gè)修改數(shù)據(jù)庫的操作，鍵空間通知都會(huì)發(fā)送兩種不同類型的事件。

比如說，對(duì)?0?號(hào)數(shù)據(jù)庫的鍵?mykey?執(zhí)行?DEL?命令時(shí)， 系統(tǒng)將分發(fā)兩條消息， 相當(dāng)于執(zhí)行以下兩個(gè)?PUBLISH?命令：

PUBLISH __keyspace@0__:mykey del PUBLISH __keyevent@0__:del mykey

訂閱第一個(gè)頻道?__keyspace@0__:mykey?可以接收?0?號(hào)數(shù)據(jù)庫中所有修改鍵?mykey?的事件， 而訂閱第二個(gè)頻道?__keyevent@0__:del?則可以接收?0?號(hào)數(shù)據(jù)庫中所有執(zhí)行?del?命令的鍵。

以?keyspace?為前綴的頻道被稱為鍵空間通知（key-space notification）， 而以?keyevent?為前綴的頻道則被稱為鍵事件通知（key-event notification）。

當(dāng)?del?mykey?命令執(zhí)行時(shí)：

• 鍵空間頻道的訂閱者將接收到被執(zhí)行的事件的名字，在這個(gè)例子中，就是?del?。
• 鍵事件頻道的訂閱者將接收到被執(zhí)行事件的鍵的名字，在這個(gè)例子中，就是?mykey?。

配置

因?yàn)殚_啟鍵空間通知功能需要消耗一些 CPU ， 所以在默認(rèn)配置下， 該功能處于關(guān)閉狀態(tài)。

可以通過修改?redis.conf?文件， 或者直接使用?CONFIG?SET?命令來開啟或關(guān)閉鍵空間通知功能：

• 當(dāng)?notify-keyspace-events?選項(xiàng)的參數(shù)為空字符串時(shí)，功能關(guān)閉。
• 另一方面，當(dāng)參數(shù)不是空字符串時(shí)，功能開啟。

notify-keyspace-events?的參數(shù)可以是以下字符的任意組合， 它指定了服務(wù)器該發(fā)送哪些類型的通知：

字符 發(fā)送的通知

K	鍵空間通知，所有通知以?__keyspace@<db>__?為前綴
E	鍵事件通知，所有通知以?__keyevent@<db>__?為前綴
g	DEL?、?EXPIRE?、?RENAME?等類型無關(guān)的通用命令的通知
$	字符串命令的通知
l	列表命令的通知
s	集合命令的通知
h	哈希命令的通知
z	有序集合命令的通知
x	過期事件：每當(dāng)有過期鍵被刪除時(shí)發(fā)送
e	驅(qū)逐(evict)事件：每當(dāng)有鍵因?yàn)?maxmemory?政策而被刪除時(shí)發(fā)送
A	參數(shù)?g$lshzxe?的別名

輸入的參數(shù)中至少要有一個(gè)?K?或者?E?， 否則的話， 不管其余的參數(shù)是什么， 都不會(huì)有任何通知被分發(fā)。

舉個(gè)例子， 如果只想訂閱鍵空間中和列表相關(guān)的通知， 那么參數(shù)就應(yīng)該設(shè)為?Kl?， 諸如此類。

將參數(shù)設(shè)為字符串?"AKE"?表示發(fā)送所有類型的通知。

命令產(chǎn)生的通知

以下列表記錄了不同命令所產(chǎn)生的不同通知：

• DEL?命令為每個(gè)被刪除的鍵產(chǎn)生一個(gè)?del?通知。
• RENAME?產(chǎn)生兩個(gè)通知：為來源鍵（source key）產(chǎn)生一個(gè)?rename_from?通知，并為目標(biāo)鍵（destination key）產(chǎn)生一個(gè)?rename_to?通知。
• EXPIRE?和?EXPIREAT?在鍵被正確設(shè)置過期時(shí)間時(shí)產(chǎn)生一個(gè)?expire?通知。當(dāng)?EXPIREAT?設(shè)置的時(shí)間已經(jīng)過期，或者?EXPIRE?傳入的時(shí)間為負(fù)數(shù)值時(shí)，鍵被刪除，并產(chǎn)生一個(gè)?del?通知。
• SORT?在命令帶有?STORE?參數(shù)時(shí)產(chǎn)生一個(gè)?sortstore?事件。如果?STORE?指示的用于保存排序結(jié)果的鍵已經(jīng)存在，那么程序還會(huì)發(fā)送一個(gè)?del?事件。
• SET?以及它的所有變種（SETEX?、?SETNX?和?GETSET）都產(chǎn)生?set?通知。其中?SETEX?還會(huì)產(chǎn)生?expire?通知。
• MSET?為每個(gè)鍵產(chǎn)生一個(gè)?set?通知。
• SETRANGE?產(chǎn)生一個(gè)?setrange?通知。
• INCR?、?DECR?、?INCRBY?和?DECRBY?都產(chǎn)生?incrby?通知。
• INCRBYFLOAT?產(chǎn)生?incrbyfloat?通知。
• APPEND?產(chǎn)生?append?通知。
• LPUSH?和?LPUSHX?都產(chǎn)生單個(gè)?lpush?通知，即使有多個(gè)輸入元素時(shí)，也是如此。
• RPUSH?和?RPUSHX?都產(chǎn)生單個(gè)?rpush?通知，即使有多個(gè)輸入元素時(shí)，也是如此。
• RPOP?產(chǎn)生?rpop?通知。如果被彈出的元素是列表的最后一個(gè)元素，那么還會(huì)產(chǎn)生一個(gè)?del?通知。
• LPOP?產(chǎn)生?lpop?通知。如果被彈出的元素是列表的最后一個(gè)元素，那么還會(huì)產(chǎn)生一個(gè)?del?通知。
• LINSERT?產(chǎn)生一個(gè)?linsert?通知。
• LSET?產(chǎn)生一個(gè)?lset?通知。
• LTRIM?產(chǎn)生一個(gè)?ltrim?通知。如果?LTRIM?執(zhí)行之后，列表鍵被清空，那么還會(huì)產(chǎn)生一個(gè)?del?通知。
• RPOPLPUSH?和?BRPOPLPUSH?產(chǎn)生一個(gè)?rpop?通知，以及一個(gè)?lpush?通知。兩個(gè)命令都會(huì)保證?rpop?的通知在?lpush?的通知之前分發(fā)。如果從鍵彈出元素之后，被彈出的列表鍵被清空，那么還會(huì)產(chǎn)生一個(gè)?del?通知。
• HSET?、?HSETNX?和?HMSET?都只產(chǎn)生一個(gè)?hset?通知。
• HINCRBY?產(chǎn)生一個(gè)?hincrby?通知。
• HINCRBYFLOAT?產(chǎn)生一個(gè)?hincrbyfloat?通知。
• HDEL?產(chǎn)生一個(gè)?hdel?通知。如果執(zhí)行?HDEL?之后，哈希鍵被清空，那么還會(huì)產(chǎn)生一個(gè)?del?通知。
• SADD?產(chǎn)生一個(gè)?sadd?通知，即使有多個(gè)輸入元素時(shí)，也是如此。
• SREM?產(chǎn)生一個(gè)?srem?通知，如果執(zhí)行?SREM?之后，集合鍵被清空，那么還會(huì)產(chǎn)生一個(gè)?del?通知。
• SMOVE?為來源鍵（source key）產(chǎn)生一個(gè)?srem?通知，并為目標(biāo)鍵（destination key）產(chǎn)生一個(gè)?sadd?事件。
• SPOP?產(chǎn)生一個(gè)?spop?事件。如果執(zhí)行?SPOP?之后，集合鍵被清空，那么還會(huì)產(chǎn)生一個(gè)?del?通知。
• SINTERSTORE?、?SUNIONSTORE?和?SDIFFSTORE?分別產(chǎn)生?sinterstore?、?sunionostore?和?sdiffstore?三種通知。如果用于保存結(jié)果的鍵已經(jīng)存在，那么還會(huì)產(chǎn)生一個(gè)?del?通知。
• ZINCRBY?產(chǎn)生一個(gè)?zincr?通知。（譯注：非對(duì)稱，請(qǐng)注意。）
• ZADD?產(chǎn)生一個(gè)?zadd?通知，即使有多個(gè)輸入元素時(shí)，也是如此。
• ZREM?產(chǎn)生一個(gè)?zrem?通知，即使有多個(gè)輸入元素時(shí)，也是如此。如果執(zhí)行?ZREM?之后，有序集合鍵被清空，那么還會(huì)產(chǎn)生一個(gè)?del?通知。
• ZREMRANGEBYSCORE?產(chǎn)生一個(gè)?zrembyscore?通知。（譯注：非對(duì)稱，請(qǐng)注意。）如果用于保存結(jié)果的鍵已經(jīng)存在，那么還會(huì)產(chǎn)生一個(gè)?del?通知。
• ZREMRANGEBYRANK?產(chǎn)生一個(gè)?zrembyrank?通知。（譯注：非對(duì)稱，請(qǐng)注意。）如果用于保存結(jié)果的鍵已經(jīng)存在，那么還會(huì)產(chǎn)生一個(gè)?del?通知。
• ZINTERSTORE?和?ZUNIONSTORE?分別產(chǎn)生?zinterstore?和?zunionstore?兩種通知。如果用于保存結(jié)果的鍵已經(jīng)存在，那么還會(huì)產(chǎn)生一個(gè)?del?通知。
• 每當(dāng)一個(gè)鍵因?yàn)檫^期而被刪除時(shí)，產(chǎn)生一個(gè)?expired?通知。
• 每當(dāng)一個(gè)鍵因?yàn)?maxmemory?政策而被刪除以回收內(nèi)存時(shí)，產(chǎn)生一個(gè)?evicted?通知。

所有命令都只在鍵真的被改動(dòng)了之后，才會(huì)產(chǎn)生通知。

比如說，當(dāng)?SREM?試圖刪除不存在于集合的元素時(shí)，刪除操作會(huì)執(zhí)行失敗，因?yàn)闆]有真正的改動(dòng)鍵，所以這一操作不會(huì)發(fā)送通知。

如果對(duì)命令所產(chǎn)生的通知有疑問， 最好還是使用以下命令， 自己來驗(yàn)證一下：

$ redis-cli config set notify-keyspace-events KEA $ redis-cli --csv psubscribe '__key*__:*' Reading messages... (press Ctrl-C to quit) "psubscribe","__key*__:*",1

然后， 只要在其他終端里用 Redis 客戶端發(fā)送命令， 就可以看到產(chǎn)生的通知了：

"pmessage","__key*__:*","__keyspace@0__:foo","set" "pmessage","__key*__:*","__keyevent@0__:set","foo" ...

過期通知的發(fā)送時(shí)間

Redis 使用以下兩種方式刪除過期的鍵：

• 當(dāng)一個(gè)鍵被訪問時(shí)，程序會(huì)對(duì)這個(gè)鍵進(jìn)行檢查，如果鍵已經(jīng)過期，那么該鍵將被刪除。
• 底層系統(tǒng)會(huì)在后臺(tái)漸進(jìn)地查找并刪除那些過期的鍵，從而處理那些已經(jīng)過期、但是不會(huì)被訪問到的鍵。

當(dāng)過期鍵被以上兩個(gè)程序的任意一個(gè)發(fā)現(xiàn)、 并且將鍵從數(shù)據(jù)庫中刪除時(shí)， Redis 會(huì)產(chǎn)生一個(gè)?expired?通知。

Redis 并不保證生存時(shí)間（TTL）變?yōu)?0?的鍵會(huì)立即被刪除： 如果程序沒有訪問這個(gè)過期鍵， 或者帶有生存時(shí)間的鍵非常多的話， 那么在鍵的生存時(shí)間變?yōu)?0?， 直到鍵真正被刪除這中間， 可能會(huì)有一段比較顯著的時(shí)間間隔。

因此， Redis 產(chǎn)生?expired?通知的時(shí)間為過期鍵被刪除的時(shí)候， 而不是鍵的生存時(shí)間變?yōu)?0?的時(shí)候。

from:?http://redisdoc.com/topic/notification.html

總結(jié)

以上是生活随笔為你收集整理的键空间通知（keyspace notification）的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。