Redis Eval Script

梦里梦外; 2021-06-24 16:11 407阅读 0赞

### [https://www.cnblogs.com/bibi-feiniaoyuan/p/9448621.html][https_www.cnblogs.com_bibi-feiniaoyuan_p_9448621.html] ###

### 简介 ###

从Redis 2.6 版本开始，内嵌支持 Lua 环境。通过使用EVAL或EVALSHA命令可以使用 Lua 解释器来执行脚本。 EVAL和EVALSHA的使用是差不多的（下面有讲区别）。

### EVAL命令 ###

语法： EVAL script numkeys key \[key ...\] arg \[arg ...\] 。

script：Lua脚本 。numkeys：key的参数个数。访问脚本获取key值：`KEYS[1]`, `KEYS[2]`, ... （KEYS必须大写），获取arg值：`ARGV[1]`, `ARGV[2]`, ...（ARGV必须大写）。

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 </td> 
 <td> <code>127.0.0.1:6379&gt;&nbsp;</code><code>eval</code>&nbsp;<code>"return {KEYS[1],ARGV[1],ARGV[2]}"</code>&nbsp;<code>1 1 ONE TWO</code> <code>1)&nbsp;</code><code>"1"</code> <code>2)&nbsp;</code><code>"ONE"</code> <code>3)&nbsp;</code><code>"TWO"</code> </td> 
 </tr> 
 </tbody> 
</table>

在Lua脚本中可以通过使用redis.call()或redis.pcall()函数调用redis命令。

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 </td> 
 <td> <code>127.0.0.1:6379&gt;&nbsp;</code><code>set</code>&nbsp;<code>foo bar</code> <code>OK</code> <code>127.0.0.1:6379&gt;&nbsp;</code><code>eval</code>&nbsp;<code>"return redis.call('set','foo','bibi')"</code>&nbsp;<code>0</code> <code>OK</code> <code>127.0.0.1:6379&gt; get foo</code> <code>"bibi"</code> <code>127.0.0.1:6379&gt;&nbsp;</code><code>eval</code>&nbsp;<code>"return redis.call('set',KEYS[1],'bar')"</code>&nbsp;<code>1 foo&lt;br&gt;OK</code> </td> 
 </tr> 
 </tbody> 
</table>

至于redis.call()，redis.pcall()的不同，在于错误提示不一样

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 </td> 
 <td> <code>127.0.0.1:6379&gt;&nbsp;&nbsp;</code><code>eval</code>&nbsp;<code>"return redis.call('setset','yyyy','oo')"</code>&nbsp;<code>0</code> <code>(error) ERR Error running script (call to f_9b37f897c55c73737f181184c9781281dc9b45e3): @user_script:1: @user_script: 1: Unknown Redis&nbsp;</code><code>command</code>&nbsp;<code>called from Lua script</code> <code>127.0.0.1:6379&gt;&nbsp;&nbsp;</code><code>eval</code>&nbsp;<code>"return redis.pcall('setset','yyyy','oo')"</code>&nbsp;<code>0</code> <code>(error) @user_script: 1: Unknown Redis&nbsp;</code><code>command</code>&nbsp;<code>called from Lua script</code> <code>127.0.0.1:6379&gt;</code> </td> 
 </tr> 
 </tbody> 
</table>

Redis与Lua数据类型的转换

在Lua脚本通过redis.call()或redis.pcall()执行redis命令，发生数据类型转换：redis命令返回值--------------->lua数据类型。

Lua脚本在Redis内嵌的解释器运行，发生数据类型珠海：lua数据类型-------------->redis命令返回值。

Lua数据类型转Redis类型

*  Lua number  -> Redis integer reply (the number is converted into an integer)   
    127.0.0.1:6379> eval "return 9" 0  
    (integer) 9
 *  Lua string -> Redis bulk reply  bulk类型支持多种数据类型批量返回  
    127.0.0.1:6379> eval "return 'hengheng'" 0  
    "hengheng"
 *  Lua table (array) -> Redis multi bulk reply (truncated to the first nil inside the Lua array if any)  
    127.0.0.1:6379> eval "return\{'3','rr',4\}" 0  
    1) "3"  
    2) "rr"  
    3) (integer) 4
 *  Lua table with a single `ok` field -> Redis status reply ，status类型就是很随意的状态  
    127.0.0.1:6379> eval "return \{ok='oppp'\}" 0  
    oppp
 *  Lua table with a single `err` field -> Redis error reply  ，error类型，前面带有括号(error)注明是error类型，区分status类型  
    127.0.0.1:6379>  eval "return \{err='eeeeeeeeeeee'\}" 0  
    (error) eeeeeeeeeeee  
    127.0.0.1:6379> eval "return \{ok='ooooooooooooooo'\}" 0  
    ooooooooooooooo
 *  Lua boolean false -> Redis Nil bulk reply.  
    127.0.0.1:6379> eval "return false" 0      
    (nil)

Redis数据类型转lua数据类型：

*  Redis integer reply -> Lua number
 *  Redis bulk reply -> Lua string
 *  Redis multi bulk reply -> Lua table (may have other Redis data types nested)
 *  Redis status reply -> Lua table with a single `ok` field containing the status
 *  Redis error reply -> Lua table with a single `err` field containing the error
 *  Redis Nil bulk reply and Nil multi bulk reply -> Lua false boolean type

Redis数据类型和lua数据类型并不完全对应：

Lua的编号如果非整数，应作为字符串返回，因为总是转为Redis整数类型

127.0.0.1:6379> eval "return 90.4231" 0  
(integer) 90  
在Lua数组中使用nils，会停止转换直到数组的最后。

127.0.0.1:6379> eval "return \{2332,'rrr','fff',nil,'gg'\}"  0  
1) (integer) 2332  
2) "rrr"  
3) "fff"

### 运行Lua脚本的原子性 ###

Redis使用Lua解释器解释Lua脚本过程中，会保证脚本是以原子性的方式执行，也就是脚本的效果要么仍然不可见，要么已经完成。既然是原子性，那当脚本还没运行完时，其他客户端是无法执行命令的。

所以，该脚本就别搞那么复杂吧，当然，看清况，该复杂也没辙。

### EVAL和EVALSHA区别 ###

Eval执行的脚本不从缓存里拿，而Evalsha执行的脚本从缓存拿，跟sha1校验码从服务器缓存里拿。（sha1就好像身份证）

命令：EVALSHA sha1 numkeys key \[key ...\] arg \[arg ...\]

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 8 9 10 11 12 </td> 
 <td> <code>127.0.0.1:6379&gt; script load&nbsp;</code><code>"return 5"</code>&nbsp;&nbsp;&nbsp;&nbsp;<code>#往缓存里加入脚本 ， 返回sha1校验码</code> <code>"4ca238f611c9d0ae4e9a75a5dbac22aedc379801"</code> <code>127.0.0.1:6379&gt; script exists 4ca238f611c9d0ae4e9a75a5dbac22aedc379801&nbsp;</code><code>#是否存在某脚本&nbsp;</code> <code>1) (integer) 1</code> <code>127.0.0.1:6379&gt; evalsha 4ca238f611c9d0ae4e9a75a5dbac22aedc379801 0&nbsp;</code><code>#执行脚本</code> <code>(integer) 5</code> <code>127.0.0.1:6379&gt; script flush</code> <code>OK</code> <code>127.0.0.1:6379&gt; script exists 4ca238f611c9d0ae4e9a75a5dbac22aedc379801</code> <code>1) (integer) 0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>#0表示不存在了</code> <code>127.0.0.1:6379&gt;&nbsp; evalsha 4ca238f611c9d0ae4e9a75a5dbac22aedc379801 0</code> <code>(error) NOSCRIPT No matching script. Please use EVAL.&nbsp;&nbsp;</code><code>#异常了</code> </td> 
 </tr> 
 </tbody> 
</table>

[https_www.cnblogs.com_bibi-feiniaoyuan_p_9448621.html]: https://www.cnblogs.com/bibi-feiniaoyuan/p/9448621.html