首页
所有分类
TAGS
文字工具 EMOJI BIBLE
数据库 Redis

redis中lua脚本使用教程

Posted in Redis onNovember 01, 2021

一、背景

在使用redis的过程中，发现有些时候需要原子性去操作redis命令，而redis的lua脚本正好可以实现这一功能。比如： 扣减库存操作、限流操作等等。
redis的pipelining虽然也可以一次执行一组命令，但是如果在这一组命令的执行过程中，需要根据上一步执行的结果做一些判断，则无法实现。

二、使用lua脚本

Redis中使用的是 Lua 5.1 的脚本规范，同时我们编写的脚本的时候，不需要定义 Lua 函数。同时也不能使用全局变量等等。

1、lua脚本的格式和注意事项

1、格式

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

127.0.0.1:6379> eval "return {KEYS[1],ARGV[1],ARGV[2]}" 1 key1 arg1 arg2
1) "key1"
2) "arg1"
3) "arg2"
127.0.0.1:6379>

redis中lua脚本使用教程

2、注意事项

Lua脚本中的redis操作的key最好都是通过 KEYS来传递，而不要写死。否则在Redis Cluster的情况下可能有问题.

redis中lua脚本使用教程

1、好的写法

127.0.0.1:6379> eval "return redis.call('set',KEYS[1],'zhangsan')" 1 username
OK
127.0.0.1:6379> get username
"zhangsan"

redis命令操作的key是通过KEYS获取的。

2、差的写法

127.0.0.1:6379> eval "return redis.call('set','username','zhangsan')" 0
OK
127.0.0.1:6379> get username
"zhangsan"

redis命令操作的key是直接写死的。

2、将脚本加载到redis中

需求： 此处定义一个lua脚本，将输入的参数的值+1返回。

注意：

当我们把 lua脚本加载到redis中，这个脚本并不会马上执行，而是会缓存起来，并且返回sha1校验和，后期我们可以通过 EVALSHA 来执行这个脚本。

此处我们记住这个脚本加载后返回的hash值，在下一步执行的时候需要用到。

127.0.0.1:6379> script load "return tonumber(KEYS[1])+1"
"ef424d378d47e7a8b725259cb717d90a4b12a0de"
127.0.0.1:6379>

3、执行lua脚本

1、通过eval执行

127.0.0.1:6379> eval "return tonumber(KEYS[1]) + 1" 1 100
(integer) 101
127.0.0.1:6379>

2、通过evalsha执行

ef424d378d47e7a8b725259cb717d90a4b12a0de的值为上一步通过 script load加载脚本后获取的。

127.0.0.1:6379> evalsha ef424d378d47e7a8b725259cb717d90a4b12a0de 1 100
(integer) 101
127.0.0.1:6379>

通过 evalsha 执行的好处是可以节省带宽。如果我们的lua脚本比较长，程序在执行的时候将lua脚本发送到redis服务器则可能耗费的带宽多，如果发送的是hash值的话，则耗费的带宽少。

4、判断脚本是否在redis服务器缓存中

127.0.0.1:6379> script load "return tonumber(KEYS[1])+1"
"ef424d378d47e7a8b725259cb717d90a4b12a0de"
127.0.0.1:6379> script exists ef424d378d47e7a8b725259cb717d90a4b12a0de
1) (integer) 1
127.0.0.1:6379> script exists not-exists-sha1
1) (integer) 0
127.0.0.1:6379>

5、清空服务器上的脚本缓存

注意：
我们无法清除某一个脚本的缓存，只可以清楚所有的缓存，一般情况下没有必要清楚，因为即使有大量的脚本也不会太占用服务器内存。

127.0.0.1:6379> script load "return tonumber(KEYS[1])+1"
"ef424d378d47e7a8b725259cb717d90a4b12a0de"
127.0.0.1:6379> script exists ef424d378d47e7a8b725259cb717d90a4b12a0de
1) (integer) 1
127.0.0.1:6379> script flush
OK
127.0.0.1:6379> script exists ef424d378d47e7a8b725259cb717d90a4b12a0de
1) (integer) 0

redis中lua脚本使用教程

6、杀死正在运行的脚本

127.0.0.1:6379> script kill

注意：

  • 该命令只可以杀死正在运行的 只读脚本。
  • 对于修改了数据的脚本，无法使用此命令杀死，只能使用 shutdown nosave命令。
  • 脚本执行的默认超时时间为 5分钟，可以通过redis.conf配置文件的lua-time-limit配置项修改。
  • 脚本即使到达了超时时间，也不会停止执行，因为这违反了lua脚本的原子性。

三、lua和redis数据类型转换

Lua的数据类型和Redis的数据类型存在一对一的转换关系，如果将Redis类型转换成Lua类型，然后在转换成Redis类型，那么结果和初试值是一致的。

1、类型转换

Redis to Luaconversion table.

  • 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

Lua to Redisconversion table.

  • Lua number -> Redis integer reply (the number is converted into an integer)
  • Lua string -> Redis bulk reply
  • Lua table (array) -> Redis multi bulk reply (truncated to the first nil inside the Lua array if any)
  • Lua table with a single ok field -> Redis status reply
  • Lua table with a single err field -> Redis error reply
  • Lua boolean false -> Redis Nil bulk reply.

2、额外的转换规则

  1. Lua的布尔类型，Lua的True会转换成Redis的1

3、3个重要规则

1. 数字类型

在Lua中，只有一个number类型，整数和浮点数之间没有区别，如果我们在Lua中返回一个浮点数，实际返回的是一个整数，如果要返回浮点数，需要以字符串的方式返回。

127.0.0.1:6379> eval "return 3.98" 0
(integer) 3
127.0.0.1:6379> eval "return '3.98'" 0
"3.98"

2. lua数组存在nil

当 Redis 将 Lua 数组转换为 Redis 协议时，如果遇到 nil，则转换会停止。即 nil 后的值都不会返回。

127.0.0.1:6379> eval "return {1,2,'data',nil,'can not return value','vv'}" 0
1) (integer) 1
2) (integer) 2
3) "data"
127.0.0.1:6379>

3. Lua的Table类型包含建和值

出现这种情况返回的redis的是一个空数组

127.0.0.1:6379> eval "return {key1 ='value1',key2='value2'}" 0
(empty array)
127.0.0.1:6379>

四、lua脚本中输出日志

这个一般调试我们的脚本的时候比较有用。

redis.log(loglevel,message)

loglevel的取值范围：

  • redis.LOG_DEBUG
  • redis.LOG_VERBOSE
  • redis.LOG_NOTICE
  • redis.LOG_WARNING

举例：

redis中lua脚本使用教程

五、一个简单限流的案例

1、需求

在 1s 之内，方法最大的并发只能是 5。

1s 和 5 当作参数传递。

2、实现步骤

1、编写lua脚本

-- 输出用户传递进来的参数
for i, v in pairs(KEYS) do
    redis.log(redis.LOG_NOTICE, "limit: key" .. i .. " = " .. v)
end
for i, v in pairs(ARGV) do
    redis.log(redis.LOG_NOTICE, "limit: argv" .. i .. " = " .. v)
end

-- 限流的key
local limitKey = tostring(KEYS[1])
-- 限流的次数
local limit = tonumber(ARGV[1])
-- 多长时间过期
local expireMs = tonumber(ARGV[2])

-- 当前已经执行的次数
local current = tonumber(redis.call('get', limitKey) or '0')

-- 设置一个断点
redis.breakpoint()

redis.log(redis.LOG_NOTICE, "limit key: " .. tostring(limitKey) .. " 在[" .. tostring(expireMs) .. "]ms内已经访问了 " .. tostring(current) .. " 次,最多可以访问: " .. limit .. " 次")

-- 限流了
if (current + 1 > limit) then
    return { true }
end

-- 未达到访问限制
-- 访问次数+1
redis.call("incrby", limitKey, "1")
if (current == 0) then
    -- 设置过期时间
    redis.call("pexpire", limitKey, expireMs)
end

return { false }

2、程序中执行lua脚本

redis中lua脚本使用教程

完整代码: https://gitee.com/huan1993/spring-cloud-parent/tree/master/springboot/springboot-redis-lua

六、lua脚本的debug

当我们编写好了lua脚本后，如果在执行的过程中发生了错误，那么我们如何该如何解决呢？此处我们来了解下如何debug lua 脚本。

1、lua脚本中的几个小命令

在 脚本中打一个断点

redis.breakpoint()

2、断点调试

1、执行命令

redis-cli --ldb --eval limit.lua invoked , 1 1000

limit.lua 需要debug的lua文件
invoked 为传递到 lua 脚本中 KEYS 的值
1 和 1000 为传递到 lua 脚本中 ARGV 的值

, 分割 出 KEYS 和 ARGV 的值

2、一些debug指令

  • help： 列出可用的debug指令
  • s 或 n： 运行到当前行并停止 （此时当前行还未执行）
  • c：运行到下个断点，即运行到lua脚本中存在 redis.breakpoint()方法的地方
  • list：列出当前行周围的一些源码
  • p：打印出所有的 local 变量的值
  • p <var>：打印具体的某个 local 变量的值
  • r：执行 redis 命令

-- eg:
r set key value
r get key

3、debug运行结果

redis中lua脚本使用教程

七、参考文档

https://redis.io/topics/ldb

https://redis.io/commands/eval

到此这篇关于redis中lua脚本的简单使用的文章就介绍到这了,更多相关redis中lua脚本使用内容请搜索三水点靠木以前的文章或继续浏览下面的相关文章希望大家以后多多支持三水点靠木！

redis中lua脚本使用教程

- Author -

huan1993

- Original Sources -

声明：登载此文出于传递更多信息之目的，并不意味着赞同其观点或证实其描述。

Redis 相关文章推荐
redis 查看所有的key方式
May 07 Redis
详解Redis基本命令与使用场景
Jun 01 Redis
Redis主从配置和底层实现原理解析(实战记录)
Jun 30 Redis
解析redis hash应用场景和常用命令
Aug 04 Redis
Redis入门教程详解
Aug 30 Redis
Redis读写分离搭建的完整步骤
Sep 14 Redis
Redis之RedisTemplate配置方式(序列和反序列化)
Mar 13 Redis
redis数据一致性的实现示例
Mar 18 Redis
Redis 哨兵机制及配置实现
Mar 25 Redis
基于Redis6.2.6版本部署Redis Cluster集群的问题
Apr 01 Redis
Redis实战高并发之扣减库存项目
Apr 14 Redis
Redis入门基础常用操作命令整理
Jun 01 Redis
Redis高并发防止秒杀超卖实战源码解决方案
Redis的字符串是如何实现的
SpringBoot集成Redis的思路详解
详解redis在微服务领域的贡献
详解Redis在SpringBoot工程中的综合应用
Oct 16 #Redis
Redis三种集群模式详解
浅谈Redis的keys命令到底有多慢
乱码(3) 抽象类(1) 分区(2) 信息校验(1) 接口(1) 静态压缩(1) 驱动模型(1) 正则表达式(3) 自动播放(1) Excel(4)
You might like
php操作MongoDB基础教程（连接、新增、修改、删除、查询）
2014/03/25 PHP
Smarty中调用FCKeditor的方法
2014/10/27 PHP
TP5框架实现自定义分页样式的方法示例
2020/04/05 PHP
某人初学javascript的时候写的学习笔记
2010/12/30 Javascript
利用jQuery操作对象数组的实现代码
2011/04/27 Javascript
jQuery源码分析-03构造jQuery对象-源码结构和核心函数
2011/11/14 Javascript
js setTimeout 参数传递使用介绍
2013/08/13 Javascript
简单实现js悬浮导航效果
2017/02/05 Javascript
js实现一个猜数字游戏
2017/03/31 Javascript
Vue分页组件实例代码
2017/04/17 Javascript
实战node静态文件服务器的示例代码
2018/03/08 Javascript
jQuery中复合选择器简单用法示例
2018/03/31 jQuery
前端插件之Bootstrap Dual Listbox使用教程
2019/07/23 Javascript
关于vue.js中实现方法内某些代码延时执行
2019/11/14 Javascript
Node.js+Vue脚手架环境搭建的方法步骤
2020/03/08 Javascript
基于javascript的无缝滚动动画1
2020/08/07 Javascript
浅谈实现在线预览PDF的几种解决办法
2020/08/10 Javascript
python实现2048小游戏
2015/03/30 Python
Python中用于返回绝对值的abs()方法
2015/05/14 Python
Python中处理字符串之islower()方法的使用简介
2015/05/19 Python
Python首次安装后运行报错(0xc000007b)的解决方法
2016/10/18 Python
解决pandas.DataFrame.fillna 填充Nan失败的问题
2018/11/06 Python
在keras下实现多个模型的融合方式
2020/05/23 Python
Python openpyxl模块实现excel读写操作
2020/06/30 Python
python实现图片，视频人脸识别(dlib版)
2020/11/18 Python
css3 自定义字体font-face使用介绍
2014/05/14 HTML / CSS
Perfumetrader荷兰：香水、化妆品和护肤品在线商店
2017/09/15 全球购物
运动会入场解说词
2014/02/07 职场文书
网络工程师职业规划
2014/02/10 职场文书
广播体操口号
2014/06/18 职场文书
放飞理想演讲稿
2014/09/09 职场文书
竞选学委演讲稿
2014/09/13 职场文书
四风问题个人对照检查剖析材料
2014/09/27 职场文书
办公室岗位职责
2015/02/04 职场文书
2015年党日活动总结范文
2015/03/25 职场文书
2022年四月新番
2022/03/15 日漫