حصص Earth Engine

أنواع الحصص

تفرض منصة Earth Engine عددًا من حدود الحصة لضمان توزيع الموارد بشكل عادل بين المستخدمين. بما أنّ هناك العديد من الأنواع المختلفة من الموارد المتاحة في Earth Engine (الحساب والتخزين وما إلى ذلك)، هناك العديد من الأنواع المختلفة من حدود الحصة.

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

حدود الحصة القابلة للتعديل

يمكن تعديل الحدود التالية لكل مشروع على حدة. يمكنك الاطّلاع على صفحة المساعدة لمعرفة كيفية طلب حصة إضافية.

نوع الحصة القيمة التلقائية (لكل مشروع)
الحد الأقصى للطلبات المتزامنة (نقطة النهاية العادية) ‫40 طلبًا متزامنًا
الحد الأقصى للطلبات المتزامنة (نقطة نهاية ذات عدد كبير من الزيارات) ‫40 طلبًا متزامنًا
الحد الأقصى لمعدّل الطلبات (لكل مشروع) ‫100 طلب في الثانية (6000 طلب في الدقيقة)
الحد الأقصى لعدد الطلبات (لكل حساب) ‫100 طلب في الثانية (6000 طلب في الدقيقة)
متوسط عدد مهام الدفعات المتزامنة مهمتان (في المتوسط)
الحدّ الأقصى لمساحة تخزين مواد العرض ‫250 غيغابايت
الحد الأقصى لعدد مواد العرض 10,000
وقت الحوسبة في Earth Engine (وحدة حساب Earth Engine) في اليوم بالثواني غير محدودة

طلبات تفاعلية متزامنة

يمكن لكل مشروع إجراء طلبات تفاعلية بالتوازي، وذلك بما لا يتجاوز حصة معيّنة. في حال تجاوز الحدّ الأقصى، ستعرض Earth Engine أخطاء"HTTP 429: عدد الطلبات كبير جدًا". بشكل عام، تعالج مكتبة عميل Earth Engine هذه الأخطاء، وهي تغلف الطلبات في تراجع سريع للغاية، وتعيد محاولة طلب البحث إلى أن ينجح. ستعيد مكتبة برامج Earth Engine محاولة تنفيذ الطلب حتى خمس مرات.

للمساعدة في تجنُّب تلقّي أخطاء 429، ننصحك بتفعيل التخزين المؤقت لتطبيقك، مثلاً باستخدام memcache، وذلك لتجنُّب طلبات البحث المكرّرة قدر الإمكان. في حال استخدام إصدار قديم من مكتبة عميل Earth Engine لا يعيد محاولة تنفيذ طلبات البحث تلقائيًا، أو إذا لم يكتمل طلب البحث بعد خمس محاولات، قد تحتاج إلى تنفيذ التراجع الدليلي حول الطلبات.

معدّل الطلبات (طلبات البحث في الثانية)

بالإضافة إلى حدود التزامن، يفرض Earth Engine حدودًا على معدّل الطلبات التفاعلية على مستوى المشروع والمستخدم. يمكن تعديل هذه الإعدادات في Cloud Console.

مهام الدفعات المتزامنة

تقتصر مهام الدُفعات على قدر صغير من التوازي، لأنّها تستخدم موارد أكثر من الطلبات التفاعلية.

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

عند استخدام Earth Engine تجاريًا، يتم تحديد الحدّ الأقصى لعدد مهام المعالجة المجمّعة التي يمكنك تنفيذها في الوقت نفسه من خلال خطة الأسعار، ولكن يمكن خفض هذا الحدّ بشكل أكبر من خلال ضبط الحدّ الأقصى لعدد مهام المعالجة المجمّعة التي يمكن تنفيذها في الوقت نفسه لكل مشروع. يتم تلقائيًا ضبط الحد الأقصى لعدد المهام المتزامنة في الدفعة على مستوى المشروع على الحد الأقصى المسموح به بموجب خطة الدفع التي تم ضبطها في حساب الفوترة الخاص بالمشروع. للاطّلاع على هذا الحد أو تعديله في أحد المشاريع، يُرجى الاطّلاع على المستندات الخاصة بأداة سطر الأوامر.

حصة مساحة تخزين مواد العرض

يحتوي كل عنصر Earth Engine على حجم تخزين بيانات مطابق يتم قياسه بالبايت. يمكن أن تملك المشاريع على السحابة الإلكترونية مواد عرض أو يمكن أن يملكها أفراد (مواد عرض قديمة)، ويتم احتساب كل مادة عرض ضمن الحدّ الأقصى المسموح به لمالكها في Earth Engine من حيث إجمالي مساحة التخزين وعدد مواد العرض.

وقت استخدام EECU في اليوم

إذا كنت تريد التحكّم في التكاليف، يمكنك الحد من مقدار وقت وحدة حساب Earth Engine الذي يمكن أن يستهلكه مشروع على Earth Engine يوميًا. تكون هذه الحصة غير محدودة تلقائيًا. يمكن لمشرفي الحصص ضبط هذا الحدّ في Cloud Console من خلال فلترة مقياس الحصة earthengine.googleapis.com/daily_eecu_usage_time. بعد ضبط هذا الحصص، يتم تجميع وقت وحدة حساب Earth Engine (EECU) الذي استهلكته طلبات Earth Engine الناجحة من جميع المستخدمين في أحد المشاريع. عند تجاوز الحصة، ستتعذّر معالجة الطلبات إلى أن تتم إعادة ضبط الحصة في اليوم التالي أو إلى أن يتم رفع الحدّ. يمكنك الاطّلاع على دليل عناصر التحكّم في التكلفة للحصول على مزيد من التفاصيل حول ضبط هذا الحصص.

مقاعد المستخدمين

عند استخدام Earth Engine تجاريًا، يتضمّن كل مستوى اشتراك عددًا من مقاعد المستخدمين، ولكن يمكن أيضًا شراء عدد من المقاعد الإضافية.

يُتوقّع من مشرفي الخدمة شراء عدد من المقاعد لاستيعاب عدد مستخدمي Code Editor خلال دورة فوترة معيّنة.

الأسئلة الشائعة

س: من يُحتسَب ضمن عدد المقاعد؟
ج: يتم احتساب المستخدمين البشريين المميّزين فقط الذين يستخدمون موارد الحوسبة في Earth Engine من خلال محرّر الرموز البرمجية (عرض مربّعات الخرائط، وإرسال طلبات الحوسبة، وما إلى ذلك) ضمن حدّ عدد المقاعد.

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

س: ماذا عن حسابات الخدمة؟
ج: حسابات الخدمة معفاة من عدد المقاعد. ولا يتم احتسابها ضمن المستخدمين البشريين الذين ينفّذون عمليات حسابية.

س: ماذا عن المستخدمين الذين يصلون إلى Earth Engine من خلال Python؟
ج: لا يتم احتساب المستخدمين الذين يصلون إلى Earth Engine من خلال واجهة برمجة التطبيقات Python API فقط ولا يستخدمون "محرّر الرموز" ضمن استخدام المقاعد. تكون أعداد المقاعد مرتبطة باستخدام Code Editor.

س: أين يتم احتساب المقاعد؟
ج: يتم تطبيق عدد المقاعد على مستوى حساب الفوترة. يساهم جميع المستخدمين الفعليين في مؤسستك الذين يستخدمون "محرّر التعليمات البرمجية" في إجمالي عدد المقاعد لحساب الفوترة الخاص بك.

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

س: كيف يمكنني شراء المزيد من المقاعد أو تقليل عددها؟
ج: يمكنك الاطّلاع على صفحة أسعار Earth Engine للحصول على التفاصيل.

الحدود الثابتة المفروضة على كمية البيانات

يتم ضبط هذه الأنواع من حدود الحصص على مستوى النظام الأساسي، لذا لا يمكن تعديلها على أساس كل مستخدم أو كل مشروع. ومن غير المحتمل أن تتغير بشكل كبير بمرور الوقت.

وقت الحوسبة

تختلف المدة القصوى لأنواع الطلبات المختلفة، ويمكنك الاطّلاع على التفاصيل في مستندات بيئات المعالجة.

للحصول على مساعدة في حلّ أخطاء انتهاء المهلة، يُرجى الاطّلاع على دليل تصحيح الأخطاء.

استهلاك الذاكرة لكل طلب

عندما يتعذّر تنفيذ طلب بسبب "تجاوز حدّ ذاكرة المستخدم"، يعني ذلك أنّ Earth Engine لم يتمكّن من حساب الإجابة ضمن مساحة الذاكرة المسموح بها. تتوفّر منصة الحوسبة EE على مقدار محدود من ذاكرة الوصول العشوائي، ولضمان بقاء النظام مستقرًا، يمكن لكل طلب استخدام مقدار معيّن فقط. يعتمد الحد الأقصى لمقدار الذاكرة المتاحة على نوع الطلب (على سبيل المثال، يتوفّر مقدار أكبر لمهمة مجمّعة مقارنةً بطلب مربّع خريطة)، ولكن هذه الحدود تنطبق على مستوى النظام.

للحصول على مساعدة في حلّ أخطاء الذاكرة، يُرجى الاطّلاع على دليل تصحيح الأخطاء.

التجميعات

عند معالجة طلبات Earth Engine، نفصل أنواعًا معيّنة من العمليات الحسابية الفرعية التي نعلم أنّها تتطلّب قدرًا كبيرًا من العمليات الحسابية. تُعرف هذه العمليات الحسابية الفرعية باسم "عمليات التجميع"، ويتم التعامل معها بشكل خاص في نظام EE. يتم تخزين نتائج عمليات التجميع مؤقتًا لتجنُّب إعادة الحساب.

عمليات التجميع المتزامنة

لتجنُّب التوسّع غير المنضبط في الحوسبة، نضع حدًا لعدد عمليات التجميع التي يمكن للمستخدم الفردي تنفيذها في الوقت نفسه، وهذا الحد غير قابل للتغيير. عندما يتعذّر تنفيذ طلب بسبب ظهور الخطأ "عدد كبير جدًا من عمليات التجميع المتزامنة"، يعني ذلك أنّ مقدّم الطلب كان لديه عدد كبير جدًا من عمليات التجميع التي يتم تنفيذها في الوقت نفسه.

للحصول على مساعدة في حلّ أخطاء التجميع المتزامن، يُرجى الاطّلاع على دليل تصحيح الأخطاء.

نتائج التجميع الكبيرة

عندما يتعذّر تنفيذ طلب بسبب ظهور الخطأ "القيمة المحسوبة كبيرة جدًا"، يعني ذلك أنّ عملية التجميع عرضت نتيجة كبيرة جدًا بحيث لا يمكن تخزينها في ذاكرة التخزين المؤقت. الحدّ الأقصى لحجم النتائج المحسوبة هو 100 ميغابايت، وهذا الحدّ ينطبق على مستوى النظام.

حدود استيراد الجداول

يتم توضيح الحدود القصوى لتحميل الجداول في دليل استيراد بيانات الجدول.

حجم حمولة الطلب

يقتصر حجم طلب البحث الواحد في Earth Engine على 10 ميغابايت. لا يتم تجاوز هذا الحدّ عادةً إلا عند تضمين جزء كبير من البيانات الإضافية مباشرةً في طلب البحث، مثل ملف Shapefile أو بنية GeoJSON تم تضمينها في طلب البحث. بدلاً من ذلك، يجب تحميل هذه العناصر وتحويلها إلى مادة عرض FeatureCollection، والإشارة إليها باستخدام رقم تعريف مادة العرض.

طول قائمة انتظار المهام

تشكّل المهام التي تنتظر جدولة (في الحالة READY) "قائمة انتظار المهام". يمكن أن يتضمّن كل مشروع 3,000 مهمة كحدّ أقصى. وهذا يعني أنّه لا يمكن أن يتجاوز عدد المهام 3,000 مهمة في الحالة READY.

الحدود القصوى لحصة دوال الصور النقطية في BigQuery

تنطبق الحصص التالية على طلبات البيانات من Earth Engine من خلال BigQuery، مثلاً عند استخدام دالة SQL ST_REGIONSTATS.

نوع الحصة القيمة التلقائية (لكل مشروع)
وقت فتحة BigQuery في اليوم ‫1,260,000 ثانية لكلّ فترة زمنية (350 ساعة لكلّ فترة زمنية)

وقت فتحة BigQuery في اليوم

حصة وقت الخانة في اليوم في BigQuery هي حصة مخصّصة تتيح لك الحدّ من مقدار وقت الخانة الذي يُسمح لوظائف BigQuery النقطية باستهلاكه على Earth Engine في يوم معيّن لمشروع معيّن. تتراكم الحصة اليومية من إجمالي الوقت المستغرَق في جميع طلبات البحث، حتى تلك التي يتعذّر تنفيذها. يمكنك الاطّلاع على الحصة في Cloud Console ضمن مقياس earthengine.googleapis.com/bigquery_slot_usage_time، ويمكن لمشرف الحصة تعديل القيمة بالزيادة أو النقصان. لزيادة القيمة عن القيمة التلقائية، أنشئ طلبًا لزيادة الحصة، وسيتمّ الموافقة عليه تلقائيًا. من المفترض أن يسري التغيير في غضون 10 دقائق.

في حال تجاوز هذه الحصة، سيعرض 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 إلى أن تتم إعادة ضبط الحصة في اليوم التالي أو إلى أن يزيد أحد المشرفين الحدّ الأقصى.