Redis'te Lua komut dosyaları nasıl çalışır?

Question

Accepted Answer

Redis, **Lua komut dosyalarını** sunucu tarafında çalıştırabiliyor — birden çok komutu tek bir **atomik** işlem olarak çalıştırıyor. Komut dosyaları karmaşık atomik mantığı sağlar, ağ gidiş-dönüşlerini azaltır ve Redis'te çok adımlı atomik işlemler yapmanın önerilen yoludur.

## Lua komut dosyası çalıştırma

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

Komut dosyaları komutları çalıştırmak için `redis.call()` kullanırlar; `KEYS[]` (anahtar adları) ve `ARGV[]` (argümanlar) iletilir. Tüm komut dosyası **atomik** olarak tek bir birim halinde yürütülür.

## Komut dosyalarının neden atomik ve faydalı olduğu

```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 — komut dosyalarını önbelleğe alma

```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` daha önce yüklenen bir komut dosyasını kendi hash'i ile çalıştırır — sıkça kullanılan komut dosyaları için verimlidir (komut dosyası sunucu tarafında önbelleğe alınır).

## Uyarılar

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

## Neden önemli

Redis'te Lua komut dosyası yazmanın anlamını kavramak, **karmaşık atomik işlemler gerçekleştirmek** için değerli üst düzey bilgidir; bu nedenle ileri Redis kullanımı için faydalıdır.

Temel değer **çok adımlı mantık için atomiklik**tir: bir Lua komut dosyası **tamamen tek bir atomik birim olarak** yürütülür (başka komutlar araya girmez), bu da okuma-değiştirme-yazma işlemlerinin atomik olması gereken — koşullu güncellemeler, güvenli kilit serbest bırakma (belirteci yalnızca eşleşirse sil), hız sınırlandırması ve karmaşık sayaçlar gibi — genellikle `MULTI`/`EXEC` öğesinden daha iyidir çünkü komut dosyaları **koşullu mantığı** destekler (işlem ara okumalarına bağlı olarak karar veremez, ancak bir komut dosyası yapabilir).

Bu, tek komutlardan daha karmaşık olan atomik işlemler için gerçek bir ihtiyacı çözer.

İkincil bir fayda **daha az ağ gidiş-dönüşü**dür (tek çağrıda birden çok işlem, gecikmeyi azaltır) ve **sunucu tarafında özel mantık çalıştırmaktır** (veriye yakın).

**`EVALSHA`** (hash ile komut dosyalarını önbelleğe alma yöntemi sayesinde yeniden göndermekten kaçınmak) anlamını kavramak, sıkça kullanılan komut dosyaları için pratik bir verimlilik tekniğidir.

Kritik olarak, **uyarıları** anlamak önemlidir: komut dosyaları çalışırken **tek iş parçacıklı sunucuyu engeller**, bu nedenle hızlı ve basit tutulmalıdırlar (yavaş bir komut dosyası tüm istemcileri durdurur — gerçek bir performans tehlikesi) ve komut dosyaları belirleyici olmalıdır; anahtarlar `KEYS[]` aracılığıyla iletilmelidir (küme doğruluğu için).

Bu farkındalık, komut dosyalarının ağır hesaplama için yanlış kullanılmasını önler.

Karmaşık atomik işlemler gerçek bir gerek olduğu için (kilitler, koşullu mantık, atomik çok adımlı güncellemeler) ve Lua komut dosyaları atomik, tek gidiş-dönüş, sunucu tarafında mantık sağladığı için (hızlı tutulması hakkında önemli uyarılarla birlikte), Lua komut dosyası yazma — nasıl çalıştığı, neden atomik ve faydalı olduğu, EVALSHA önbelleğe alma ve hızlı tutulması uyarıları — ileri Redis kullanımı için değerli üst düzey bilgidir; atomik çok adımlı mantık için doğru araç ve daha derin Redis uzmanlığını yansıtan bir konudur.