短小精悍 —— Redis 命令行工具的妙用

咱們每天都在使用 Redis 內置的命令行工具 redis-cli，長此以往覺得它就是一個簡單的交互式 Redis 數據結構手工操做程序，可是它背後強大的功能絕大多數同窗可能聞所未聞。本節咱們一塊兒來挖掘這些不爲人知的有趣用法。

執行單條命令

平時在訪問 Redis 服務器，通常都會使用 redis-cli 進入交互模式，而後一問一答來讀寫服務器，這種狀況下咱們使用的是它的「交互模式」。還有另一種「直接模式」，經過將命令參數直接傳遞給 redis-cli 來執行指令並獲取輸出結果。

$ redis-cli incrby foo 5
(integer) 5
$ redis-cli incrby foo 5
(integer) 10
複製代碼

若是輸出的內容較大，還能夠將輸出重定向到外部文件

$ redis-cli info > info.txt
$ wc -l info.txt
     120 info.txt
複製代碼

上面的命令指向的服務器是默認服務器地址，若是想指向特定的服務器能夠這樣

// -n 2 表示使用第2個庫，至關於 select 2
$ redis-cli -h localhost -p 6379 -n 2 ping
PONG
複製代碼

批量執行命令

在平時線上的開發過程當中，有時候咱們免不了要手工造數據，而後導入 Redis。一般咱們會編寫腳本程序來作這件事。不過還有另一種比較便捷的方式，那就是直接使用 redis-cli 來批量執行一系列指令。

$ cat cmds.txt
set foo1 bar1
set foo2 bar2
set foo3 bar3
......
$ cat cmds.txt | redis-cli
OK
OK
OK
...
複製代碼

上面的指令使用了 Unix 管道將 cat 指令的標準輸出鏈接到 redis-cli 的標準輸入。其實還能夠直接使用輸入重定向來批量執行指令。

$ redis-cli < cmds.txt
OK
OK
OK
...
複製代碼

set 多行字符串

若是一個字符串有多行，你但願將它傳入 set 指令，redis-cli 要如何作？可使用 -x 選項，該選項會使用標準輸入的內容做爲最後一個參數。

$ cat str.txt
Ernest Hemingway once wrote,
"The world is a fine place and worth fighting for."
I agree with the second part.
$ redis-cli -x set foo < str.txt
OK
$ redis-cli get foo
"Ernest Hemingway once wrote,\n\"The world is a fine place and worth fighting for.\"\nI agree with the second part.\n"
複製代碼

重複執行指令

redis-cli 還支持重複執行指令屢次，每條指令執行之間設置一個間隔時間，如此即可以觀察某條指令的輸出內容隨時間變化。

// 間隔1s，執行5次，觀察qps的變化
$ redis-cli -r 5 -i 1 info | grep ops
instantaneous_ops_per_sec:43469
instantaneous_ops_per_sec:47460
instantaneous_ops_per_sec:47699
instantaneous_ops_per_sec:46434
instantaneous_ops_per_sec:47216
複製代碼

若是將次數設置爲 -1 那就是重複無數次永遠執行下去。若是不提供 -i 參數，那就沒有間隔，連續重複執行。在交互模式下也能夠重複執行指令，形式上比較怪異，在指令前面增長次數

127.0.0.1:6379> 5 ping
PONG
PONG
PONG
PONG
PONG
# 下面的指令很可怕，你的屏幕要憤怒了
127.0.0.1:6379> 10000 info
.......
複製代碼

導出 csv

redis-cli 不能一次導出整個庫的內容爲 csv，可是能夠導出單條指令的輸出爲 csv 格式。

$ redis-cli rpush lfoo a b c d e f g
(integer) 7
$ redis-cli --csv lrange lfoo 0 -1
"a","b","c","d","e","f","g"
$ redis-cli hmset hfoo a 1 b 2 c 3 d 4
OK
$ redis-cli --csv hgetall hfoo
"a","1","b","2","c","3","d","4"
複製代碼

固然這種導出功能比較弱，僅僅是一堆字符串用逗號分割開來。不過你能夠結合命令的批量執行來看看多個指令的導出效果。

$ redis-cli --csv -r 5 hgetall hfoo
"a","1","b","2","c","3","d","4"
"a","1","b","2","c","3","d","4"
"a","1","b","2","c","3","d","4"
"a","1","b","2","c","3","d","4"
"a","1","b","2","c","3","d","4"
複製代碼

看到這裏讀者應該明白 --csv 參數的效果就是對輸出作了一次轉換，用逗號分割，僅此而已。

執行 lua 腳本

在 lua 腳本小節，咱們使用 eval 指令來執行腳本字符串，每次都是將腳本內容壓縮成單行字符串再調用 eval 指令，這很是繁瑣，並且可讀性不好。redis-cli 考慮到了這點，它能夠直接執行腳本文件。

127.0.0.1:6379> eval "return redis.pcall('mset', KEYS[1], ARGV[1], KEYS[2], ARGV[2])" 2 foo1 foo2 bar1 bar2
OK
127.0.0.1:6379> eval "return redis.pcall('mget', KEYS[1], KEYS[2])" 2 foo1 foo2
1) "bar1"
2) "bar2"
複製代碼

下面咱們以腳本的形式來執行上面的指令，參數形式有所不一樣，KEY 和 ARGV 之間須要使用逗號分割，而且不須要提供 KEY 的數量參數

$ cat mset.txt
return redis.pcall('mset', KEYS[1], ARGV[1], KEYS[2], ARGV[2])
$ cat mget.txt
return redis.pcall('mget', KEYS[1], KEYS[2])
$ redis-cli --eval mset.txt foo1 foo2 , bar1 bar2
OK
$ redis-cli --eval mget.txt foo1 foo2
1) "bar1"
2) "bar2"
複製代碼

若是你的 lua 腳本太長，--eval 將大有用處。

監控服務器狀態

咱們可使用 --stat 參數來實時監控服務器的狀態，間隔 1s 實時輸出一次。

$ redis-cli --stat
------- data ------ --------------------- load -------------------- - child -
keys       mem      clients blocked requests            connections
2          6.66M    100     0       11591628 (+0)       335
2          6.66M    100     0       11653169 (+61541)   335
2          6.66M    100     0       11706550 (+53381)   335
2          6.54M    100     0       11758831 (+52281)   335
2          6.66M    100     0       11803132 (+44301)   335
2          6.66M    100     0       11854183 (+51051)   335
複製代碼

若是你以爲間隔太長或是過短，可使用 -i 參數調整輸出間隔。

掃描大 KEY

這個功能太實用了，我已經在線上試過無數次了。每次遇到 Redis 偶然卡頓問題，第一個想到的就是實例中是否存在大 KEY，大 KEY的內存擴容以及釋放都會致使主線程卡頓。若是知道里面有沒有大 KEY，能夠本身寫程序掃描，不過這太繁瑣了。redis-cli 提供了 --bigkeys 參數能夠很快掃出內存裏的大 KEY，使用 -i 參數控制掃描間隔，避免掃描指令致使服務器的 ops 陡增報警。

$ ./redis-cli --bigkeys -i 0.01
# Scanning the entire keyspace to find biggest keys as well as
# average sizes per key type.  You can use -i 0.1 to sleep 0.1 sec
# per 100 SCAN commands (not usually needed).

[00.00%] Biggest zset   found so far 'hist:aht:main:async_finish:20180425:17' with 1440 members
[00.00%] Biggest zset   found so far 'hist:qps:async:authorize:20170311:27' with 2465 members
[00.00%] Biggest hash   found so far 'job:counters:6ya9ypu6ckcl' with 3 fields
[00.01%] Biggest string found so far 'rt:aht:main:device_online:68:{-4}' with 4 bytes
[00.01%] Biggest zset   found so far 'machine:load:20180709' with 2879 members
[00.02%] Biggest string found so far '6y6fze8kj7cy:{-7}' with 90 bytes

複製代碼

redis-cli 對於每一種對象類型都會記錄長度最大的 KEY，對於每一種對象類型，刷新一次最高記錄就會當即輸出一次。它能保證輸出長度爲 Top1 的 KEY，可是 Top二、Top3等 KEY 是沒法保證能夠掃描出來的。通常的處理方法是多掃描幾回，或者是消滅了 Top1 的 KEY 以後再掃描確認還有沒有次大的 KEY。

採樣服務器指令

如今線上有一臺 Redis 服務器的 OPS 過高，有不少業務模塊都在使用這個 Redis，如何才能判斷出來是哪一個業務致使了 OPS 異常的高。這時能夠對線上服務器的指令進行採樣，觀察採樣的指令大體就能夠分析出 OPS 佔比高的業務點。這時就要使用 monitor 指令，它會將服務器瞬間執行的指令所有顯示出來。不過使用的時候要注意即便使用 ctrl+c 中斷，不然你的顯示器會噼裏啪啦太多的指令瞬間讓你眼花繚亂。

$ redis-cli --host 192.168.x.x --port 6379 monitor
1539853410.458483 [0 10.100.90.62:34365] "GET" "6yax3eb6etq8:{-7}"
1539853410.459212 [0 10.100.90.61:56659] "PFADD" "growth:dau:20181018" "2klxkimass8w"
1539853410.462938 [0 10.100.90.62:20681] "GET" "6yax3eb6etq8:{-7}"
1539853410.467231 [0 10.100.90.61:40277] "PFADD" "growth:dau:20181018" "2kei0to86ps1"
1539853410.470319 [0 10.100.90.62:34365] "GET" "6yax3eb6etq8:{-7}"
1539853410.473927 [0 10.100.90.61:58128] "GET" "6yax3eb6etq8:{-7}"
1539853410.475712 [0 10.100.90.61:40277] "PFADD" "growth:dau:20181018" "2km8sqhlefpc"
1539853410.477053 [0 10.100.90.62:61292] "GET" "6yax3eb6etq8:{-7}"
複製代碼

診斷服務器時延

平時咱們診斷兩臺機器的時延通常是使用 Unix 的 ping 指令。Redis 也提供了時延診斷指令，不過它的原理不太同樣，它是診斷當前機器和 Redis 服務器之間的指令(PING指令)時延，它不只僅是物理網絡的時延，還和當前的 Redis 主線程是否忙碌有關。若是你發現 Unix 的 ping 指令時延很小，而 Redis 的時延很大，那說明 Redis 服務器在執行指令時有微弱卡頓。

$ redis-cli --host 192.168.x.x --port 6379 --latency
min: 0, max: 5, avg: 0.08 (305 samples)
複製代碼

時延單位是 ms。redis-cli 還能顯示時延的分佈狀況，並且是圖形化輸出。

$ redis-cli --latency-dist
複製代碼

這個圖形的含義做者沒有描述，讀者們能夠嘗試破解一下。

遠程 rdb 備份

執行下面的命令就能夠將遠程的 Redis 實例備份到本地機器，遠程服務器會執行一次bgsave操做，而後將 rdb 文件傳輸到客戶端。遠程 rdb 備份讓咱們有一種「秀才不出門，全知天下事」的感受。

$ ./redis-cli --host 192.168.x.x --port 6379 --rdb ./user.rdb
SYNC sent to master, writing 2501265095 bytes to './user.rdb'
Transfer finished with success.
複製代碼

模擬從庫

若是你想觀察主從服務器之間都同步了那些數據，可使用 redis-cli 模擬從庫。

$ ./redis-cli --host 192.168.x.x --port 6379 --slave
SYNC with master, discarding 51778306 bytes of bulk transfer...
SYNC done. Logging commands from master.
...
複製代碼

從庫連上主庫的第一件事是全量同步，因此看到上面的指令卡頓這很正常，待首次全量同步完成後，就會輸出增量的 aof 日誌。

閱讀更多深度技術文章，掃一掃上面的二維碼關注微信公衆號「碼洞」