انواع سهمیه
پلاتفرم Earth Engine تعدادی محدودیت سهمیه دارد تا اطمینان حاصل شود که منابع به‌طور عادلانه بین کاربران توزیع می‌شود. ازآنجایی‌که انواع مختلفی از منابع در Earth Engine دردسترس است (محاسبه، فضای ذخیره‌سازی، و غیره)، انواع مختلفی از محدودیت‌های سهمیه وجود دارد.
تفاوت اصلی بین انواع مختلف سهمیه این است که آیا قابل‌تنظیم هستند یا نه. برای برخی‌از انواع سهمیه، می‌توانیم محدودیت‌ها را براساس هر کاربر یا هر پروژه تغییر دهیم، درحالی‌که انواع دیگر محدودیت‌های سراسری سیستم هستند که قابل‌تغییر نیستند.
حدود سهمیه قابل‌تنظیم
محدودیت‌های زیر به‌ازای هر پروژه اعمال می‌شود.
| نوع سهمیه | مقدار پیش‌فرض (در هر پروژه) |
|---|---|
| حداکثر درخواست‌های هم‌زمان (پایانه استاندارد) | ۴۰ درخواست هم‌زمان |
| حداکثر درخواست‌های هم‌زمان (پایانه با حجم بالا) | ۴۰ درخواست هم‌زمان |
| حداکثر نرخ درخواست‌ها (در هر پروژه) | ۱۰۰ درخواست در ثانیه (۶۰۰۰ درخواست در دقیقه) |
| حداکثر نرخ درخواست‌ها (برای هر حساب) | ۱۰۰ درخواست در ثانیه (۶۰۰۰ درخواست در دقیقه) |
| میانگین تکالیف دسته‌ای هم‌زمان | ۲ تکلیف (به‌طور میانگین) |
| حداکثر فضای ذخیره‌سازی دارایی | ۲۵۰ گیگابایت |
| حداکثر تعداد دارایی‌ها | ۱۰٬۰۰۰ |
| زمان محاسبه Earth Engine (زمان EECU) در روز برحسب ثانیه | نامحدود |
درخواست‌های تعاملی هم‌زمان
هر پروژه می‌تواند درخواست‌های تعاملی را به‌صورت موازی تا سقف سهمیه ایجاد کند. اگر از حد مجاز فراتر بروید، Earth Engine خطای «HTTP 429: درخواست‌های بیش‌ازحد» را برمی‌گرداند. به‌طور کلی، این خطاها توسط کتابخانه کارخواه Earth Engine مدیریت می‌شود که درخواست‌ها را در عقب‌نشینی نمایی می‌پیچد و پُرسمان را تا زمانی که موفق شود تکرار می‌کند. کتابخانه کارخواه Earth Engine درخواست را تا پنج بار تکرار می‌کند.
برای کمک به جلوگیری از دریافت این خطاهای ۴۲۹، شاید بخواهید ذخیره مؤقت را برای برنامه‌تان فعال کنید، مثلاً بااستفاده از memcache، تا درصورت امکان از پُرسمان‌های زائد جلوگیری کنید. اگر از نسخه قدیمی‌تر کتابخانه کارخواه Earth Engine استفاده می‌کنید که پُرسمان‌ها را به‌طور خودکار تکرار نمی‌کند، یا اگر پُرسمان پس‌از پنج بار تکرار هنوز تکمیل نشده است، ممکن است لازم باشد عقب‌نشینی نمایی را در درخواست‌ها پیاده‌سازی کنید.
نرخ درخواست‌ها (پُرسمان در ثانیه)
علاوه‌بر محدودیت‌های هم‌زمانی، Earth Engine نرخ درخواست‌های تعاملی را در سطح پروژه و کاربر محدود می‌کند. این تنظیمات را می‌توانید در کنسول Cloud تغییر دهید
تکالیف دسته‌ای هم‌زمان
تکالیف دسته‌ای به مقدار کمی موازی‌سازی محدود می‌شوند، زیرا از منابع بیشتری نسبت به تعاملی درخواست‌ها استفاده می‌کنند.
هنگام استفاده غیرتجاری از Earth Engine، حداکثر تعداد کارهای دسته‌ای که می‌توانید به‌طور هم‌زمان اجرا کنید توسط سطح غیرتجاری شما تعیین می‌شود.
هنگام استفاده تجاری از Earth Engine، حداکثر تعداد کارهای دسته‌ای که می‌توانید به‌طور هم‌زمان اجرا کنید توسط طرح قیمت‌گذاری تعیین می‌شود، هرچند ممکن است با تنظیم حد هم‌زمانی کار دسته‌ای برای هر پروژه، این تعداد بیشتر کاهش یابد. به‌طور پیش‌فرض، حد هم‌زمانی تکلیف دسته‌ای در پروژه روی حداکثر مقدار مجاز توسط طرح پرداخت پیکربندی‌شده در حساب صورت‌حساب پروژه تنظیم شده است. برای مشاهده یا به‌روزرسانی این محدودیت در پروژه، اسناد ابزار خط فرمان را ببینید.
سهمیه فضای ذخیره‌سازی دارایی
هر دارایی Earth Engine دارای اندازه ذخیره‌سازی داده متناظر است که برحسب بایت اندازه‌گیری می‌شود. دارایی‌ها می‌توانند متعلق به «پروژه‌های ابری» یا افراد (دارایی‌های قدیمی) باشند و هر دارایی در حد مجاز Earth Engine مالک آن برای فضای ذخیره‌سازی کلی و تعداد دارایی‌ها لحاظ می‌شود.
برای درخواست سهمیه فضای ذخیره‌سازی دارایی اضافی برای استفاده غیرتجاری یا پژوهشی، استفاده غیرتجاری یا پژوهشی را ببینید.
زمان EECU در روز
اگر می‌خواهید هزینه‌ها را کنترل کنید، می‌توانید مقدار زمان EECU را که یک پروژه مجاز است در روز در Earth Engine مصرف کند محدود کنید. به‌طور پیش‌فرض، این سهمیه
نامحدود است. «سرپرستان سهمیه» می‌توانند این محدودیت را در «کنسول Cloud»
تنظیم کنند
با فیلتر کردن برای سنجه سهمیه earthengine.googleapis.com/daily_eecu_usage_time. پس‌از تنظیم، این سهمیه زمان EECU مصرف‌شده توسط درخواست‌های موفق Earth Engine همه کاربران در یک پروژه را جمع‌آوری می‌کند. وقتی از سهمیه فراتر بروید،
درخواست‌ها ناموفق خواهد بود تا زمانی که سهمیه در روز بعد بازنشانی شود یا حد مجاز
افزایش یابد. برای جزئیات بیشتر درباره تنظیم این سهمیه، راهنمای کنترل هزینه را ببینید.
حدود سهمیه ثابت
این نوع محدودیت‌های سهمیه در سطح پلاتفرم تنظیم می‌شوند، بنابراین نمی‌توان آن‌ها را براساس هر کاربر یا هر پروژه تنظیم کرد. بعید است که درطول زمان تغییر قابل‌توجهی داشته باشند.
زمان محاسبه
انواع مختلف درخواست‌ها حداکثر مدت‌زمان متفاوتی دارند که به‌طور مفصل در سند محیط‌های پردازش شرح داده شده است.
برای دریافت راهنمایی درباره رفع خطاهای وقفه زمانی، راهنمای اشکال‌زدایی را ببینید.
ردپای حافظه به‌ازای هر درخواست
وقتی درخواستی با خطای «از حد حافظه کاربر فراتر رفته است» ناموفق می‌شود، یعنی Earth Engine نتوانسته است پاسخ را در ردپای حافظه مجاز محاسبه کند. پلاتفرم محاسباتی EE مقدار محدودی RAM دردسترس دارد و برای اطمینان از اینکه سیستم پایدار باقی می‌ماند، هر درخواست فقط می‌تواند از مقدار مشخصی استفاده کند. حداکثر مقدار حافظه دردسترس به نوع درخواست بستگی دارد (مثلاً برای تکلیف دسته‌ای بیشتر از کاشی نقشه است)، اما این محدودیت‌ها در سطح سیستم هستند.
برای دریافت راهنمایی درباره رفع خطاهای حافظه، راهنمای اشکال‌زدایی را ببینید.
جمع‌آوری‌شده
هنگام پردازش درخواست‌های Earth Engine، انواع خاصی از محاسبات فرعی را که می‌دانیم ازنظر محاسباتی سنگین هستند جدا می‌کنیم. به این محاسبات فرعی «انبوهش» می‌گویند و در سیستم EE به‌طور ویژه مدیریت می‌شوند. نتایج تجمیع‌ها برای جلوگیری از محاسبه مجدد در حافظه نهان ذخیره می‌شوند.
انبوهش‌های هم‌زمان
برای جلوگیری از انشعاب محاسباتی کنترل‌نشده، تعداد تجمیع‌هایی را که یک کاربر می‌تواند به‌طور هم‌زمان اجرا کند محدود می‌کنیم و این محدودیت قابل‌تغییر نیست. وقتی درخواستی با خطای «تعداد تجمیع‌های هم‌زمان بسیار زیاد است» ناموفق می‌شود، به این معنی است که درخواست‌کننده تعداد زیادی تجمیع درحال اجرا به‌طور هم‌زمان داشته است.
برای دریافت راهنمایی درباره رفع خطاهای انبوهش هم‌زمان، راهنمای اشکال‌زدایی را ببینید.
نتایج انبوهش بزرگ
وقتی درخواستی با خطای «مقدار محاسبه‌شده خیلی بزرگ است» ناموفق می‌شود، به این معنی است که انبوهش نتیجه‌ای را برگردانده است که برای قرار گرفتن در حافظه نهان ما خیلی بزرگ است. محدودیت اندازه برای نتایج محاسبه‌شده ۱۰۰ مبی‌بایت است و این محدودیت در سراسر سیستم اعمال می‌شود.
حدود وارد کردن جدول
حدود بارگذاری جدول در راهنمای وارد کردن داده‌های جدول توضیح داده شده است.
اندازه پایه‌بار درخواست
اندازه هر پُرسمان به Earth Engine به ۱۰ مگابایت محدود است. این حد معمولاً فقط زمانی فراتر می‌رود که برخی‌از داده‌های اضافی بزرگ مستقیماً در پُرسمان گنجانده شوند، مانند ساختار GeoJSON یا شیپ‌فایل که در پُرسمان به‌صورت درون‌خطی قرار گرفته است. این اشیاء باید بارگذاری شوند و به دارایی FeatureCollection تبدیل شوند و با شناسه دارایی ارجاع داده شوند.
طول صف تکلیف
تکالیفی که درانتظار زمان‌بندی هستند (در وضعیت READY) «صف تکلیف» را تشکیل می‌دهند. صف هر پروژه حداکثر از ۳۰۰۰ تکلیف پشتیبانی می‌کند. یعنی
نمی‌توانید بیش‌از ۳٬۰۰۰ تکلیف در وضعیت READY داشته باشید.
حدود سهمیه توابع شطرنجی BigQuery
سهمیه‌های زیر برای تماس با Earth Engine از BigQuery اعمال می‌شود، مثلاً هنگام استفاده از تابع SQL ST_REGIONSTATS.
| نوع سهمیه | مقدار پیش‌فرض (در هر پروژه) |
|---|---|
| زمان جایگاه BigQuery در روز | ۱٬۲۶۰٬۰۰۰ ثانیه-جایگاه (۳۵۰ ساعت-جایگاه) |
زمان جایگاه BigQuery در روز
سهمیه زمان-جایگاه BigQuery در روز سهمیه‌ای سفارشی است که به شما امکان می‌دهد
مقدار زمان-جایگاهی را که توابع شطرنجی BigQuery مجازند در روزی مشخص برای پروژه‌ای مشخص
در Earth Engine مصرف کنند محدود کنید. سهمیه روزانه مجموع زمان همه پُرسمان‌ها را، حتی آن‌هایی که ناموفق بوده‌اند، جمع می‌کند. می‌توانید سهمیه را در
کنسول Cloud
زیر سنجه earthengine.googleapis.com/bigquery_slot_usage_time مشاهده کنید و
«سرپرست سهمیه» می‌تواند مقدار را افزایش یا کاهش دهد. برای افزایش مقدار
به بالاتر از مقدار پیش‌فرض، درخواست افزایش سهمیه
ایجاد کنید،
که به‌طور خودکار تأیید خواهد شد. این تغییر ظرف ۱۰ دقیقه اعمال می‌شود.
اگر از این سهمیه فراتر بروید، BigQuery پیام خطای زیر را برمی‌گرداند:
From Earth Engine: Custom quota exceeded: Your usage exceeded the custom quota for'earthengine.googleapis.com/bigquery_slot_usage_time', which is adjustable by your administrator in the Google Cloud console: https://console.cloud.google.com/quotas/?project=_.
وقتی از سهمیه فراتر رفتید، تماس‌های ST_REGIONSTATS ناموفق خواهد بود تا زمانی که سهمیه در روز بعد بازنشانی شود یا سرپرست حد را افزایش دهد.