Lorixen.
AR

Apps Script يتوقف قبل إنهاء جدولك الكبير: أخطاء شائعة وحلولها

باختصار: يضع Google حدا لمدة تشغيل كل سكربت، وحدودا يومية لبعض الخدمات كالبريد، ويختلف الرقم بحسب نوع الحساب، لذلك ارجع إلى صفحة الحصص الرسمية لمعرفة القيم الحالية حتى نوفمبر 2026. إن توقف سكربتك في منتصف جدول كبير فالسبب في الغالب أنه يتعامل مع الجدول خلية خلية. الإصلاح الأول هو القراءة والكتابة بدفعات، والثاني تقسيم العمل إلى أجزاء تُستأنف تلقائيا، والثالث حفظ موضع التوقف حتى لا يعيد السكربت العمل من أوله.

كيف يبدو العطل؟

يظهر في سجل التنفيذ (Executions) في محرر Apps Script خطأ مثل "Exceeded maximum execution time"، أو يتوقف السكربت دون إكمال الصفوف الأخيرة، أو يرسل نصف الرسائل ثم يختفي أثره. قد يعمل السكربت جيدا بمئة صف ويفشل بخمسة آلاف، وهذا يدل على أن المشكلة في الحجم لا في الخطأ المنطقي.

مثال توضيحي: متجر في عمّان لديه ورقة فيها أربعة آلاف زبون، وسكربت يمر على كل صف ليجهّز رسالة تسويقية ويكتب حالة "أُرسل". يتوقف عند الصف 1300 تقريبا في كل مرة.

الخطأ الأول: استدعاء الجدول داخل حلقة

أكثر ما يبطئ السكربت أن يقرأ خلية أو يكتب خلية في كل دورة، عبر getRange(...).getValue() أو setValue() داخل حلقة. كل استدعاء رحلة إلى خدمة الجداول، وآلاف الرحلات تستهلك المدة كلها. تنصح الصفحة الرسمية لأفضل الممارسات بتقليل الاستدعاءات واستخدام عمليات الدفعات.

الحل: اقرأ النطاق كله مرة واحدة بـ getValues()، وعالجه في الذاكرة كمصفوفة، ثم اكتب النتيجة كلها مرة واحدة بـ setValues().

الخطأ الثاني: خلط القراءة والكتابة داخل الحلقة

حتى لو استخدمت الدفعات، فتناوب قراءة وكتابة صغيرة يمنع التخزين المؤقت الداخلي من العمل جيدا. اجمع كل القراءات أولا، ثم الحساب، ثم الكتابة. وإن كنت تلوّن خلايا أو تنسّق، فاستخدم setBackgrounds أو setNumberFormats على نطاق كامل لا على خلية.

الخطأ الثالث: خدمات بطيئة داخل كل صف

إرسال بريد أو استدعاء واجهة خارجية (UrlFetchApp) لكل صف يبطئ التنفيذ وقد يستهلك الحصة اليومية. لا حل سحري هنا، لكن:

  • أرسل على دفعات مجدولة: مئة صف في كل تشغيل.
  • استخدم UrlFetchApp.fetchAll لإرسال عدة طلبات معا إن كانت الخدمة المستهدفة تسمح.
  • تجنب إرسال بريد منفصل لكل صف إن كان يمكن جمعها في رسالة واحدة.

الخطأ الرابع: تشغيل كل شيء في تنفيذ واحد

حتى بعد التحسين قد يبقى حجم العمل أكبر من مدة واحدة. هنا تقسّم العمل:

  1. اكتب في خاصية السكربت (PropertiesService) رقم آخر صف تمت معالجته.
  2. عند كل تشغيل، ابدأ من الصف المحفوظ، وعالج عددا ثابتا (مثلا 500) أو أوقف قبل بلوغ حد المدة بهامش أمان (قس الوقت بـ new Date()).
  3. عند الانتهاء من الدفعة، احفظ الموضع وأنشئ مشغّلا زمنيا بعد دقيقة، يستأنف من حيث وقف.
  4. عند نهاية الجدول، احذف المشغّل وصفّر الموضع.

بذلك تمر على جدول من عشرين ألف صف عبر عدة تشغيلات صغيرة آمنة.

الخطأ الخامس: عدم حماية التشغيلات المتداخلة

إن بدأ التشغيل التالي والسابق لم ينته، قد يعالجان الصفوف نفسها فتتكرر الرسائل. استخدم LockService بقفل قصير في أول الدالة، ويفضل أن يكتب السكربت علامة "قيد المعالجة" على الصف قبل العمل عليه.

الخطأ السادس: غياب سجل يكشف أين توقف

بلا سجل لا تعرف إن كان التوقف في الصف 1300 أم 3000. اكتب في ورقة منفصلة سطرا عن كل دفعة: وقت البداية، الصف الأول والأخير، العدد، النتيجة. استخدم console.log أيضا فتظهر في صفحة التنفيذ، وراقب أي تشغيل ينتهي بخطأ.

جدول تشخيص سريع

ما تراه السبب المرجح الإجراء
يتوقف دائما عند عدد صفوف قريب حلقة تستدعي الجدول لكل خلية القراءة والكتابة الدفعية
يعمل بالأمس ويفشل اليوم تضاعف حجم البيانات تقسيم العمل بدفعات
رسائل مكررة بعد التوقف إعادة التشغيل من البداية حفظ الموضع وقفل
رسالة حصة بريد تجاوز الحد اليومي توزيع الإرسال على أيام أو تجميع الرسائل
فشل عند ضغط الزر مرتين تشغيل متداخل LockService

متى تترك Apps Script؟

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

مثال على هيكل دفعي مبسط

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

فحوص قبل أن تعتبر المشكلة محلولة

  • جرّب السكربت على نسخة من الجدول بحجم يفوق حجمك الحالي بضعفين، فتتأكد أنه يتحمل النمو.
  • تأكد أن الصفوف التي عولجت تحمل علامة تمنع معالجتها مرة ثانية.
  • افتح صفحة Executions وقارن زمن التشغيل بعد التحسين بما قبله.
  • اختبر ماذا يحدث إن توقف المشغّل في المنتصف ثم عاد: هل يكمل أم يعيد؟
  • تحقق من حصة الإرسال اليومية للبريد في صفحة الحصص الرسمية، فقد تنتهي قبل أن تنتهي الصفوف.

أسئلة شائعة

هل أرفع المدة المسموحة بدفع مال؟

الحدود تختلف بحسب نوع الحساب (مجاني أو Workspace)، ولا تُرفع بإعداد في السكربت. راجع صفحة الحصص الرسمية لمعرفة القيم الحالية لحسابك.

هل يكفي أن أقسّم الجدول إلى عدة ملفات؟

قد يخفف المشكلة مؤقتا لكنه يضاعف الصيانة. الأفضل تحسين الاستدعاءات وتقسيم المعالجة داخل الملف نفسه.

كيف أعرف أن المشغّل الزمني ما زال يعمل؟

افتح صفحة Triggers وراجع آخر تشغيل وحالته، وأضف تنبيها بالبريد إن فشل التنفيذ، فتخبرك Google عبر إعدادات الإشعارات في المشغّل.

إذا كان سكربتك يتعثر عند أرقام الإنتاج، نراجع الشيفرة معك ونعيد تنظيمها لتتحمل جدولك الفعلي.

المصادر

WhatsAppاحجز مكالمة