簡介： redis腳本使用lua解釋器來執行腳本， 常用命令： 1.eval 2.evalsha 3.script_load 4.script_exists 5.script_flush 6.script_kill 命令詳解： 1.eval 可用版本： >=2.6.0 時間復雜度： 尋找要被執行腳本的復雜度為O(1) 命令格式： eval script numkeys key [key ...] arg [arg ...] 命令介紹： redis2.6.0版本之后，通過內置的lua內置器，可以使用eval命令對lua腳本進行求值， script引數是一段lua5.1腳本程式，它會運行在redis服務器背景關系中，這腳本不必（也不應該）定位為一個lua函式， number引數用來指定鍵名引數的個數， 鍵名引數key [key ...]從eval的第三個引數開始，表示在腳本中用到的redis-key，這些引數可以在lua腳本中通過全域變數keys陣列獲取，用以1開始的下標訪問keys[1]、keys[2]， 在命令的最后，那些不是鍵名引數的附加引數arg [arg ...]，可以在Lua中通過全域變數ARGV陣列訪問，訪問形式與KEYS變數類似，
> eval "return {KEYS[1],KEYS[2],ARGV[1],ARGV[2]}" 2 key1 key2 first second 1) "key1" 2) "key2" 3) "first" 4) "second"
Lua腳本中執行redis： 在Lua腳本中，可以使用兩個不同的函式來執行redis命令（redis.call()/redis.pcall()）， 這兩個函式唯一的不同在于對于錯誤資訊的處理，
> eval "return redis.call('set',KEYS[1],'bar')" 1 foo OK
資料轉換： 當 Lua 通過 call() 或 pcall() 函式執行 Redis 命令的時候，命令的回傳值會被轉換成 Lua 資料結構，同樣地，當 Lua 腳本在 Redis 內置的解釋器里運行時，Lua 腳本的回傳值也會被轉換成 Redis 協議(protocol)，然后由 EVAL 將值回傳給客戶端， 資料型別之間的轉換遵循這樣一個設計原則：如果將一個 Redis 值轉換成 Lua 值，之后再將轉換所得的 Lua 值轉換回 Redis 值，那么這個轉換所得的 Redis 值應該和最初時的 Redis 值一樣， 換句話說， Lua 型別和 Redis 型別之間存在著一一對應的轉換關系， 腳本原子性： Redis 使用單個 Lua 解釋器去運行所有腳本，并且， Redis 也保證腳本會以原子性(atomic)的方式執行：當某個腳本正在運行的時候，不會有其他腳本或 Redis 命令被執行，這和使用 MULTI / EXEC 包圍的事務很類似，在其他別的客戶端看來，腳本的效果(effect)要么是不可見的(not visible)，要么就是已完成的(already completed)， 另一方面，這也意味著，執行一個運行緩慢的腳本并不是一個好主意，寫一個跑得很快很順溜的腳本并不難，因為腳本的運行開銷(overhead)非常少，但是當你不得不使用一些跑得比較慢的腳本時，請小心，因為當這些蝸牛腳本在慢吞吞地運行的時候，其他客戶端會因為服務器正忙而無法執行命令， 錯誤處理： 當 redis.call() 在執行命令的程序中發生錯誤時，腳本會停止執行，并回傳一個腳本錯誤，錯誤的輸出資訊會說明錯誤造成的原因：
redis> lpush foo a (integer) 1 redis> eval "return redis.call('get', 'foo')" 0 (error) ERR Error running script (call to f_282297a0228f48cd3fc6a55de6316f31422f5d17): ERR Operation against a key holding the wrong kind of value
redis.pcall() 出錯時并不引發(raise)錯誤，而是回傳一個帶 err 域的 Lua 表(table)，用于表示錯誤：
redis 127.0.0.1:6379> EVAL "return redis.pcall('get', 'foo')" 0 (error) ERR Operation against a key holding the wrong kind of value
帶寬與evalsha： EVAL 命令要求你在每次執行腳本的時候都發送一次腳本主體(script body)，Redis 有一個內部的快取機制，因此它不會每次都重新編譯腳本，不過在很多場合，付出無謂的帶寬來傳送腳本主體并不是最佳選擇， 為了減少帶寬的消耗， Redis 實作了 EVALSHA 命令，它的作用和 EVAL 一樣，都用于對腳本求值，但它接受的第一個引數不是腳本，而是腳本的 SHA1 校驗和(sum)， EVALSHA 命令的表現如下： 如果服務器還記得給定的 SHA1 校驗和所指定的腳本，那么執行這個腳本 如果服務器不記得給定的 SHA1 校驗和所指定的腳本，那么它回傳一個特殊的錯誤，提醒用戶使用 EVAL 代替 EVALSHA
> set foo bar OK > eval "return redis.call('get','foo')" 0 "bar" > evalsha 6b1bf486c81ceb7edf3c093f4c48582e38c0e791 0 "bar" > evalsha ffffffffffffffffffffffffffffffffffffffff 0 (error) `NOSCRIPT` No matching script. Please use [EVAL](/commands/eval).
腳本快取： Redis 保證所有被運行過的腳本都會被永久保存在腳本快取當中，這意味著，當 EVAL 命令在一個 Redis 實體上成功執行某個腳本之后，隨后針對這個腳本的所有 EVALSHA 命令都會成功執行， 重繪腳本快取的唯一辦法是顯式地呼叫 SCRIPT FLUSH 命令，這個命令會清空運行過的所有腳本的快取，通常只有在云計算環境中，Redis 實體被改作其他客戶或者別的應用程式的實體時，才會執行這個命令， 快取可以長時間儲存而不產生記憶體問題的原因是，它們的體積非常小，而且數量也非常少，即使腳本在概念上類似于實作一個新命令，即使在一個大規模的程式里有成百上千的腳本，即使這些腳本會經常修改，即便如此，儲存這些腳本的記憶體仍然是微不足道的， 事實上，用戶會發現 Redis 不移除快取中的腳本實際上是一個好主意，比如說，對于一個和 Redis 保持持久化鏈接(persistent connection)的程式來說，它可以確信，執行過一次的腳本會一直保留在記憶體當中，因此它可以在流水線中使用 EVALSHA 命令而不必擔心因為找不到所需的腳本而產生錯誤(稍候我們會看到在流水線中執行腳本的相關問題)， script命令： Redis 提供了以下幾個 SCRIPT 命令，用于對腳本子系統(scripting subsystem)進行控制： 1）script flush：清除所有腳本快取 2）script exists sha1 [sha1 ...]：根據給定的腳本校驗和，檢測指定的腳本是否存在與腳本快取中 3）script load script：將一個腳本寫入腳本快取，但是不運行它 4）script kill：殺死當前正在運行的腳本 redis日志： 在Lua腳本中，可以通過使用redis.log函式來寫redis的日志：
redis.log(loglevel, message)
其中，message引數是一個字串，而loglevel引數可以是： 1）redis.LOG_DEBUG 2）redis.LOG_VERBOSE 3）redis.LOG_NOTICE 4）redis.LOG_WARNING 沙箱與最大執行時間： 腳本應該僅僅用于傳遞引數和對 Redis 資料進行處理，它不應該嘗試去訪問外部系統(比如檔案系統)，或者執行任何系統呼叫， 除此之外，腳本還有一個最大執行時間限制，它的默認值是 5 秒鐘，一般正常運作的腳本通常可以在幾分之幾毫秒之內完成，花不了那么多時間，這個限制主要是為了防止因編程錯誤而造成的無限回圈而設定的， 最大執行時間的長短由 lua-time-limit 選項來控制(以毫秒為單位)，可以通過編輯 redis.conf 檔案或者使用 CONFIG GET parameter 和 CONFIG SET parameter value 命令來修改它， 當一個腳本達到最大執行時間的時候，它并不會自動被 Redis 結束，因為 Redis 必須保證腳本執行的原子性，而中途停止腳本的運行意味著可能會留下未處理完的資料在資料集(data set)里面， 因此，當腳本運行的時間超過最大執行時間后，以下動作會被執行： 1）Redis 記錄一個腳本正在超時運行 2）Redis 開始重新接受其他客戶端的命令請求，但是只有 SCRIPT KILL 和 SHUTDOWN NOSAVE 兩個命令會被處理，對于其他命令請求， Redis 服務器只是簡單地回傳 BUSY 錯誤， 3）可以使用 SCRIPT KILL 命令將一個僅執行只讀命令的腳本殺死，因為只讀命令并不修改資料，因此殺死這個腳本并不破壞資料的完整性 4）如果腳本已經執行過寫命令，那么唯一允許執行的操作就是 SHUTDOWN NOSAVE ，它通過停止服務器來阻止當前資料集寫入磁盤 2.evalsha 可用版本： >=2.6.0 時間復雜度： 根據腳本的復雜度而定 命令格式： evalsha sha1 numkeys key [key ...] arg [arg ...] 作用： 根據給定的sha1校驗碼，對快取在服務器中的腳本進行求值， 引數傳入方式與eval一致， 回傳值： 腳本執行的回傳值， 3.script_load 可用版本： >=2.6.0 時間復雜度： O(N) , N 為腳本的長度(以位元組為單位) 命令格式： script load script 作用： 將腳本script添加到腳本快取中，但并不執行這個腳本， eval 命令也會將腳本添加到腳本快取中，但是會立刻執行這個腳本， 如果給定的腳本已經在快取里面了，那么不做動作， 回傳值： 給script的SHA1校驗和， 4.script_exists 可用版本： >=2.6.0 時間復雜度： O(N) , N 為給定的 SHA1 校驗和的數量 命令格式： script exists sha1 [sha1 ...] 作用： 給定一個或者多個腳本的SHA1校驗和，回傳一個包含0/1串列，表示校驗和所指定的腳本是否已經被保存在快取當中， 回傳值： 一個串列，包含 0 和 1 ，前者表示腳本不存在于快取，后者表示腳本已經在快取里面了， 串列中的元素和給定的 SHA1 校驗和保持對應關系，比如串列的第三個元素的值就表示第三個 SHA1 校驗和所指定的腳本在快取中的狀態， 5.script_flush 可用版本： >=2.6.0 時間復雜度： O(N) ， N 為快取中腳本的數量 命令格式： script flush 作用： 清除所有Lua腳本快取， 回傳值： 總是回傳OK， 6.script_kill 可用版本： >=2.6.0 時間復雜度： O(1) 命令格式： script kill 作用： 殺死當前正在運行的 Lua 腳本，當且僅當這個腳本沒有執行過任何寫操作時，這個命令才生效， 這個命令主要用于終止運行時間過長的腳本，比如一個因為 BUG 而發生無限 loop 的腳本，諸如此類， 回傳值： 執行成功回傳 OK ，否則回傳一個錯誤，
轉載請註明出處，本文鏈接：https://www.uj5u.com/shujuku/255555.html
標籤：其他