لماذا أمرر قيم SQL عبر params؟

افصل القيم عن صياغة SQL

يجمع الاستعلام غالباً بين تعليمات ثابتة وقيم آتية من نموذج أو مدخل سير عمل أو نتيجة قاعدة بيانات سابقة. أنشئ عبارة SQL بعناصر نائبة ومرر القيم المقابلة في `params`. بذلك تُعامل القيمة كبيانات لا كجزء من الصياغة، وتقل أخطاء علامات الاقتباس أو تهريب النص.

استخدم الأسلوب نفسه للقراءة والكتابة: تقبل SQL Database `{ sql, params }` للقراءة، بينما تقبل عمليات التنفيذ `action: "execute"` مع `sql` و`params`. تمثل المعلمات قيماً لا أسماء جداول أو أعمدة؛ لذا اختر بنية الاستعلام والمعرفات صراحةً داخل عبارة SQL.

تحقق من العبارة والنتيجة

استخدم تنسيق المعلمات الذي تتوقعه قاعدة البيانات المتصلة، ومرر القيم بترتيب العناصر النائبة نفسه. لا تفترض أن المعلمة تستبدل اسم جدول أو عمود أو كلمة SQL أساسية. حدد بنية الاستعلام عمداً وأبقِ البيانات المتغيرة في المعلمات.

في القراءة، افحص الصفوف المعادة وتأكد أن المرشح يطابق السجلات المطلوبة. وفي execute راجع الصفوف أو التغييرات أو lastRowId حسب الحالة. إذا كان من الممكن أن تمس الكتابة كل الصفوف، فأضف شرط WHERE مقصوداً؛ وتتطلب التحديثات وعمليات الحذف غير المقيدة `all: true`.