Redis的Lua扩展

时间:2022-07-22
本文章向大家介绍Redis的Lua扩展,主要内容包括其使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。

基本环境

# redis
➜  ~ redis-server -v
Redis server v=3.2.6

# lua
➜  ~ lua -v
Lua 5.2.4  Copyright (C) 1994-2015 Lua.org, PUC-Rio

参考文档:

概要

Redis从2.6版本开始引入了对Lua脚本的支持,通过在服务器中嵌入Lua环境,Redis客户端可以使用Lua脚本,直接在服务器端执行多个Redis命令。

使用脚本的好处

  • 较少网络开销。可将多个请求通过脚本的形式一次性发送,较少网络时延
  • 原子操作。Redis会将整个脚本作为一个整体执行,中间不会插入其他命令。因此脚本编写过程无需担心出现竞态条件,无需使用事务
  • 复用。客户端发送的脚本会永久存在Redis中。这样其他客户端可复用这一脚本而无需使用代码完成相同逻辑

使用脚本的限制

  • 不支持集群。
  • 原子操作。如果脚本执行耗时,会对其他操作造成影响

使用

调用Lua脚本的语法

传入脚本文件

# KEYS 与 ARGV 中间使用 “ , ” 逗号分隔,前后有空格
$ redis-cli --eval path/to/redis.lua KEYS[1] KEYS[2] , ARGV[1] ARGV[2] ...

    * --eval,告诉redis-cli读取并运行后面的lua脚本
    * path/to/redis.lua,是lua脚本的位置,也可以直接为脚本字符串。是一个Lua 5.1 script。
    * KEYS[1] KEYS[2],是要操作的键,可以指定多个,在lua脚本中通过KEYS[1], KEYS[2]获取
    * ARGV[1] ARGV[2],参数,在lua脚本中通过ARGV[1], ARGV[2]获取。

传入脚本字符串

127.0.0.1:6379> eval script numkeys key [key ...] arg [arg ...]
    
    * eval: 将要执行脚本
    * script: 脚本字符串
    * numkeys: KEY参数个数
    * key ... : 操作的键
    * arg ... : 参数

使用示例

KEYS ARGV

# xx.lua
return {KEYS, ARGV}
➜  ~ redis-cli --eval xx.lua k1 k2 k3 , a1 a2 a3
1) 1) "k1"
   2) "k2"
   3) "k3"
2) 1) "a1"
   2) "a2"
   3) "a3"
➜  ~ redis-cli
127.0.0.1:6379> eval "redis.call('set', 'name', 'xx')" 0
(nil)
127.0.0.1:6379> eval "redis.call('get', 'name')" 0
(nil)
127.0.0.1:6379> eval "return redis.call('get', 'name')" 0
"xx"