Books mgamalhz.com

لما تعدّل حاجة واحدة أو كذا حاجة مع بعض

Single-Object and Multi-Object Operations

فيه أمثلة Laravel

الخلاصة

  • لما كتابة واحدة بتعدّل أكتر من object، زي إيميل جديد والـ counter بتاعه، من غير transaction ممكن حد يشوف نص الشغل، أو نص الشغل يتكتب ويقف.
  • حتى الـ object الواحد محتاج حماية، والداتابيز بتديهالك لوحدها تقريبًا في كل مكان: log عشان الأعطال، وlock عشان التزامن.
  • الـ increment والـ compare-and-set مفيدين جدًا، بس دول مش transactions، حتى لو حد سماهم كده.
  • الـ foreign keys والداتا المتكررة والـ indexes كلها حالات الكتابة فيها لازم تعدّل أكتر من object مع بعض.
  • ميزة الـ transaction إنها تعمل abort بأمان فتعيد. بس الـ retry نفسه ليه فخاخ لازم تعرفها.

إيميل جديد والعداد مش متحدّث

المثال بتاع الكتاب: عندك أبلكيشن إيميل، وعايز تعرض لكل user عدد الرسايل اللي لسه ما اتقرتش. ممكن تعدهم كل مرة بـ query، بس لو الرسايل كتير ده هيبقى بطيء. فتعمل عمود unread_count وتزوده مع كل رسالة جديدة. ده اسمه denormalization: نفس المعلومة متخزنة في مكانين عشان القراية تبقى أسرع.

دلوقتي كل رسالة جديدة محتاجة كتابتين: تضيف الإيميل، وتزود الـ counter. والكتابتين دول ممكن يبوظوا بطريقتين مختلفتين.

المشكلة الأولى: حد شاف نص الشغل

الـ user بيفتح الأبلكيشن في نفس اللحظة اللي الرسالة بتتكتب فيها. لو القراية جت بين الكتابتين، هيشوف الرسالة الجديدة في الليستة، والـ counter لسه بيقول صفر. الداتا قدامه مش منطقية. دي مشكلة isolation: كان المفروض يشوف الكتابتين مع بعض، أو ميشوفش ولا واحدة فيهم.

نفس التوقيت بالظبط. الفرق إن الـ transaction مبتخليش حد يشوف كتابة لسه ما خلصتش، وبعد الـ commit هيشوف الاتنين مع بعض.

المشكلة التانية: نص الشغل اتكتب ووقف

المرة دي مفيش حد بيقرا. الإيميل اتضاف، وبعدين تحديث الـ counter فشل: السيرفر وقع، أو النت فصل، أو حصل error. الإيميل موجود والـ counter فاتته رسالة، وهيفضل غلط لحد ما حد يكتشفه ويصلحه بإيده. دي مشكلة atomicity: الكتابتين كان لازم يحصلوا مع بعض، أو ميحصلش ولا واحدة فيهم.

الفشل حصل في الحالتين. الفرق إن مع الـ transaction مفيش نص شغل يفضل وراك.
المشكلتين بيظهروا بس لما الكتابة بتعدّل أكتر من حاجة. Isolation: محدش يشوف نص الشغل. Atomicity: نص الشغل ميفضلش متكتب.
نفس المثال في LaravelPHP
// من غير transaction: كل query بتعمل commit لوحدها
Email::create(['user_id' => $user->id, 'subject' => $subject]);
$user->increment('unread_count');
// لو السيرفر وقع هنا، الإيميل اتكتب والـ counter لأ
// ولو حد قرا بين السطرين، هيشوف إيميل جديد والـ counter زي ما هو

// مع transaction: الاتنين يبانوا مع بعض، أو يترموا مع بعض
DB::transaction(function () use ($user, $subject) {
    Email::create(['user_id' => $user->id, 'subject' => $subject]);
    $user->increment('unread_count');
});

الداتابيز تعرف إزاي إن العمليات دي مع بعض؟

عشان الداتابيز تعامل كذا كتابة كوحدة واحدة، لازم تعرف أنهي كتابات تبع أنهي transaction. في الداتابيز الـ relational، ده بيتحدد بالـ connection بتاع الـ client: كل حاجة بتتبعت على نفس الـ connection بين BEGIN وCOMMIT تعتبر transaction واحدة.

الطريقة دي بسيطة، بس فيها ثغرة. لو الـ client بعت COMMIT والـ connection وقعت قبل ما الرد يوصل، هو مش هيعرف الـ transaction اتحفظت ولا لأ. عشان كده فيه أنظمة بتدي كل transaction ID خاص بيها مش مربوط بالـ connection، فتقدر تسأل عنها بعدين.

وداتابيز كتير من النوع الـ non-relational معندهاش الفكرة دي أصلًا. ممكن يبقى عندها API بيكتب كذا key في request واحد، بس ده مش معناه إنهم atomic: ممكن نصهم يتكتب ونصهم يفشل، وأنت تفضل مش عارف.

في Laravel: الـ transaction مربوطة بالـ connectionPHP
DB::transaction(function () use ($order) {
    // على الـ default connection: جوه الـ transaction
    $order->update(['status' => 'paid']);

    // على connection تانية: برا الـ transaction خالص
    DB::connection('analytics')->table('events')->insert([
        'type'     => 'order_paid',
        'order_id' => $order->id,
    ]);

    throw new RuntimeException('boom');
    // الـ order رجع زي ما كان، بس الـ event فضل متسجل
});

حتى الـ object الواحد محتاج حماية

طب لو الكتابة على حاجة واحدة بس؟ تخيل إنك بتكتب JSON document حجمه 20KB، وحصل واحد من دول:

شبكةالنت فصل في النصبعد ما أول 10KB وصلوا، هل الداتابيز تحفظ النص ده؟
عطلالكهربا قطعتوالداتابيز بتكتب الجديد فوق القديم على الديسك. هيفضل عندك نص ده ونص ده؟
تزامنحد قرا وهي بتتكتبهيشوف القديم، ولا الجديد، ولا خليط من الاتنين؟

الحالات دي كانت هتبقى كارثة، بس الخبر الحلو إن تقريبًا كل storage engine بيحميك منها لوحده، على مستوى الـ object الواحد. الأعطال بيحلها بـ log: الداتابيز بتسجل الكتابة الأول، فلو وقعت في النص تقدر ترجع وتعرف وصلت لفين. والتزامن بيحله بـ lock على الـ object: thread واحد بس يكتب فيه في نفس الوقت، فمحدش يقرا خليط.

ده نفس الـ write-ahead log اللي ظهر في الـ Durability. نفس الأداة بتحميك من الحالتين.

عمليات أقوى على الـ object الواحد: مفيدة، بس مش transactions

داتابيز كتير بتديك عمليات أقوى شوية على الـ object الواحد:

  • atomic increment: تقول للداتابيز "زوّد واحد" بدل ما تقرا القيمة، وتزود عليها في الكود، وتكتبها تاني. كده لو اتنين زودوا في نفس اللحظة، الزيادتين يتحسبوا.
  • compare-and-set: الكتابة تحصل بس لو القيمة لسه زي ما قريتها. لو حد غيرها في النص، الكتابة بترفض وأنت تقرر تعمل إيه.

العمليتين دول بيحلوا مشكلة مهمة اسمها lost update: اتنين بيعدلوا نفس الحاجة، فتعديل واحد فيهم يضيع من غير ما حد يحس. وهنرجعلها بالتفصيل في سكشن الـ isolation levels.

بس خلي بالك: دي مش transactions. فيه داتابيز بتسمي العمليات دي lightweight transactions، وفيه اللي بيقول عليها ACID في التسويق. الكتاب واضح هنا: الـ transaction معناها إنك تجمع كذا عملية على كذا object في وحدة واحدة. الـ increment على عمود واحد مش هيحميك في مثال الإيميل، لأن المشكلة كانت بين حاجتين مختلفتين.

في Laravel: increment وcompare-and-setPHP
// read-modify-write في الأبلكيشن: اتنين requests يقروا 10 ويكتبوا 11
$post = Post::find($id);
$post->views = $post->views + 1;
$post->save();

// atomic increment في الداتابيز نفسها
Post::whereKey($id)->increment('views');
// UPDATE posts SET views = views + 1 WHERE id = ?

// compare-and-set بعمود version
$affected = Post::whereKey($post->id)
    ->where('version', $post->version)
    ->update([
        'body'    => $newBody,
        'version' => $post->version + 1,
    ]);

if ($affected === 0) {
    // حد عدّل الـ post بعد ما قريته: conflict
    throw new ConflictException('Reload and try again');
}

ليه محتاجين transaction تعدّل كذا حاجة؟

داتابيز كتير من النوع الموزع على سيرفرات كتير شالت الـ multi-object transactions، لأنها صعبة تتعمل لما الداتا متقسمة على أكتر من سيرفر، وممكن تأثر على السرعة أو على إن السيستم يفضل شغال. بس الكتاب بيقول إن مفيش حاجة بتمنعها في سيستم موزع، وده هيتشرح في آخر الشابتر.

السؤال الحقيقي: هل نقدر نعيش بـ key-value وعمليات على object واحد بس؟ في حالات آه. بس فيه حالات كتير الكتابة فيها لازم تعدّل أكتر من حاجة:

تلات حالات عادية جدًا، والتلاتة فيهم الكتابة الواحدة بتعدّل أكتر من مكان.

في الـ document databases، الـ document model نفسه بيقلل المشكلة: لو كل اللي بتعدله جوه document واحد، مش محتاج غير الحماية بتاعة الـ object الواحد. المشكلة بتظهر لما تضطر تكرر الداتا في كذا document، زي الـ counter في مثال الإيميل.

تقدر تبني أبلكيشن من غير transactions، بس هتدفع التمن في حتتين: الـ error handling هيبقى أصعب بكتير لأنك لازم تفكر في كل حالة فشل في النص، والتزامن هيجيبلك bugs صعب تلاقيها.

في Laravel: الحالتين الأولانيينPHP
// foreign key: الـ order وكل الـ items بتاعته مع بعض
DB::transaction(function () use ($data) {
    $order = Order::create(['user_id' => $data['user_id']]);

    foreach ($data['items'] as $item) {
        $order->items()->create($item);
    }
});

// denormalization: التعليق والـ counter بتاعه مع بعض
DB::transaction(function () use ($post, $body) {
    $post->comments()->create(['body' => $body]);
    $post->increment('comments_count');
});
مثال عملي الـ index اللي جوه MySQL أو Postgres بيتحدّث جوه نفس الـ transaction لوحده، فمش هتحس بالمشكلة دي هناك. هتحس بيها لما الـ index يبقى سيستم تاني، زي Laravel Scout مع Meilisearch أو Algolia. من غير 'after_commit' => true في config/scout.php، الـ model ممكن يتبعت للـ search index، وبعدين الـ transaction تعمل rollback. ساعتها البحث هيلاقي record مش موجود في الداتابيز أصلًا.

الـ abort ميزة، بس الـ retry مش ببلاش

أهم حاجة في الـ transaction إنها تقدر تتلغي بأمان. الفكرة من ACID: لو الداتابيز مش هتقدر تضمن الوعد بتاعها، أحسن تلغي الـ transaction كلها بدل ما تسيبها نصها.

مش كل السيستمز ماشية كده. مثلًا الداتابيز اللي بتعمل leaderless replication ماشية بمبدأ "best effort": بتعمل اللي تقدر عليه، ولو حصل error مش هترجع اللي اتعمل. والأبلكيشن هو اللي يصلح.

والغريب إن حتى مع داتابيز بتعمل abort صح، كتير من الـ ORMs مبتعملش retry لوحدها. الكتاب بيدي مثال بـ Rails وDjango، وLaravel نفس الحكاية: DB::transaction بتحاول مرة واحدة بس لو مقلتلهاش غير كده. فالـ error بيطلع للـ user، والداتا اللي دخلها بتضيع، وده عكس الفايدة من الـ abort أصلًا.

بس الـ retry مش حل سحري. قبل ما تعيد، فيه أسئلة لازم تسألها:

أربع أسئلة قبل الـ retry. الإجابة الغلط على أي واحد فيهم بتحول الحل لمشكلة جديدة.

الأسئلة دي جاية من الحالات اللي الكتاب بيعددها:

  • الـ commit نجح والرد ضاع: الـ client هيفتكر إن العملية فشلت ويعيدها، فتتنفذ مرتين. لازم الأبلكيشن نفسه يعرف إن الطلب ده اتنفذ قبل كده.
  • الضغط على الداتابيز: لو الفشل سببه overload، الـ retry على طول هيزود الضغط ويخلي الوضع أسوأ. الحل إنك تستنى وقت بيزيد كل مرة (exponential backoff)، وتحط حد أقصى لعدد المحاولات.
  • نوع الـ error: الـ retry مفيد مع الأخطاء اللي ممكن تروح لوحدها، زي deadlock أو مشكلة شبكة أو failover. لكن لو الـ error دايم، زي إن الداتا بتكسر constraint، الـ retry ملوش لازمة.
  • الحاجات اللي برا الداتابيز: لو الـ transaction بتبعت إيميل، الإيميل ممكن يتبعت حتى لو الـ transaction اتلغت، ومع كل retry يتبعت تاني. ولو عايز سيستمين مختلفين ينجحوا أو يفشلوا مع بعض، ده محتاج two-phase commit، وده جاي في آخر الشابتر.
  • الـ client نفسه وقع: لو الـ process اللي بيعمل retry وقع وهو بيحاول، أي داتا كان بيحاول يكتبها هتضيع.
في Laravel: الـ retry الصحPHP
// الافتراضي attempts = 1: أي deadlock يطلع exception على طول
DB::transaction(fn () => $this->transfer($from, $to, $amount));

// Laravel بيعيد بس لو الـ error سببه concurrency
// (deadlock أو serialization failure)، وغير كده بيرمي الـ exception
DB::transaction(fn () => $this->transfer($from, $to, $amount), attempts: 3);

// retry مع exponential backoff: 200ms ثم 400ms ثم 800ms
retry(
    times: 4,
    callback: fn () => DB::transaction(fn () => $this->transfer($from, $to, $amount)),
    sleepMilliseconds: fn (int $attempt) => 100 * (2 ** $attempt),
    // MySQL: 1213 = deadlock, 1205 = lock wait timeout
    when: fn (Throwable $e) => $e instanceof QueryException
        && in_array($e->errorInfo[1] ?? null, [1213, 1205]),
);

// permanent error: الـ retry ملوش لازمة
try {
    User::create(['email' => $email]);
} catch (UniqueConstraintViolationException $e) {
    return back()->withErrors(['email' => 'الإيميل ده متسجل قبل كده']);
}
في Laravel: الطلب المتكرر والحاجات اللي برا الداتابيزPHP
// idempotency key: نفس الطلب لو اتبعت مرتين يتنفذ مرة واحدة
// في الـ migration:
$table->string('idempotency_key')->unique();

// في الـ controller:
$key = $request->header('Idempotency-Key');

try {
    $payment = Payment::create([
        'idempotency_key' => $key,
        'amount'          => $request->integer('amount'),
    ]);
} catch (UniqueConstraintViolationException $e) {
    // الطلب ده اتنفذ قبل كده: رجّع نفس النتيجة
    $payment = Payment::where('idempotency_key', $key)->firstOrFail();
}

// side effects: الإيميل يتبعت بعد الـ commit بس، ومرة واحدة
DB::transaction(function () use ($order) {
    $order->update(['status' => 'paid']);
    $order->invoice()->create(['total' => $order->total]);

    DB::afterCommit(fn () => Mail::to($order->user)->send(new OrderPaid($order)));
    // أو: SendOrderPaidMail::dispatch($order)->afterCommit();
});
الـ abort بيخلي الـ retry ممكن. بس الـ retry الآمن محتاج تعرف نوع الـ error، وتستنى صح، وتمنع التكرار، وتأجل أي حاجة برا الداتابيز لحد بعد الـ commit.

الأمثلة مكتوبة على Laravel 11 وما بعده، وكود الـ retry مثال على MySQL.

ملخص من كتاب Designing Data-Intensive Applications لـ Martin Kleppmann وChris Riccomini. الكتاب