【愚公系列】2022年11月 Redis数据库-Lua脚本的使用

2022-11-18 17:17:40 浏览数 (1)

文章目录

  • 前言
  • 一、Lua脚本的使用
    • 1.EVAL命令
    • 2.Evalsha命令
    • 3.SCRIPT命令
  • 二、Lua脚本的返回值
  • 注意

前言

Lua 由标准 C 编写而成,代码简洁优美,几乎在所有操作系统和平台上都可以编译,运行。

Lua脚本是一个很轻量级的脚本,也是号称性能最高的脚本,用在很多需要性能的地方,比如:游戏脚本,nginx,wireshark的脚本。

Redis实例支持Lua相关命令,通过Lua脚本可高效地处理CAS(check-and-set)命令,进一步提升Redis的性能,同时可以轻松实现以前较难实现或者不能高效实现的模式。Lua语言编写脚本传到Redis中执行,在Lua脚本中也可以调用大部分的Redis命令。使用脚本有以下三个好处:

  • 减少网络开销:有些时候需要多次请求Redis获取处理数据,而使用脚本功能就可以只使用一次请求完成相同操作,减少了网络往返时延。
  • 原子操作:Redis会将整个脚本作为一个整体执行,中间不会被其他命令插入。也就是说在编写脚本的过程中无须担心会出现竞态条件,也就是无须使用事务。事务可以完成的所有功能,都可以用脚本来完成。
  • 复用:客户端发送的脚本会永久存储在Redis中,这就意味着其他客户端(可以是其他语言开发的项目)可以复用这一脚本而不需要使用代码完成同样的逻辑。

一、Lua脚本的使用

Redis调用Lua的方式主要又如下几种

1.EVAL命令

EVAL的命令格式如下:

代码语言:javascript复制
EVAL script numkeys key [key ...] arg [arg ...]

字段说明:

  • script:脚本内容。
  • numkeys:key参数的数量。
  • key和arg:这两个参数向脚本传递数据,它们的值可以在脚本中分别使用KEYS[index]和ARGV[index]两个表类型的全局变量访问,numkeys为key的数量和其索引的最大值,argv的索引为key和argv数量总和减去numkeys,它们的索引都是从1开始,超出则返回nil。
代码语言:javascript复制
PS C:UsersHappydevToolsRedis-x64-3.2.100> redis-cli
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"

2.Evalsha命令

EVAL的命令格式如下:

代码语言:javascript复制
EVALSHA sha1 numkeys key [key ...] arg [arg ...] 

字段说明:

  • sha1 : 通过 SCRIPT LOAD 生成的 sha1 校验码。
  • numkeys: 用于指定键名参数的个数。
  • key [key …]: 从 EVAL 的第三个参数开始算起,表示在脚本中所用到的那些 Redis 键(key),这些键名参数可以在 Lua 中通过全局变量 KEYS 数组,用 1 为基址的形式访问( KEYS[1] , KEYS[2] ,以此类推)。
  • arg [arg …]: 附加参数,在 Lua 中通过全局变量 ARGV 数组访问,访问的形式和 KEYS 变量类似( ARGV[1] 、 ARGV[2] ,诸如此类)。
代码语言:javascript复制
127.0.0.1:6379> SCRIPT LOAD "return 'hello moto'"
"232fd51614574cf0867b83d384a5e898cfd24e5a"
127.0.0.1:6379> EVALSHA "232fd51614574cf0867b83d384a5e898cfd24e5a" 0
"hello moto"

3.SCRIPT命令

  • SCRIPT LOAD script:将脚本 script 添加到脚本缓存中,但并不立即执行这个脚本。
  • SCRIPT EXISTS script [script …]:查看指定的脚本是否已经被保存在缓存当中。
  • SCRIPT FLUSH:从脚本缓存中移除所有脚本。
  • SCRIPT KILL:杀死当前正在运行的 Lua 脚本。如果当前执行的脚本对Redis的数据进行了修改,则SCRIPT KILL不会终止脚本的运行,因为这样违背了原子性。
  • SHUTDOWN NOSAVE:强制终止Redis将原先脚本的修改操作返回,不进行持久化操作,这意味着所有发送在上一次的快照后的数据库修改都会丢失。

二、Lua脚本的返回值

很多情况下,都需要脚本通过return返回值,如果没有执行return则默认返回nil。因为我们可以像调用其他Redis内置命令一样调用我们自己写的脚本,所以同样Redis会自动将脚本返回值的Lua数据类型转化成Redis的返回值类型。具体的转换规则如下:

1、Lua的数字类型,Redis为整数类型。

代码语言:javascript复制
127.0.0.1:6379> eval 'return 1.1' 0
(integer) 1

2、Lua的字符串类型,Redis也是字符串类型

3、 Lua的表类型(数组形式),Redis会返回多行字符串

代码语言:javascript复制
127.0.0.1:6379> eval 'return {0,1}' 0
1) (integer) 0
2) (integer) 1

4、 Lua表类型(只有一个ok字段存储状态信息),Redis为成功状态回复

代码语言:javascript复制
127.0.0.1:6379> eval 'return {ok="this is ok"}' 0
this is ok

5、Lua表类型(只有一个err字段存储状态信息),Redis为错误状态回复

代码语言:javascript复制
127.0.0.1:6379> eval 'return {err="so bad"}' 0
(error) so bad

6、Lua的bool类型中true为Redis的1,false为nil

代码语言:javascript复制
127.0.0.1:6379> eval 'return true' 0
(integer) 1
127.0.0.1:6379> eval 'return false' 0
(nil)

注意

Redis脚本禁止使用Lua标准库中与文件或系统调用相关的函数,在脚本中只允许对Redis的数据进行处理。并且Redis还通过禁用脚本的全局变量的方式保证每个脚本都是相对隔离的,不会互相干扰。

0 人点赞