كيف يعمل البرمجة النصية 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 هو معرفة قيمة على مستوى محترف **لتنفيذ عمليات ذرية معقدة**، وبالتالي فهو مفيد لاستخدام Redis متقدم.

القيمة الأساسية هي **الذرية للمنطق متعدد الخطوات**: يتم تنفيذ برنامج Lua نصي **بالكامل كوحدة ذرية واحدة** (لا يتداخل أي أوامر أخرى)، مما يجعله الطريقة الموصى بها للقيام بعمليات قراءة-تعديل-كتابة التي يجب أن تكون ذرية — مثل التحديثات الشرطية، الإفراج الآمن عن الأقفال (حذف فقط إذا كان الرمز مطابقاً)، تحديد معدل الاستخدام، والعدادات المعقدة — غالباً ما يكون أفضل من `MULTI`/`EXEC` لأن البرامج النصية تدعم **المنطق الشرطي** (لا يمكن للمعاملة اتخاذ قرارات بناءً على القراءات الوسيطة، لكن البرنامج النصي يستطيع).

هذا يحل حاجة حقيقية للعمليات الذرية أكثر تعقيداً من الأوامر الفردية.

فائدة ثانوية هي **عدد أقل من رحلات الشبكة** (عمليات متعددة في استدعاء واحد، مما يقلل التأخير) وتشغيل **منطق مخصص على جانب الخادم** (بالقرب من البيانات).

فهم **`EVALSHA`** (تخزين البرامج النصية مؤقتاً بالبصمة لتجنب إعادة إرسالها) هو تقنية فعالية عملية للبرامج النصية المستخدمة بكثرة.

بشكل حاسم، فهم **التحذيرات** مهم: البرامج النصية **تحجب الخادم أحادي الخيط** أثناء التشغيل، لذا يجب أن تكون سريعة وبسيطة (البرنامج النصي البطيء يوقف جميع العملاء — خطر أداء حقيقي)، وينبغي أن تكون البرامج النصية حتمية مع تمرير المفاتيح عبر `KEYS[]` (لصحة المجموعة).

هذا الوعي يمنع إساءة استخدام البرامج النصية للحسابات الثقيلة.

نظراً لأن العمليات الذرية المعقدة هي حاجة حقيقية (الأقفال، المنطق الشرطي، التحديثات الذرية متعددة الخطوات)، وبما أن برامج Lua النصية توفر منطقاً ذرياً وأحادي الجولة وعلى جانب الخادم وهي الطريقة الموصى بها لها (مع تحذيرات مهمة حول الحجب)، فإن فهم البرمجة النصية بـ Lua — كيفية عملها، لماذا هي ذرية ومفيدة، تخزين EVALSHA مؤقتاً، وتحذيرات الحفاظ على السرعة — هي معرفة قيمة على مستوى محترف لاستخدام Redis متقدم، والأداة الصحيحة للمنطق الذري متعدد الخطوات وموضوع يعكس خبرة Redis أعمق.