批次刪除 Redis 特定 Key

將 Redis 當做 Cache Server 是滿普遍的做法，修改 Cache 內容格式也是常見的，不過程式部署時連帶清空 redis 可能就不是預設 sop 了

最近專案就遇到類似問題：

雖然這個需求不是常態性存在，執行頻率也不高，但我每次遇到也不免要回憶幾分鐘才組得出正確的指令，重點是每次執行指令都擔心下錯，所以趁著空檔紀錄一下

基本環境說明

適用於單一 Redis database or 單一 Redis instance 只服務某個 module (key 全刪不會影響到其他 module)

使用 FLUSHDB [ASYNC]

僅刪除當前的 redis database 所有 key; ASYNC 是 Redis 4 之後版本才加上的

語法

redis-cli [-a {password}] [-h {redis ip}] [-p {redis port}] [-n {db}] FLUSHDB

範例

redis-cli -a pass.123 -h 127.0.0.1 -p 6379 -n 2 FLUSHDB

使用 FLUSHALL [ASYNC]

僅刪除所有 redis database 所有 key; ASYNC 是 Redis 4 之後版本才加上的

語法

redis-cli [-a {password}] [-h {redis ip}] [-p {redis port}] FLUSHDB

範例

redis-cli -a pass.123 -h 127.0.0.1 -p 6379 FLUSHDB

適用 Redis key 有特定 pattern 且不想刪除 Redis 所有 key 的情境 (全刪的時間複雜度是 O(N) - N 是 key 數量)

列出需要刪除的 key

沒有覆寫 scan 指令

語法

redis-cli [-a {password}] [-h {redis ip}] [-p {redis port}] [-n {db}] --scan --pattern {key pattern}

範例

redis-cli -a pass.123 -h 127.0.0.1 -p 6379 -n 0 --scan --pattern yowko:*

執行刪除動作

Redis 4 之前版本：使用 del

語法

redis-cli [-a {password}] [-h {redis ip}] [-p {redis port}] [-n {db}] del [KEYS]

範例

redis-cli -a pass.123 -h 127.0.0.1 -p 6379 -n 0 del yowko:a yowko:b

Redis 4 之後版本：使用 unlink (可以背景刪除)

語法

redis-cli [-a {password}] [-h {redis ip}] [-p {redis port}] [-n {db}] unlink [KEYS]

範例

redis-cli -a pass.123 -h 127.0.0.1 -p 6379 -n 0 unlink yowko:a yowko:b

整合範例

這個就依據上面的語法，搭配適當的環境設定來組裝指令，我先寫好來方便自己抄XD

redis-cli -a pass.123 -h 127.0.0.1 -p 6379 yowko_keys "yowko:*" | xargs redis-cli -a pass.123 -h 127.0.0.1 -p 6379 unlink

大致上都是熟悉的語法，但是踩到 rename-command scan 在 redis-cli 中就無法使用 scan 指令有些錯愕，明明 keys 能用呀，不過我沒有特別花時間去探討原因先記下來備忘，要用時有地方參考就好