您好,登錄后才能下訂單哦!
小編給大家分享一下redis怎么執行lua腳本,相信大部分人都還不怎么了解,因此分享這篇文章給大家參考一下,希望大家閱讀完這篇文章后大有收獲,下面讓我們一起去了解一下吧!
從redis 2.6.0版本開始,redis內置了Lua解釋器,并提供了eval命令來解析Lua腳本求值。
語法: eval script numkeys keys args
參數: eval — redis提供解析lua腳本的命令
script — lua腳本
numkeys — 指定鍵名參數集(keys)的個數
keys — 鍵名參數集,通過全局變量KEYS數組表示,起始下標為1
args — 鍵值參數集,通過全局變量ARGV數組表示,起始下標為1
描述: EVAL命令的語義要求字面量不要直接寫在lua腳本中,推薦使用變量來定義lua腳本,并將字面量放在鍵名參數集keys和鍵值參數集args中,通過全局變量KEYS和ARGV來獲取,這樣做的好處是可緩存!在lua腳本中,可以使用兩個函數來執行redis命令,分別是:redis.call()和redis.pcall()
例子:
## 第一個eval命令,設置一個key=name,value=sym的字符串 eval "return redis.call('set',KEYS[1],ARGA[1])" 1 name sym ## 第二個eval命令:獲取key=name的字符串的值 eval "return redis.call('get',KEYS[1])" 1 name
錯誤處理:
上面說過,在lua腳本中可以使用call()和pcall()來執行redis腳本,這兩個函數的效果是一模一樣的,唯一區別就是它們對于錯誤處理的不同:
①redis.call()在執行命令中發生錯誤,腳本會停止執行,返回一個腳本錯誤,錯誤的輸出信息會說明錯誤造成的原因:
②redis.pcall()執行命令出錯時將捕獲錯誤并返回表示錯誤的Lua表類型
當 Lua 通過 call() 或 pcall() 函數執行 Redis 命令的時候,命令的返回值會被轉換成 Lua 數據結構;同樣地,當Lua腳本在 redis內置解釋器里運行時,Lua的返回值也會被轉換成Redis類型,然后由EVAL將值返回客戶端。lua類型與redis類型之間存在一一轉換的關系:
redis -> lua
redis類型 | lua類型 | 描述 |
redis_integer | lua_number | redis整數轉為lua數字 |
redis_bulk | lua_string | redis bulk回復轉為lua字符串 |
redis_multi bulk | Lua_table | redis 多條bulk回復轉為Lua 表 |
redis_status | lua_table | redis狀態回復轉為lua表,表內ok域包含狀態信息 |
redis_error | lua_table | redis錯誤回復轉為lua表,表內的err域包含錯誤信息 |
redis_nil、 redis_multi nil | lua_boolean_false | redis的nil回復和nil多條回復轉為lua的布爾值false |
lua -> redis
lua類型 | redis類型 | 描述 |
lua_number | redis_integer | lua數字轉為redis整數 |
lua_string | redis_bluk | lua字符串轉為redis bulk回復 |
lua_table、 lua_array | redis_multi bulk | lua表(數組)轉為redis多條bulk回復 |
lua_table_ok | redis status | 一個帶單個ok域的lua表,轉為redis 狀態回復 |
lua_table_err | redis_error | 一個帶單個err域的lua表,轉為redis 錯誤回復 |
lua_boolean_false | redis nil | lua布爾值false轉為redis的nil回復 |
從lua轉換到redis有一條額外的規則,這條規則沒有與其相對應的redis轉換為lua的規則:
lua_boolean_true -> redis_integer_1,lua布爾值true轉為redis整數1
redis提供了以下幾個script命令,用于對于腳本子系統進行控制:
script flush:清除所有的腳本緩存
script load:將腳本裝入腳本緩存,不立即運行并返回其校驗和
script exists:根據指定腳本校驗和,檢查腳本是否存在于緩存
script kill:殺死當前正在運行的腳本(防止腳本運行緩存,占用內存)
redis使用單個lua解釋器去運行所有腳本,并且保證腳本會以原子性的方式去執行,意味著當某個腳本在運行時,不會有其它腳本或者redis命令被執行!所以,如果當前腳本運行很慢,服務器可能會因為正忙而無法執行命令,如:
每個腳本都有一個最大執行時間限制,默認值是5s。最大執行時間的長短由配置文件redis.conf的lua-time-limit選項來控制,或直接使用config get和config set命令來修改。當一個腳本執行達到最大執行時間,redis不會主動結束它,它會進行下面幾個步驟:
①redis記錄一個腳本正在超時運行
②redis開始重新接受其它客戶端請求,但只接受執行script kill命令和shutdown nosave兩個命令,若客戶端執行其它命令,redis會返回busy錯誤。
③如果腳本只執行過讀操作,使用script kill命令可以立即停止此腳本;如果腳本執行過寫操作,只允許shutdown save/nosave命令,通過停止服務器來阻止當前數據寫入磁盤。(此時服務器關閉,數據不會被保存)
redis有一個內部的腳本緩存機制,它不會每次都重新編譯腳本,反倒是它會將所有運行過的腳本永久保存在腳本緩存中(因為redis發現腳本體積非常小,即使量很大,甚至經常修改,儲存這些腳本的內存也是微不足道的)。清空腳本緩存只有唯一一個方式,就是執行script flush命令。使用eval命令執行腳本時,每次都要發送腳本主體,如果腳本足夠復雜,這會付出無謂的網絡帶寬。redis基于對lua的緩存,它實現了evalsha命令。
evalsha命令和eval命令效果一樣,都是解釋lua腳本執行,但是evalsha命令的第一個參數不是腳本主體,而是腳本的SHAI校驗和,這個校驗和可以通過script load命令得到。evalsha命令執行過程分兩步:
①如果redis服務器保存了給定SHA1校驗和所指定的腳本,就會執行該腳本
②如果redis服務器沒保存給定SHA1校驗和所指定的腳本,它就會返回一個特殊錯誤,告知客戶端使用eval命令去執行
如下圖所示:
redis的lua腳本不允許創建全局變量,如果腳本需要在多次執行之間維持某種狀態,可以借助外部redis key來保存狀態,每次腳本執行前,獲取redis相對應的key賦值給局部變量。在lua腳本中創建或訪問一個全局變量,都會引起腳本停止,eval命令會返回一個錯誤:
redis的全局變量保護并不是百分百成功,有時候會在腳本中混入lua全局狀態,可能會引發AOF持久化和主從復制都無法得到保證。redis建議不要在腳本中使用全局變量,可以使用local關鍵字定義腳本中的變量!
在redis中使用腳本不會自動記錄日志,需要我們在腳本使用redis.log()手動保存日志信息。腳本保存的日志,只有那些與redis實例所設置的日志等級相同或更高級才會被記錄。語法:redis.log(loglevel,message)。其中,message表示要記錄的日志信息,是一個字符串;loglevel表示redis日志等級,有4個取值:
redis.LOG_DEBUG
redis.LOG_VERBOSE
redis.LOG_NOTICE
redis.LOG_WARNING
以上是“redis怎么執行lua腳本”這篇文章的所有內容,感謝各位的閱讀!相信大家都有了一定的了解,希望分享的內容對大家有所幫助,如果還想學習更多知識,歡迎關注億速云行業資訊頻道!
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。