What's new in Valkey 9.0? Discover new features and improvements. Read the announcement.

EVAL_RO

Executes a read-only server-side Lua script.

Usage
EVAL_RO script numkeys [key ...] [arg ...]
Complexity
Depends on the script that is executed.
Since
7.0.0
ACL Categories
@scripting, @slow
Command flags
NOSCRIPT, SKIP_MONITOR, NO_MANDATORY_KEYS, STALE, READONLY

This is a read-only variant of the EVAL command that cannot execute commands that modify data.

For more information about when to use this command vs EVAL, please refer to Read-only scripts.

For more information about EVAL scripts please refer to Introduction to Eval Scripts.

Examples

> SET mykey "Hello"
OK

> EVAL_RO "return server.call('GET', KEYS[1])" 1 mykey
"Hello"

> EVAL_RO "return server.call('DEL', KEYS[1])" 1 mykey
(error) ERR Error running script (call to b0d697da25b13e49157b2c214a4033546aba2104): @user_script:1: @user_script: 1: Write commands are not allowed from read-only scripts.

Replies

RESP2

The return value depends on the script that was executed.

RESP3

The return value depends on the script that was executed.