Kako funkcionira Lua skriptiranje u Redisu?

Question

Accepted Answer

Redis može izvršiti **Lua skripte** na strani servera — pokrenuti više naredbi kao jednu **atomsku** operaciju. Skripte omogućavaju kompleksnu atomsku logiku, smanjuju broj mrežnih okruglih putanja i preporučeni su način za višeetapne atomske operacije u Redisu.

## Pokretanje Lua skripte

```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
```

Skripte koriste `redis.call()` za pokretanje naredbi, s `KEYS[]` (imena ključeva) i `ARGV[]` (argumenti) proslijeđeni. Cijela skripla se izvršava **atomski** kao jedna cjelina.

## Zašto su skripte atomske i korisne

```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 — cachiranje skripti

```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` pokreće prethodno učitanu skriptu pomoću njezine heš vrijednosti — učinkovito za često korištene skripte (skripla je cachirana na strani servera).

## Opasnosti

```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.
```

## Zašto je važno

Razumijevanje Lua skriptiranja u Redisu vrijedna je znanja na razini seniora za **izvođenje složenih atomskih operacija**, pa je korisna za naprednu upotrebu Redisa.

Osnovnu vrijednost predstavlja **atomskost za višeetapnu logiku**: Lua skripla se izvršava **u potpunosti kao jednoj atomskoj jedinici** (bez interleave ostalih naredbi), što je preporučeni način za izvođenje operacija čitanja-izmjene-pisanja koje moraju biti atomske — kao što su uvjetne ažuriranja, siguran otpust zaključavanja (brisanje samo ako se žeton podudara), ograničavanje brzine i složeni brojači — često bolje nego `MULTI`/`EXEC` jer skripte podržavaju **uvjetnu logiku** (transakcija ne može donositi odluke na temelju međunih čitanja, ali skripla može).

Ovo rješava pravu potrebu za atomskim operacijama kompliciranijim od pojedinih naredbi.

Sekundarna korist je **manji broj mrežnih okruglih putanja** (više operacija u jednom pozivu, smanjenje latencije) i pokretanje **prilagođene logike na strani servera** (blizu podataka).

Razumijevanje **`EVALSHA`** (cachiranje skripti prema heš vrijednosti kako bi se izbjeglo ponovno slanje) je praktična tehnika učinkovitosti za često korištene skripte.

Kritično je razumijevanje **opasnosti**: skripte **blokiraju single-threaded server** tijekom izvršavanja, pa moraju biti brze i jednostavne (spora skripla zaustavlja sve klijente — pravi hazard za performanse), i skripte trebaju biti determinističke s ključevima proslijeđenim putem `KEYS[]` (za ispravnost klastera).

Ova svijest sprječava zlouporabu skripti za intenzivno računanje.

Budući da su kompleksne atomske operacije pravia potreba (zaključavanja, uvjetna logika, atomske višeetapne ažuriranja), i budući da Lua skripte omogućavaju atomsku, jednu-okruglu-putanju, logiku na strani servera koja je preporučeni pristup za njih (s važnim opasnostima o blokiranju), razumijevanje Lua skriptiranja — kako funkcionira, zašto je atomsko i korisno, cachiranje EVALSHA i opasnosti da se drži brzo — je vrijedna znanja na razini seniora za naprednu upotrebu Redisa, pravi alat za atomsku višeetapnu logiku i tema koja odražava dublju stručnost u Redisu.