EVAL script numkeys key [key ...] arg [arg ...]
从 Redis 2.6.0 版本开始,通过内置的 Lua 解释器,可以使用 命令对 Lua 脚本进行求值。
script 参数是一段 Lua 5.1 脚本程序,它会被运行在 Redis 服务器上下文中,这段脚本不必(也不应该)定义为一个 Lua 函数。
numkeys 参数用于指定键名参数的个数。
键名参数 key [key ...] 从 的第三个参数开始算起,表示在脚本中所用到的那些 Redis 键(key),这些键名参数可以在 Lua 中通过全局变量 KEYS 数组,用 1 为基址的形式访问( KEYS[1] , KEYS[2] ,以此类推)。
在命令的最后,那些不是键名参数的附加参数 arg [arg ...] ,可以在 Lua 中通过全局变量 ARGV 数组访问,访问的形式和 KEYS 变量类似( ARGV[1] 、 ARGV[2] ,诸如此类)。
其中 "return {KEYS[1],KEYS[2],ARGV[1],ARGV[2]}" 是被求值的 Lua 脚本,数字 2 指定了键名参数的数量, key1 和 key2 是键名参数,分别使用 KEYS[1] 和 KEYS[2] 访问,而最后的 first 和 second 则是附加参数,可以通过 ARGV[1] 和 ARGV[2] 访问它们。
在 Lua 脚本中,可以使用两个不同函数来执行 Redis 命令,它们分别是:
- redis.call()
- redis.pcall()
前面的命令介绍部分说过, redis.call() 和 redis.pcall() 的唯一区别在于它们对错误处理的不同。
在队列中加一条信息
127.0.0.1:6379> LPUSH u:1 yesu1(integer) 3127.0.0.1:6379> EVAL "return redis.call('lpush','u:1','yesu1')" 0(integer) 1127.0.0.1:6379> EVAL "return redis.call('lpop','u:1')" 0"yesu1"
错误调用显示如下
127.0.0.1:6379> eval "return redis.call('get1', 'u:1')" 0(error) ERR Error running script (call to f_e6e51ec36fb12be0ef1c5c2354bdbdcea5366d73): @user_script:1: @user_script: 1: Unknown Redis command called from Lua script 127.0.0.1:6379> eval "return redis.pcall('get1', 'u:1')" 0(error) @user_script: 1: Unknown Redis command called from Lua script
新建一个测试 redis.lua 脚本
--redis.call("incr", KEYS[1])local redisText= redis.call("lpop", KEYS[1])return redisText
redis命令行下调用脚本
[root@localhost ~]# redis-cli --eval /root/git/redis.lua "u:1""yesu1"
EVALSHA
EVALSHA sha1 numkeys key [key ...] arg [arg ...]
根据给定的 sha1 校验码,对缓存在服务器中的脚本进行求值。
将脚本缓存到服务器的操作可以通过 命令进行。
这个命令的其他地方,比如参数的传入方式,都和 命令一样。
redis> SCRIPT LOAD "return 'hello'""232fd51614574cf0867b83d384a5e898cfd24e5a"redis> EVALSHA "232fd51614574cf0867b83d384a5e898cfd24e5a" 0"hello"
脚本的原子性
Redis 使用单个 Lua 解释器去运行所有脚本,并且, Redis 也保证脚本会以原子性(atomic)的方式执行:当某个脚本正在运行的时候,不会有其他脚本或 Redis 命令被执行。这和使用 / 包围的事务很类似。在其他别的客户端看来,脚本的效果(effect)要么是不可见的(not visible),要么就是已完成的(already completed)。
另一方面,这也意味着,执行一个运行缓慢的脚本并不是一个好主意。写一个跑得很快很顺溜的脚本并不难,因为脚本的运行开销(overhead)非常少,但是当你不得不使用一些跑得比较慢的脚本时,请小心,因为当这些蜗牛脚本在慢吞吞地运行的时候,其他客户端会因为服务器正忙而无法执行命令。
Redis 提供了以下几个 SCRIPT 命令,用于对脚本子系统(scripting subsystem)进行控制:
- :清除所有脚本缓存
- :根据给定的脚本校验和,检查指定的脚本是否存在于脚本缓存
- :将一个脚本装入脚本缓存,但并不立即运行它
- :杀死当前正在运行的脚本