Redis Eval Script

简介

从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必须大写）。

127.0.0.1:6379> eval "return {KEYS[1],ARGV[1],ARGV[2]}" 1 1 ONE TWO
1) "1"
2) "ONE"
3) "TWO"

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

127.0.0.1:6379> set foo bar
OK
127.0.0.1:6379> eval "return redis.call('set','foo','bibi')" 0
OK
127.0.0.1:6379> get foo
"bibi"
127.0.0.1:6379> eval "return redis.call('set',KEYS[1],'bar')" 1 foo
OK

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

127.0.0.1:6379>  eval "return redis.call('setset','yyyy','oo')" 0
(error) ERR Error running script (call to f_9b37f897c55c73737f181184c9781281dc9b45e3): @user_script:1: @user_script: 1: Unknown Redis command called from Lua script
127.0.0.1:6379>  eval "return redis.pcall('setset','yyyy','oo')" 0
(error) @user_script: 1: Unknown Redis command called from Lua script
127.0.0.1:6379>

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 ...]

127.0.0.1:6379> script load "return 5"    #往缓存里加入脚本 ， 返回sha1校验码 
"4ca238f611c9d0ae4e9a75a5dbac22aedc379801"
127.0.0.1:6379> script exists 4ca238f611c9d0ae4e9a75a5dbac22aedc379801 #是否存在某脚本  
1) (integer) 1
127.0.0.1:6379> evalsha 4ca238f611c9d0ae4e9a75a5dbac22aedc379801 0 #执行脚本
(integer) 5
127.0.0.1:6379> script flush
OK
127.0.0.1:6379> script exists 4ca238f611c9d0ae4e9a75a5dbac22aedc379801 
1) (integer) 0     #0表示不存在了
127.0.0.1:6379>  evalsha 4ca238f611c9d0ae4e9a75a5dbac22aedc379801 0
(error) NOSCRIPT No matching script. Please use EVAL.  #异常了

先写到这，待深入。