【Redis】Lua脚本(Eval 命令) 您所在的位置:网站首页 lua脚本代码如何传递参数 【Redis】Lua脚本(Eval 命令)

【Redis】Lua脚本(Eval 命令)

2023-07-26 07:29| 来源: 网络整理| 查看: 265

文章目录 1. 作用2. 什么是eval命令3. 实例4. 注意事项

1. 作用

用脚本的好处如下: 1、减少网络开销:本来5次网络请求的操作,可以用一个请求完成,原先5次请求的逻辑放在redis服务器上完成。使用脚本,减少了网络往返时延。这点跟管道类似。 2、原子操作:Redis会将整个脚本作为一个整体执行,中间不会被其他命令插入。管道不是原子的,不过redis的批量操作命令(类似mset)是原子的。 3、替代redis的事务功能:redis自带的事务功能很鸡肋,报错不支持回滚,而redis的lua脚本几乎实现了常规的事务功能,支持报错回滚操作,官方推荐如果要使用redis的事务功能可以用redis lua替代。 4、复用:客户端发送的脚本会永久存储在Redis中,意味着其他客户端可以复用这一脚本而不需要使用代码完成同样的逻辑。

2. 什么是eval命令

Redis Eval 命令使用 Lua 解释器执行脚本。

语法: redis Eval 命令基本语法如下:

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

参数说明:

script: 参数是一段 Lua 5.1 脚本程序。脚本不必(也不应该)定义为一个 Lua 函数。numkeys: 用于指定键名参数的个数。

作用是区分key 数组和arg数组,例如2 a b c ,假设numkeys是2,说明前2个参数 a 和b是key,第三个参数c是arg;1 a b c ,假设numkeys是1,说明前1个参数 a 是key,第2个参数起都是arg

key [key …]: 从 EVAL 的第三个参数开始算起,表示在脚本中所用到的那些 Redis 键(key),这些键名参数可以在 Lua 中通过全局变量 KEYS 数组,用 1 为基址的形式访问( KEYS[1] , KEYS[2] ,以此类推)。arg [arg …]: 附加参数,在 Lua 中通过全局变量 ARGV 数组访问,访问的形式和 KEYS 变量类似( ARGV[1] 、 ARGV[2] ,诸如此类)。

可用版本 >= 2.6.0

3. 实例 redis 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"

其中 “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.call()函数来执行Redis命令,Jedis调用示例详见下面jedis连接示例:

package com.test.jedis; import redis.clients.jedis.Jedis; import redis.clients.jedis.JedisPool; import redis.clients.jedis.JedisPoolConfig; import java.io.IOException; import java.util.Arrays; /** * 访问redis单机 */ public class JedisSingleTest2 { public static void main(String[] args) throws IOException { JedisPoolConfig jedisPoolConfig = new JedisPoolConfig(); jedisPoolConfig.setMaxTotal(20); jedisPoolConfig.setMaxIdle(10); jedisPoolConfig.setMinIdle(5); // timeout,这里既是连接超时又是读写超时,从Jedis 2.8开始有区分connectionTimeout和soTimeout的构造函数 JedisPool jedisPool = new JedisPool(jedisPoolConfig, "10.40.65.183", 6379, 3000, null); Jedis jedis = null; try { //从redis连接池里拿出一个连接执行命令 jedis = jedisPool.getResource(); //模拟一个商品减库存的原子操作 //lua脚本命令执行方式:redis-cli --eval /tmp/test.lua , 10 jedis.set("product_stock_10016", "15"); //初始化商品10016的库存 String script = " local count = redis.call('get', KEYS[1]) " + " local a = tonumber(count) " + " local b = tonumber(ARGV[1]) " + " if a >= b then " + " redis.call('set', KEYS[1], a-b) " + //模拟语法报错回滚操作 // " bb == 0 " + " return 1 " + " end " + " return 0 "; Object obj = jedis.eval(script, Arrays.asList("product_stock_10016"), Arrays.asList("10")); System.out.println(obj); System.out.println("执行成功:此时product_stock_10016="+jedis.get("product_stock_10016")); } catch (Exception e) { System.out.println("执行出错:此时product_stock_10016= "+jedis.get("product_stock_10016")); e.printStackTrace(); } finally { //注意这里不是关闭连接,在JedisPool模式下,Jedis会被归还给资源池。 if (jedis != null) jedis.close(); } } }

执行结果,:

1 '执行脚本的结果是ok的' 执行成功:此时product_stock_10016=5 '查询脚本执行后的内存中的值,15-10=5'

下面来验证出错时会回滚,放开下面的代码:

" bb == 0 " +

执行结果:

执行出错:此时product_stock_10016= 15

由于出错了,因此a-b操作被回滚了,结果不是5,而是初始值15.

4. 注意事项

由于Lua脚本执行是原子的,如果其中的某个命令很慢,会导致redis访问被阻塞。因此使用时要格外小心,避免有耗时操作。



【本文地址】

公司简介

联系我们

今日新闻

    推荐新闻

    专题文章
      CopyRight 2018-2019 实验室设备网 版权所有