Как работает Lua-скриптинг в Redis?

Question

Accepted Answer

Redis может выполнять **Lua-скрипты** на стороне сервера — запуская несколько команд как одну **атомарную** операцию. Скрипты позволяют реализовать сложную атомарную логику, снижают количество сетевых обращений и являются рекомендуемым способом выполнения многошаговых атомарных операций в Redis.

## Выполнение Lua-скрипта

```bash
# EVAL runs a Lua script; KEYS[] and ARGV[] pass keys and arguments
EVAL "return redis.call('SET', KEYS[1], ARGV[1])" 1 mykey myvalue

# a script can run multiple commands and logic atomically
EVAL "
  local current = redis.call('GET', KEYS[1])
  if current == ARGV[1] then
    return redis.call('DEL', KEYS[1])   -- delete only if value matches (atomic check-and-delete)
  end
  return 0
" 1 lock:resource mytoken
```

Скрипты используют `redis.call()` для выполнения команд, с передачей `KEYS[]` (имена ключей) и `ARGV[]` (аргументы). Весь скрипт выполняется **атомарно** как одна единица.

## Почему скрипты атомарны и полезны

```text
✓ ATOMICITY — the ENTIRE script runs as one unit, no other commands interleave
  → perfect for read-modify-write logic that must be atomic (locks, conditional updates,
    rate limiting, complex counters) — better than MULTI/EXEC for conditional logic
✓ FEWER ROUND-TRIPS — multiple operations in ONE call to Redis (less network latency)
✓ Custom LOGIC server-side — conditionals, loops, computations near the data
```

## EVALSHA — кеширование скриптов

```bash
# load a script once, then call by its SHA hash (avoids resending the script each time)
SCRIPT LOAD "return redis.call('GET', KEYS[1])"   # => returns a SHA1 hash
EVALSHA <sha> 1 mykey                              # run the cached script by hash
```

`EVALSHA` выполняет предварительно загруженный скрипт по его хешу — эффективно для часто используемых скриптов (скрипт кешируется на стороне сервера).

## Предостережения

```text
⚠️ Scripts BLOCK the server while running (Redis is single-threaded) → keep them FAST
   and simple (no slow loops/operations — they'd stall ALL clients)
⚠️ Scripts should be deterministic; pass keys via KEYS[] (for cluster correctness)
→ Use scripts for short, atomic logic — not heavy computation.
```

## Почему это важно

Понимание Lua-скриптинга в Redis — ценное знание уровня senior для **выполнения сложных атомарных операций**, поэтому оно полезно для продвинутого использования Redis.

Основная ценность — **атомарность многошаговой логики**: Lua-скрипт выполняется **целиком как одна атомарная единица** (другие команды не переплетаются), что делает его рекомендуемым способом для операций чтения-изменения-записи, которые должны быть атомарными — таких как условные обновления, безопасное освобождение блокировки (удаление только если токен совпадает), ограничение частоты запросов и сложные счётчики — часто лучше чем `MULTI`/`EXEC`, потому что скрипты поддерживают **условную логику** (транзакция не может принимать решения на основе промежуточных чтений, а скрипт может).

Это решает реальную потребность в атомарных операциях более сложных чем отдельные команды.

Вторичное преимущество — **меньше сетевых обращений** (несколько операций в одном вызове, снижение задержки) и выполнение **пользовательской логики на стороне сервера** (близко к данным).

Понимание **`EVALSHA`** (кеширование скриптов по хешу во избежание их повторной отправки) — практический приём оптимизации для часто используемых скриптов.

Критически важно понимать **предостережения**: скрипты **блокируют однопоточный сервер** во время выполнения, поэтому они должны быть быстрыми и простыми (медленный скрипт замораживает всех клиентов — реальная опасность для производительности), и скрипты должны быть детерминированными с ключами, передаваемыми через `KEYS[]` (для корректности в кластере).

Это осознание предотвращает неправильное использование скриптов для тяжёлых вычислений.

Поскольку сложные атомарные операции — подлинная потребность (блокировки, условная логика, атомарные многошаговые обновления), и поскольку Lua-скрипты обеспечивают атомарную, однорундовую, серверную логику, которая является рекомендуемым подходом для них (с важными предостережениями о блокировании), понимание Lua-скриптинга — как он работает, почему он атомарен и полезен, кеширование через EVALSHA и предостережения о быстродействии — это ценное знание уровня senior для продвинутого использования Redis, правильный инструмент для атомарной многошаговой логики и тема, отражающая более глубокое понимание Redis.