如何在Redis中执行Lua脚本?

数据库 Redis
Redis调用Lua脚本,脚本执行完成后将结果返回给Redis,Redis再将结果返回给客户端。这个过程中会出现Redis执行结果类型到Lua数据类型的转换,然后Lua类型到Redis类型的转换。

Redis中需要执行Lua脚本的场景

Redis中每条命令都是原子性的,即执行结果要么全部成功要么全部失败。在某些业务场景下,需要执行多条命令,并且要保证多条命令的原子性。这时,如果命令逐条执行,显然是不能保证原子性的。有同学可能会想到使用Redis的事务功能,事务是可以保证原子性,但是受限于命令的功能,有些场景下并不能实现想要的功能。

使用执行Lua脚本的方式可以解决以上问题,Lua脚本整体上在Redis中是原子性的。

在Redis中执行Lua脚本

在Redis中通过EVAL命令来执行Lua脚本,基本语法如下:

redis 127.0.0.1:6379> EVAL script numkeys key [key ...] arg [arg ...]

参数说明:

  • script: 参数是一段Lua脚本程序。脚本不必(也不应该)定义为一个 Lua 函数。
  • numkeys: 用于指定键名参数的个数。
  • key [key ...]: 从 EVAL 的第三个参数开始算起,表示在脚本中所用到的那些 Redis 键(key),这些键名参数可以在 Lua 中通过全局变量 KEYS 数组,用 1 为基址的形式访问( KEYS[1] , KEYS[2] ,以此类推)。
  • arg [arg ...]: 附加参数,在 Lua 中通过全局变量 ARGV 数组访问,访问的形式和 KEYS 变量类似( ARGV[1] 、 ARGV[2] ,诸如此类)。

获取指定key的值,相当于于 GET somekey

EVAL "return redis.call('GET', KEYS[1])" 1 somekey

再看一个LPUSH的例子,相当于 LPUSH somelist 1 2 3

EVAL "return redis.call('LPUSH',KEYS[1], ARGV[1], ARGV[2], ARGV[3])" 1 somelist 1 2 3

简单说下Redis执行lua脚本相关的其他几个命令:

  • EVALSHA命令根据给定的SHA1,执行缓存在服务器中的脚本。
  • SCRIPT EXISTS命令用于检查指定SHA1值对应的脚本是否在Redis缓存中。
  • SCRIPT FLUSH命令用于清除所有的缓存脚本。
  • SCRIPT KILL命令用于杀死当前正在运行的 Lua 脚本,当且仅当这个脚本没有执行过任何写操作时,这个命令才生效。这个命令主要用于终止运行时间过长的脚本,比如一个因为 BUG 而发生无限循环的脚本。SCRIPT KILL 执行之后,当前正在运行的脚本会被杀死,执行这个脚本的客户端会从 EVAL 命令的阻塞当中退出,并收到一个错误作为返回值。

Lua脚本中调用Reids命令

调用Redis命令,当执行出错时,该方法会直接返回错误,并退出。

redis.call(redisCommand, key, argv...)

调用Redis命令,当执行出错时,记录错误信息,并继续执行。

redis.pcall(redisCommand, key, argv...)

记录日志,写入到Redis配置的日志文件中,日志级别有四种,分别是redis.LOG_DEBUG、redis.LOG_VERBOS、redis.LOG_NOTICE和redis.LOG_WARNING。

redis.log(logLevel, message)

计算输入字符串的sha1哈希值。

redis.sha1hex(arvg)

Lua与Redis类型转换

Redis调用Lua脚本,脚本执行完成后将结果返回给Redis,Redis再将结果返回给客户端。这个过程中会出现Redis执行结果类型到Lua数据类型的转换,然后Lua类型到Redis类型的转换。Redis类型到Lua类型转换关系如下:

Redis返回的数据类型

Lua数据类型

integer(整数回复)

number(数字类型)

bulk replay(字符串)

string(字符串类型)

多行字符串

table(数组形式)

status(状态回复)

table(只有一个ok字段的数组)

error(错误回复)

table(只有一个err字段的数组)

Lua类型到Redis类型转换关系如下:

Lua数据类型

Redis返回数据类型

number(数字类型)

integer(整数回复)

string(字符串类型)

bulk replay(字符串)

table(数组形式)

多行字符串

table(只有一个ok字段的数组)

status(状态回复)

table(只有一个err字段的数组)

error(错误回复)

责任编辑:姜华 来源: 今日头条
相关推荐

2011-08-23 09:56:52

UnicodeLua

2011-08-25 09:55:27

2011-08-25 13:22:40

CEGUILua脚本

2016-12-20 09:30:22

shell脚本linux

2011-08-24 10:32:03

LuaPlusC++Lua

2017-04-13 10:46:14

Webpack执行代码分割

2017-01-18 20:38:36

LinuxShell脚本命令

2023-10-19 14:52:27

2021-01-18 17:23:30

代码调试VS Code

2009-06-08 21:35:02

Java启动程序

2019-08-06 14:06:19

数据库工具技术

2021-11-26 00:04:01

RedisLua 脚本

2021-04-21 08:03:34

脚本Shell读取

2021-08-20 10:46:25

Shell脚本文件Linux

2020-06-04 17:00:37

Linux命令脚本

2017-03-10 10:37:16

Linux命令脚本

2011-08-31 15:36:59

Lua解释器

2022-03-08 07:22:48

Redis脚本分布式锁

2011-05-17 09:32:25

DB2

2011-08-23 16:59:16

C++LUA脚本LUA API
点赞
收藏

51CTO技术栈公众号