Si funksionon skriptimi Lua në Redis?

Question

Accepted Answer

Redis mund të ekzekutojë **skripte Lua** në anën e serverit — duke ekzekutuar komanda të shumëfishta si një operacion i vetëm **atomik**. Skriptet mundësojnë logjikën komplekse atomike, zvogëlojnë përgjigjet e rrjetit, dhe janë mënyra e rekomanduar për të bërë operacione atomike me shumë hapa në Redis.

## Ekzekutimi i një skripti 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
```

Skriptet përdorin `redis.call()` për të ekzekutuar komanda, me `KEYS[]` (emrat e çelësave) dhe `ARGV[]` (argumente) të kaluara. I gjithë skripti ekzekutohet **atomikisht** si një njësi e vetme.

## Pse skriptet janë atomike dhe të dobishme

```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 — cache-imi i skripteve

```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` ekzekuton një skript të ngarkuar më parë sipas hash-it të tij — efikas për skripte që përdoren shpesh (skripti cache-ohet në anën e serverit).

## Paralajmërimet

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

## Pse ka rëndësi

Kuptimi i skriptimit Lua në Redis është njohuri e vlefshme në nivel të avancuar për **kryerjen e operacioneve komplekse atomike**, kështu që është i dobishëm për përdorimin e avancuar të Redis.

Vlera kryesore është **atomiciteti për logjikën me shumë hapa**: një skript Lua ekzekutohet **plotësisht si një njësi atomike e vetme** (asnjë komandë tjetër nuk ndërpritet), e cila e bën atë mënyrën e rekomanduar për të bërë operacione lexo-modifiko-shkruaj që duhet të jenë atomike — si përditësimet e kushtëzuara, lëshimi i sigurt i bllokimit (fshije vetëm nëse identifikuesi përputhet), limitimi i shpejtësisë, dhe numëruesit kompleksë — shpesh më mirë se `MULTI`/`EXEC` sepse skriptet mbështesin **logjikën e kushtëzuar** (transaksioni nuk mund të marrë vendime bazuar në leximet ndërmjetëse, por një skript mund).

Kjo zgjidh një nevojë të vërtetë për operacione atomike më komplekse se komandat e vetme.

Nje përfitim dytësor është **më pak përgjigje rrjeti** (operacione të shumëfishta në një thirrje, duke zvogëluar vonesën) dhe ekzekutimin e **logjikës së personalizuar në anën e serverit** (afër të dhënave).

Kuptimi i **`EVALSHA`** (cache-imi i skripteve sipas hash-it për të shmangur dërgimin e tyre përsëri) është një teknikë praktike e efikasitetit për skriptet që përdoren shpesh.

Për sa kohë që skriptet **bllokojnë serverin me fije të vetme** gjatë ekzekutimit, kjo është kritike: ato duhet të jenë të shpejta dhe të thjeshta (një skript i ngadaltë ndalon të gjithë klientët — një rrezik real i performancës), dhe skriptet duhet të jenë deterministe me çelësa të kaluar përmes `KEYS[]` (për korrektësinë e klasterit).

Kjo vetëdije parandalon keqpërdorimin e skripteve për llogaritjen e rëndë.

Meqenëse operacionet komplekse atomike janë një nevojë e vërtetë (bllokime, logjikë e kushtëzuar, përditësime atomike me shumë hapa), dhe meqenëse skriptet Lua ofrojnë logjikën atomike, me një rund të vetëm në rrjet, në anën e serverit që është qasja e rekomanduar për to (me paralajmërimet e rëndësishme rreth bllokimit), kuptimi i skriptimit Lua — si funksionon, pse është atomik dhe i dobishëm, cache-imi EVALSHA, dhe paralajmërimet e mbajimit të shpejtit — është njohuri e vlefshme në nivel të avancuar për përdorimin e avancuar të Redis, mjeti i duhur për logjikën atomike me shumë hapa dhe një temë që pasqyron ekspertizën më të thellë të Redis.