summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/eval_ro.md
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2021-07-17 07:34:44 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2021-07-17 07:34:44 +0000
commit02a04a2335701bfc8d6a1087338f58e9f37ceb52 (patch)
tree92c2c729cfdaaa3942a251357ff100e28a8b8624 /iredis/data/commands/eval_ro.md
parentAdding upstream version 1.9.1. (diff)
downloadiredis-02a04a2335701bfc8d6a1087338f58e9f37ceb52.tar.xz
iredis-02a04a2335701bfc8d6a1087338f58e9f37ceb52.zip
Adding upstream version 1.9.4.upstream/1.9.4
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'iredis/data/commands/eval_ro.md')
-rw-r--r--iredis/data/commands/eval_ro.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/iredis/data/commands/eval_ro.md b/iredis/data/commands/eval_ro.md
new file mode 100644
index 0000000..db8c707
--- /dev/null
+++ b/iredis/data/commands/eval_ro.md
@@ -0,0 +1,19 @@
+This is a read-only variant of the `EVAL` command that isn't allowed to execute
+commands that modify data.
+
+Unlike `EVAL`, scripts executed with this command can always be killed and never
+affect the replication stream. Because it can only read data, this command can
+always be executed on a master or a replica.
+
+@examples
+
+```
+> SET mykey "Hello"
+OK
+
+> EVAL_RO "return redis.call('GET', KEYS[1])" 1 mykey
+"Hello"
+
+> EVAL_RO "return redis.call('DEL', KEYS[1])" 1 mykey
+(error) ERR Error running script (call to f_359f69785f876b7f3f60597d81534f3d6c403284): @user_script:1: @user_script: 1: Write commands are not allowed from read-only scripts
+```