Redis系列 | 阿里雲 Redis 版數據庫Lua腳本支持與限制

官方工單支持：

您好，
您的實例版本是16G集群版（8節點），
集群實例的命令限制您參考：
https://help.aliyun.com/document_detail/145968.html?spm=5176.11065259.1996646101.searchclickresult.30071fcfYM8QY7

 

Lua使用限制

為了保證腳本里面的所有操作都在相同slot進行，雲數據庫Redis集群版本會對Lua腳本做如下限制：

1、所有key都應該由KEYS數組來傳遞，redis.call/pcall中調用的redis命令，key的位置必須是KEYS array（不能使用Lua變量替換KEYS），否則直接返回錯誤信息：

 

-ERR bad lua script for redis cluster, all the keys that the script uses should be passed using the KEYS array\r\n

 

2、所有key必須在1個slot上，否則返回錯誤信息，"-ERR eval/evalsha command keys must be in same slot\r\n"。

3、調用必須要帶有key，否則直接返回錯誤信息， "-ERR for redis cluster, eval/evalsha number of keys can't be negative or zero\r\n"。

4、不支持發布訂閱命令，包括：PSUBSCRIBE、PUBSUB、PUBLISH、PUNSUBSCRIBE、SUBSCRIBE、UNSUBSCRIBE。　　

 

原生的Lua腳本案例（不支持）

            $script = <<<luascript
			local rate_key = KEYS[1]
			local limit = tonumber(ARGV[1]) -- 最大限制
			local expire_time = ARGV[2] -- 過期時間
			local result = redis.call('SETNX',rate_key,1); -- SETNX 只有不存在的時候才設置,返回1。否則返回0
			if result == 1 then
				redis.call('expire',rate_key,expire_time)
				return 1
			else
				if tonumber(redis.call("GET", rate_key)) >= limit then
					return 0
				else
					redis.call("INCR", rate_key)
					return 1
				end
			end
luascript;
            $scriptSha = $redis->script('load', $script);

 以上腳本在原生的Redis是可以運行的，但是在阿里雲Redis則不行，直接返回false

解釋一下官方的限制：

key的位置必須是KEYS array（不能使用Lua變量替換KEYS），而上面的腳本則是把KEYS[1] 賦值給了Lua變量 rate_key ，從而導致不能使用

   最終修改兼容版本 

        local limit = tonumber(ARGV[1]) -- 最大限制
        local expire_time = ARGV[2] -- 過期時間
        local result = redis.call('SETNX',KEYS[1],1); -- SETNX 只有不存在的時候才設置,返回1。否則返回0
        if result == 1 then
            redis.call('expire',KEYS[1],expire_time)
            return 1
        else
            if tonumber(redis.call("GET", KEYS[1])) >= limit then
                return 0
            else
                redis.call("INCR", KEYS[1])
                return 1
            end
        end
luascript;
        $scriptSha = $redis->script('load', $script);

　　

負載信息

"# Server
redis_version:4.0.11
tcp_port:6379
uptime_in_seconds:5198246
uptime_in_days:60
hz:10
lru_clock:16284991

# Clients
connected_clients:0
client_longest_output_list:0
client_biggest_input_buf:14
blocked_clients:0

# Memory
used_memory:1569209784
used_memory_human:1.46G
used_memory_rss:1856352256
used_memory_rss_human:1.73G
used_memory_peak:1672249240
used_memory_peak_human:1.56G
used_memory_overhead:954746082
used_memory_overhead_human:910.52M
used_memory_startup:161978704
used_memory_startup_human:154.47M
used_memory_dataset:614463702
used_memory_dataset_human:586.00M
used_memory_lua:345088
used_memory_lua_human:337.00K
maxmemory:17179869184
maxmemory_human:16.00G
maxmemory_policy:volatile-lru
mem_fragmentation_ratio:1.45
mem_allocator:jemalloc-5.1.0
active_defrag_running:0
lazyfree_pending_objects:0

# Stats
total_connections_received:160659957
total_commands_processed:777588709
instantaneous_ops_per_sec:2763
total_net_input_bytes:81642748753
total_net_output_bytes:305788723191
instantaneous_input_kbps:327
instantaneous_output_kbps:1346
rejected_connections:0
sync_full:8
sync_partial_ok:0
sync_partial_err:0
expired_keys:38333350
evicted_keys:0
keyspace_hits:181375543
keyspace_misses:74435657
pubsub_channels:0
pubsub_patterns:0
latest_fork_usec:9565
migrate_cached_sockets:0

# Replication
connected_slaves:1

master_repl_offset:10266296484
second_repl_offset:-1
repl_backlog_active:1
repl_backlog_size:33554432
repl_backlog_first_byte_offset:10232742053
repl_backlog_histlen:33554432

# CPU
used_cpu_sys:39038.91
used_cpu_user:45386.70
used_cpu_sys_children:9.07
used_cpu_user_children:100.86

# Cluster
cluster_enabled:0
databases:256
nodecount:8

# Keyspace
db0:keys=5856727,expires=5856723,avg_ttl=14963354
db10:keys=1,expires=0,avg_ttl=0
"