Redis使用lua腳本


版本:自2.6.0起可用。
時間復雜度:取決於執行的腳本。

使用Lua腳本的好處:

  • 減少網絡開銷。可以將多個請求通過腳本的形式一次發送,減少網絡時延。
  • 原子操作。redis會將整個腳本作為一個整體執行,中間不會被其他命令插入。因此在編寫腳本的過程中無需擔心會出現競態條件,無需使用事務。
  • 復用。客戶端發送的腳本會永久存在redis中,這樣,其他客戶端可以復用這一腳本而不需要使用代碼完成相同的邏輯。

如何使用

基本使用

命令格式:

EVAL script numkeys key [key ...] arg [arg ...]

說明:

  • script是第一個參數,為Lua 5.1腳本。該腳本不需要定義Lua函數(也不應該)。
  • 第二個參數numkeys指定后續參數有幾個key。
  • key [key ...],是要操作的鍵,可以指定多個,在lua腳本中通過KEYS[1], KEYS[2]獲取
  • arg [arg ...],參數,在lua腳本中通過ARGV[1], ARGV[2]獲取。

簡單實例:

127.0.0.1:6379> eval "return ARGV[1]" 0 100 
"100"
127.0.0.1:6379> eval "return {ARGV[1],ARGV[2]}" 0 100 101
1) "100"
2) "101"
127.0.0.1:6379> eval "return {KEYS[1],KEYS[2],ARGV[1],ARGV[2]}" 2 key1 key2 first second
1) "key1"
2) "key2"
3) "first"
4) "second"

127.0.0.1:6379> eval "redis.call('SET', KEYS[1], ARGV[1]);redis.call('EXPIRE', KEYS[1], ARGV[2]); return 1;" 1 test 10 60
(integer) 1
127.0.0.1:6379> ttl test
(integer) 59
127.0.0.1:6379> get test
"10"

注:

  • {}在lua里是指數據類型table,類似數組。
  • redis.call()可以調用redis命令。

命令行里使用

如果直接使用redis-cli命令,格式會有點不一樣:

redis-cli --eval lua_file key1 key2 , arg1 arg2 arg3

注意的地方:

  • eval 后面參數是lua腳本文件,.lua后綴
  • 不用寫numkeys,而是使用,隔開。注意,前后有空格。

示例:

incrbymul.lua

local num = redis.call('GET', KEYS[1]);  

if not num then
	return 0;
else
	local res = num * ARGV[1]; 
	redis.call('SET',KEYS[1], res); 
	return res;
end

命令行運行:

$ redis-cli --eval incrbymul.lua lua:incrbymul , 8
(integer) 0
$ redis-cli incr lua:incrbymul 
(integer) 1
$ redis-cli --eval incrbymul.lua lua:incrbymul , 8
(integer) 8
$ redis-cli --eval incrbymul.lua lua:incrbymul , 8
(integer) 64
$ redis-cli --eval incrbymul.lua lua:incrbymul , 2
(integer) 128

由於redis沒有提供命令可以實現將一個數原子性的乘以N倍,這里我們就用Lua腳本實現了,運行過程中確保不會被其它客戶端打斷。

phpredis里使用

接着上面的例子:

incrbymul.php

<?php 

$lua = <<<EOF
local num = redis.call('GET', KEYS[1]);  

if not num then
	return 0;
else
	local res = num * ARGV[1]; 
	redis.call('SET',KEYS[1], res); 
	return res;
end

EOF;

$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$ret = $redis->eval($lua, array("lua:incrbymul", 2), 1);
echo $ret;

運行:

$ redis-cli set lua:incrbymul 0
OK
$ redis-cli incr lua:incrbymul
(integer) 1
$ php incrbymul.php 
2
$ php incrbymul.php 
4

eval原型:

Redis::eval(string script, [array keys, long num_keys])

eval函數的第3個參數為KEYS個數,phpredis依據此值將KEYS和ARGV做區分。

參考

1、在redis中使用lua腳本讓你的靈活性提高5個逼格 - 一線碼農 - 博客園
https://www.cnblogs.com/huangxincheng/p/6230129.html
2、Redis執行Lua腳本示例 - yanghuahui - 博客園
https://www.cnblogs.com/yanghuahui/p/3697996.html
3、EVAL - Redis
https://redis.io/commands/eval
4、phpredis 執行LUA腳本的例子 - jingtan的專欄 - CSDN博客
https://blog.csdn.net/jingtan/article/details/53392309
5、lua-book
http://me.52fhy.com/lua-book/


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM