redis脚本使用lua解释器来执行脚本,redis2.6版本通过内嵌支持lua环境,执行脚本的常用命令为eval
eval命令
语法:eval script numkeys key [key ...] arg [ arg ...]
实例:
script:参数是一段脚本程序,脚本不必(也不应该)定义为一个Lua函数。
numberkeys:用于指定键名参数的个数。
key【key...】 :从eval的第三个参数开始算起,表示在脚本中所用的到那些redis键(key),这些键名参数可以在Lua中通过全局变量keys数组,用1位基址的形式访问(keys[1],keys[2])
arg [arg ...]: 附加参数,在 Lua 中通过全局变量 ARGV 数组访问,访问的形式和 KEYS 变量类似( ARGV[1] 、 ARGV[2] ,诸如此类)。
1 127.0.0.1:6379> eval "return {KEYS[1],KEYS[2],KEYS[3],ARGV[1],ARGV[2],ARGV[3]}" 3 shi zhang yang 23 21 20 2 1) "shi" 3 2) "zhang" 4 3) "yang" 5 4) "23" 6 5) "21" 7 6) "20"
evalsha命令
evalsha命令根据给定的sha1校验码,执行缓存在服务器中的脚本。
将脚本缓存到服务器的操作可以通过SCRIPT LOAD命令进行。
这个命令的其他地方,不如参数的传入方式,都喝EVAL命令一样。
evalsha命令基本语法: evalsha sha1 numkeys key [key...] arg[arg ...]
sha1:通过SCRIPT LOAD 生成的sha1校验码。
key [key ...]: 从 EVAL 的第三个参数开始算起,表示在脚本中所用到的那些 Redis 键(key),这些键名参数可以在 Lua 中通过全局变量 KEYS 数组,用 1 为基址的形式访问( KEYS[1] , KEYS[2] ,以此类推)。
arg [arg ...]: 附加参数,在 Lua 中通过全局变量 ARGV 数组访问,访问的形式和 KEYS 变量类似( ARGV[1] 、 ARGV[2] ,诸如此类)。
实例:
1 127.0.0.1:6379> script load "return 'hello moto'" 2 "232fd51614574cf0867b83d384a5e898cfd24e5a" 3 127.0.0.1:6379> evalsha "232fd51614574cf0867b83d384a5e898cfd24e5a" 0 4 "hello moto"
Script Exists 命令
Script Exists命令用于校验指定的脚本是否已经被保存在缓存当中。
基本语法: evalsha sha1 numkeys key[key...] arg [arg...]
返回值:一个列表,包含0和1,前者表示脚本不存在于缓存,后者表示脚本已经在缓存里面了。
列表中的元素和给定的SHA1校验和保持对应关系,比如列表的第三个元素的值就表示第三个SHA1校验和指定脚本在缓存中的状态。
实例:
1 127.0.0.1:6379> script load "return 'hello moto'" #SHA1校验码 2 "232fd51614574cf0867b83d384a5e898cfd24e5a" 3 127.0.0.1:6379> script exists 232fd51614574cf0867b83d384a5e898cfd24e5a #查看校验码是否存在 4 1) (integer) 1 #1表示存在 5 127.0.0.1:6379> script flush#清空缓存 6 OK 7 127.0.0.1:6379> script exists 8 232fd51614574cf0867b83d384a5e898cfd24e5a#再次查看缓存,0表示不存在 9 1) (integer) 0
Script Flush 命令
该命令用于清楚所有LUA脚本缓存。
基本语法: Script Flush
返回值:总是返回OK
实例:
1 127.0.0.1:6379> script load "return 'hello moto'" 2 "232fd51614574cf0867b83d384a5e898cfd24e5a" 3 127.0.0.1:6379> script exists 232fd51614574cf0867b83d384a5e898cfd24e5a 4 1) (integer) 1 5 127.0.0.1:6379> script flush###清楚脚本缓存 6 OK 7 127.0.0.1:6379> script exists 232fd51614574cf0867b83d384a5e898cfd24e5a 8 1) (integer) 0
Script kill命令
Script kill命令用于杀死当前正在运行的Lua脚本,当且仅当这个脚本没有执行过任何操作时,这个命令才生效。
这个命令主要用于终止运行时间过长的脚本,比如一个bug而发生无限循环的脚本。
script kill执行之后,当前正在运行的脚本会被杀死,执行这个脚本的客户端会从eval命令的阻塞当中退出,并收到一个错误作为返回值。
基本命令:script kill
返回值:script kill
实例:
1 redis 127.0.0.1:6379> SCRIPT KILL 2 OK
Script load script命令
该命令用于将脚本script添加到脚本缓存中,但并不执行这个脚本。
eval命令也会将脚本添加到脚本缓存中,但是它会里脊对输入的脚本进行求值。
如果给定的脚本已经在缓存里面了,那么不执行任何操作。
在脚本被加入到缓存之后,通过evalsha命令,可以使用脚本的sha1校验和来调用这个脚本。
脚本可以在缓存中保留无限长的时间,知道执行script flush为止。
基本语法:script load script
返回值:给定脚本的SHA1校验和。
实例:
1 127.0.0.1:6379> script load "return 1" 2 "e0e1f9fabfc9d4800c877a703b823ac0578ff8db"