سامانه گوگل ارث انجین (GEE) بهعنوان یکی از شناختهشدهترین پلتفرمهای پردازش ابری برای تحلیل دادههای مکانی و سنجش از دور، خدمات گستردهای را در اختیار پژوهشگران قرار میدهد. با این حال، هنگام کار با دادههای حجیم، کاربران گاه با پیام محدودیت منابع مواجه میشوند. این یادداشت میکوشد دلایل احتمالی بروز پیام «our project has exceeded its noncommercial compute quota and is now in restricted mode» را بررسی کند و راهکارهایی برای بهبود عملکرد کدهای جاوا اسکریپت در محیط Code Editor ارائه دهد.
مقدمه و تبیین ماهیت پیام
خدمات گوگل ارث انجین برای مقاصد پژوهشی، دانشگاهی و غیرتجاری عمدتاً بهصورت رایگان ارائه میشود، اما منابع محاسباتی تخصیصیافته به هر کاربر نامحدود نیست. در معماری کنونی ارث انجین، هر حساب کاربری به یک پروژه در بستر گوگل کلود (Google Cloud Project) متصل است.
گوگل میزان مصرف منابع محاسباتی را بر اساس واحدی به نام EECU-hour (ساعتِ واحد محاسباتی ارث انجین) اندازهگیری میکند. دریافت پیام Restricted Mode به این معناست که مصرف پروژه شما از سقف ماهانهٔ رایگان تعیینشده برای حسابهای غیرتجاری فراتر رفته است. برخلاف تصور رایج، این حالت به معنای قطع کامل دسترسی نیست؛ در حالت محدود، درخواستها، اپلیکیشنهای EE و تسکهای صادراتی همچنان اجرا میشوند، اما با تعداد کارگرهای پردازشی و همزمانی کمتر، که در عمل به کاهش محسوس سرعت و توان عملیاتی میانجامد.
از این رو، از نظر فنی دقیقتر است این پیام را یک اعلان وضعیت سهمیه بدانیم تا یک «خطا» به معنای متعارف کلمه؛ برخلاف خطاهای واقعی اجرایی ارث انجین — مانند خطای HTTP 429 (Too Many Requests) که هنگام عبور حاد از سقف نرخ درخواست رخ میدهد و معمولاً توسط کتابخانهٔ کلاینت با backoff نمایی مدیریت میشود — این پیام مانع اجرای کد یا شکست (crash) اسکریپت نمیشود، بلکه صرفاً هشداری دربارهٔ کاهش کارایی است.
عوامل اصلی بروز محدودیت پردازشی
اتمام زودهنگام سهمیه پردازشی غالباً ناشی از کمبود منابع گوگل نیست، بلکه به معماری غیربهینهٔ کدهای نوشتهشده توسط کاربر بازمیگردد. مهمترین عوامل بروز این اختلال عبارتاند از:
- فقدان بهینهسازی الگوریتمی: استفاده از توابع تکرارشوندهٔ کلاینتساید (Client-side) مانند حلقههای
forکه مانع موازیسازی (Parallelization) پردازشها در سرورهای گوگل میشوند.
- محاسبات در مقیاس نامتناسب: درخواست تحلیل دادهها با تفکیک مکانی بسیار بالا (مثلاً رزولوشن ۱۰ متری تصاویر سنتینل) برای گسترههای جغرافیایی وسیع، مانند مقیاس ملی یا قارهای.
- پردازشهای غیرضروری: عدم فیلتر کردن تصاویر در مراحل اولیهٔ کد و اعمال توابع سنگین ریاضی بر دادههایی که در خروجی نهایی مورد نیاز نیستند.
- تراکم درخواستهای همزمان (Concurrency): اجرای همزمان چند پردازش سنگین در محیط تعاملی یا ارسال همزمان دهها دستور
Export.
راهکارهای فنی و اصول بهینهسازی
برای بازیابی دسترسی کامل و پیشگیری از تکرار این محدودیت، رعایت اصول زیر در توسعهٔ اسکریپتهای ارث انجین توصیه میشود.
شناخت چرخهٔ سهمیه و پایش مصرف
برخلاف تصور رایج، سهمیهٔ رایگان پروژههای غیرتجاری بهصورت ماهانه بازنشانی میشود، نه روزانه: این سهمیه در اول هر ماه میلادی و در نیمهشب به وقت پاسیفیک (PT) از نو تنظیم میگردد. بنابراین صرف توقف اسکریپت به مدت یک شبانهروز الزاماً مشکل را برطرف نمیکند، مگر آنکه بهطور تصادفی مصادف با آغاز ماه میلادی جدید باشد.
آنچه در کوتاهمدت واقعاً کمک میکند، پایش دقیق مصرف EECU از طریق ابزارهای رسمی گوگل مانند Cloud Monitoring و Metrics Explorer است تا کاربر بداند کدام بخش از کد بیشترین سهم را در مصرف سهمیه داشته است. همچنین میتوان از طریق Cloud Console، سقفی روزانه برای مصرف EECU پروژه تعریف کرد تا از اتمام یکبارهٔ کل سهمیهٔ ماهانه در طول چند روز جلوگیری شود.
اصلاح ساختار توابع تکرار (Iteration)
پیشنهاد میشود در محیط ارث انجین تا حد امکان از حلقههای سنتی for کمتر استفاده شود. برنامهنویسان باید رویکرد برنامهنویسی تابعی (Functional Programming) را در پیش بگیرند. جایگزینی حلقههای for با توابع سرورساید مانند ()map باعث میشود ارث انجین بتواند پردازش تصاویر را بهطور همزمان روی هزاران هستهٔ پردازشی توزیع کند که این خود کاهش چشمگیر مصرف EECU را در پی دارد.
فیلترگذاری پیشینی و برش پسینی
یک اصل مهم در کاهش بار محاسباتی، کوچکسازی حجم دادهها پیش از اعمال توابع پردازشی است:
- فیلترگذاری (Filtering): همواره پیش از انجام محاسبات، مجموعهٔ تصاویر (
ImageCollection) را با استفاده از توابعfilterDateوfilterBoundsمحدود کنید. - برش تصویر (Clipping): استفادهٔ زودهنگام از تابع
clipهندسهٔ تصاویر را پیچیده و بار پردازشی را افزایش میدهد. توصیه میشود این تابع تنها در مرحلهٔ نهایی — پیش از نمایش روی نقشه یا استخراج داده — اعمال شود.
تنظیم دقیق پارامتر Scale (مقیاس)
هنگام استفاده از توابع کاهندهٔ مکانی (مانند reduceRegion)، پارامتر scale دقت محاسبات را تعیین میکند. کاهش غیرمنطقی مقدار مقیاس، تعداد پیکسلهای تحت پردازش را بهصورت نمایی افزایش میدهد. همواره مقدار scale را متناسب با هدف پژوهش خود تنظیم کنید؛ برای نمونه، برای محاسبهٔ میانگین دمای یک استان، مقیاسهای ۱۰۰۰ یا ۵۰۰۰ متری از نظر آماری کفایت میکنند و نیازی به پردازش با دقت ۳۰ متری نیست.
انتقال از حالت تعاملی به پردازش دستهای (Batch Processing)
محیط نقشهٔ Code Editor (موسوم به Interactive Environment) برای نمایش سریع نتایج سبک طراحی شده و محدودیتهای سختگیرانهتری دارد. چنانچه خروجی مدنظرتان نیازمند پردازش سنگین است، از فراخوانی مستقیم آن با دستور Map.addLayer خودداری کنید. بهجای آن، از ماژول Export (مانند Export.image.toDrive) استفاده کنید. تسکهای صادراتی در پسزمینه اجرا میشوند و سیستم سهمیه و زمان بیشتری به آنها اختصاص میدهد.
مسیرهای افزایش سهمیه: از درخواست ویژه تا ارتقای تجاری
از آوریل ۲۰۲۶، همهٔ پروژههای غیرتجاری ارث انجین موظفاند یکی از لایههای سهمیهٔ جدید (Quota Tier) را انتخاب کنند؛ در غیر این صورت بهطور پیشفرض در لایهٔ Community قرار میگیرند. اگر پروژهٔ شما ارزش علمی، اجتماعی یا عامالمنفعهٔ قابلتوجهی دارد، دو مسیر پیش رو خواهید داشت:
- ارتقا به لایههای بالاتر یا درخواست سهمیهٔ اضافه (Uplift): ارث انجین امکان ارتقای پروژه از لایهٔ Community به لایهٔ Contributor (با سهمیهٔ بیشتر) را فراهم کرده و برای پروژههای پژوهشی یا دارای تأثیر اجتماعی-محیطزیستی، درخواست سهمیهٔ اضافه (uplift request) نیز پذیرفته میشود.
- ارتقا به حساب تجاری: اگر پردازشهای شما بخشی از یک پروژهٔ کلانداده در سطح ملی یا جهانی است و با وجود اعمال تمام تکنیکهای بهینهسازی همچنان با کمبود منابع مواجه میشوید، معماری رایگان غیرتجاری پاسخگوی نیاز شما نخواهد بود. در این مرحله، ایجاد حساب صورتحساب (Billing Account) در پلتفرم گوگل کلود و ارتقای پروژه به حساب تجاری، برای خرید منابع پردازشی مازاد، منطقیترین راهکار خواهد بود.
نتیجهگیری
مواجهه با پیام «Quota Exceeded» در پلتفرم گوگل ارث انجین به معنای نقص در عملکرد سیستم نیست، بلکه مکانیزمی کنترلی است که ضرورت بهینهسازی الگوریتمها را به کاربر یادآوری میکند. این محدودیت، همانگونه که دیدیم، بهصورت ماهانه بازنشانی میشود و در عمل به معنای کاهش کارایی است، نه قطع کامل دسترسی. توسعهدهندگان میتوانند با درک صحیح از معماری پردازش ابری، جایگزینی توابع کلاینتساید با توابع سرورساید، مدیریت دقیق مقیاس و زمان و آشنایی با لایههای سهمیهٔ جدید، بهرهوری کدهای خود را به حداکثر برسانند و بیوقفه از امکانات گستردهٔ این بستر علمی بهرهمند شوند.

