الوضع الأصلي: الحصص والحدود

تصف هذه الصفحة حصص الطلبات وحدود إصدار المؤسسة في Cloud Firestore في الوضع الأصلي.

استخدام الفئة المجانية

يوفّر Cloud Firestore في الوضع الأصلي فئة مجانية تتيح لك البدء في استخدام Cloud Firestore في الوضع الأصلي بدون أي تكلفة. تظهر مبالغ الفئة المجانية في الجدول التالي.

يتم تطبيق مبالغ الفئة المجانية يوميًا وإعادة ضبطها في منتصف الليل بتوقيت المحيط الهادي.

لا تنطبق الفئة المجانية إلا على قاعدة بيانات واحدة Cloud Firestore لكل مشروع. ستحصل أول قاعدة بيانات يتم إنشاؤها في مشروع بدون قاعدة بيانات ضمن الفئة المجانية على الفئة المجانية. إذا تم حذف قاعدة البيانات التي تم تطبيق الفئة المجانية عليها، ستتلقّى قاعدة البيانات التالية التي يتم إنشاؤها الفئة المجانية.

الفئة المجانية الحصة
البيانات المخزّنة 1 غيغابايت
وحدات القراءة 50,000 في اليوم
وحدات التعديل في الوقت الفعلي 50,000 في اليوم
وحدات الكتابة 40,000 في اليوم
نقل البيانات الصادرة 10 غيغابايت في الشهر

الحدود العادية

تعرض الجداول التالية الحدود التي تنطبق على Cloud Firestore في الوضع الأصلي. هذه الحدود ثابتة ما لم يُذكر خلاف ذلك.

قواعد البيانات

الحدّ التفاصيل
الحدّ الأقصى لعدد قواعد البيانات لكل مشروع

100

يمكنك التواصل مع فريق الدعم لطلب زيادة هذا الحدّ.

الحدّ الأقصى لعدد قواعد بيانات مفاتيح الترميز المُدارة للعميل (CMEK) لكل مشروع

0

تكون الحصة تلقائيًا 0 لأنّ هذه الميزة متاحة فقط للمستخدمين المدرَجين في قائمة السماح. يمكنك طلب زيادة الحصة من خلال ملء نموذج طلب الوصول إلى CMEK.

المجموعات والمستندات والحقول

الحدّ التفاصيل
القيود المفروضة على أرقام تعريف المجموعات
  • يجب أن تتضمّن أحرف UTF-8 صالحة
  • يجب ألا يزيد طولها عن 1,500 بايت
  • يجب ألا تحتوي على شرطة مائلة للأمام (/)
  • يجب ألا تتألّف فقط من نقطة واحدة (.) أو نقطتَين (..)
  • يجب ألا تتطابق مع التعبير العادي __.*__
الحدّ الأقصى لعمق المجموعات الفرعية 100
القيود المفروضة على أرقام تعريف المستندات
  • يجب أن تتضمّن أحرف UTF-8 صالحة
  • يجب ألا يزيد طولها عن 1,500 بايت
  • يجب ألا تحتوي على شرطة مائلة للأمام (/)
  • يجب ألا تتألّف فقط من نقطة واحدة (.) أو نقطتَين (..)
  • يجب ألا تتطابق مع التعبير العادي __.*__
  • إذا استوردت كيانات Datastore إلى قاعدة بيانات Firestore، يتم عرض أرقام تعريف الكيانات الرقمية على النحو التالي: __id[0-9]+__
الحدّ الأقصى لحجم اسم المستند 6 كيلوبايت
الحدّ الأقصى لحجم المستند 1 ميغابايت (1,048,576 بايت)
القيود المفروضة على أسماء الحقول
  • يجب أن تتضمّن أحرف UTF-8 صالحة
  • يجب ألا تتطابق مع التعبير العادي __.*__
الحدّ الأقصى لحجم اسم الحقل 1,500 بايت
القيود المفروضة على مسارات الحقول
  • يجب فصل أسماء الحقول بنقطة واحدة (.)
  • يمكن تمريرها كسلسلة من الشرائح مفصولة بنقطة (.)، حيث تكون كل شريحة إما اسم حقل بسيط أو اسم حقل بين علامتَي اقتباس (محدّد أدناه).
اسم الحقل البسيط هو الاسم الذي تنطبق عليه جميع الشروط التالية:
  • يحتوي فقط على الأحرف a-z، A-Z، 0-9، والشرطة السفلية (_)
  • لا يبدأ بالأرقام 0-9
يبدأ اسم الحقل بين علامتَي اقتباس وينتهي بعلامة النبرة العكسية (`). على سبيل المثال، foo.`x&y` يشير إلى الحقل x&y المتداخل ضمن الحقل foo. لإنشاء اسم حقل يتضمّن علامة النبرة العكسية، يجب إلغاء علامة النبرة العكسية باستخدام علامة الشرطة المائلة للخلف (\). لتسهيل الأمر، يمكنك تجنُّب أسماء الحقول بين علامتَي اقتباس من خلال تمرير مسار الحقل ككائن FieldPath (على سبيل المثال، اطّلِع على JavaScript FieldPath).
الحدّ الأقصى لحجم مسار الحقل 1,500 بايت
الحدّ الأقصى لحجم قيمة الحقل 1 ميغابايت - 89 بايت (1,048,487 بايت)
الحدّ الأقصى لعمق الحقول في الخريطة أو الصفيف

20

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


{
  nested_map: {         #depth 1
    nested_array: [     #depth 2
      {
        foo: "bar"      #depth 3
      }
    ]
  }
}

عمليات الكتابة والمعاملات

الحدّ التفاصيل
الحدّ الأقصى لحجم طلب بيانات من واجهة برمجة التطبيقات 10 ميغابايت
المهلة المحدّدة للمعاملة 270 ثانية، مع مهلة انتهاء صلاحية في حال عدم النشاط تبلغ 60 ثانية
الحدّ الأقصى لعدد عمليات تحويل الحقول التي يمكن إجراؤها على مستند واحد في عملية Commit أو في معاملة 500

المؤشرات

الحدّ التفاصيل
الحدّ الأقصى لعدد المؤشرات لقاعدة بيانات

  • 200 عندما لا تكون الفوترة مفعّلة لمشروعك Google Cloud

    إذا كنت بحاجة إلى حصة أكبر، عليك تفعيل الفوترة لمشروعك Google Cloud.

  • 1,000 عند تفعيل الفوترة لمشروعك Google Cloud

    يمكنك التواصل مع فريق الدعم لطلب زيادة هذا الحدّ.

الحدّ الأقصى لعدد إدخالات المؤشر لكل مستند

40,000
الحدّ الأقصى لعدد الحقول في المؤشر 100
الحدّ الأقصى لحجم إدخال المؤشر

7.5 كيلوبايت
الحدّ الأقصى لمجموع أحجام إدخالات المؤشر لمستند

8 ميغابايت

مدة البقاء (TTL)

الحدّ التفاصيل
الحدّ الأقصى لعدد إعدادات الحقل الواحد لقاعدة بيانات

  • 200 عندما لا تكون الفوترة مفعّلة لمشروعك Google Cloud

    إذا كنت بحاجة إلى حصة أكبر، عليك تفعيل الفوترة لمشروعك Google Cloud.

  • 1,000 عند تفعيل الفوترة لمشروعك على Google Cloud

يمكن أن يحتوي إعداد مستوى حقل واحد على إعدادات متعددة للحقل نفسه. على سبيل المثال، يتم احتساب الإعفاء من الفهرسة لحقل واحد وسياسة مدة البقاء (TTL) على الحقل نفسه كإعداد حقل واحد ضمن الحدّ.

تصدير/استيراد

تنطبق الحدود التالية على عمليات الاستيراد والتصدير المُدارة:

الحدّ التفاصيل
الحدّ الأقصى لإجمالي عدد طلبات التصدير والاستيراد المسموح بها لمشروع في الدقيقة 20
الحدّ الأقصى لعدد عمليات التصدير والاستيراد المتزامنة 50
الحدّ الأقصى لعدد فلاتر أرقام تعريف المجموعات لطلبات التصدير والاستيراد 100

قواعد الأمان

الحدّ التفاصيل
الحدّ الأقصى لعدد استدعاءات exists() وget() وgetAfter() لكل طلب
  • 10 لطلبات المستندات الفردية وطلبات البحث

  • 20 لعمليات قراءة المستندات المتعددة والمعاملات، وعمليات الكتابة المجمّعة ينطبق الحدّ السابق البالغ 10 أيضًا على كل عملية.

    على سبيل المثال، لنفترض أنّك تنشئ طلب كتابة مجمّعة يتضمّن 3 عمليات كتابة وأنّ قواعد الأمان تستخدم استدعاءَين للوصول إلى المستند للتحقّق من صحة كل عملية كتابة. في هذه الحالة، تستخدم كل عملية كتابة استدعاءَين من أصل 10 استدعاءات وصول، ويستخدم طلب الكتابة المجمّعة 6 استدعاءات من أصل 20 استدعاء وصول.

يؤدي تجاوز أي من الحدّين إلى ظهور خطأ "تم رفض الإذن".

قد يتم تخزين بعض استدعاءات الوصول إلى المستند مؤقتًا، ولا يتم احتساب الاستدعاءات المخزّنة مؤقتًا ضمن الحدّين.
الحدّ الأقصى لعمق عبارة match المتداخلة 10
الحدّ الأقصى لطول المسار، بوحدات المسار، المسموح به ضمن مجموعة من عبارات match المتداخلة 100
الحدّ الأقصى لعدد متغيرات التقاط المسار المسموح بها ضمن مجموعة من عبارات match المتداخلة 20
الحدّ الأقصى لعمق استدعاء الدالة 20
الحدّ الأقصى لعدد وسيطات الدالة 7
الحدّ الأقصى لعدد روابط متغيرات let لكل دالة 10
الحدّ الأقصى لعدد استدعاءات الدالة المتكررة أو الدورية 0 (غير مسموح)
الحدّ الأقصى لعدد التعبيرات التي يتم تقييمها لكل طلب 1,000
الحدّ الأقصى لحجم مجموعة القواعد يجب أن تلتزم مجموعات القواعد بحدّين للحجم:
  • حدّ يبلغ 256 كيلوبايت لحجم مصدر نص مجموعة القواعد المنشور من Firebase console أو من واجهة سطر الأوامر باستخدام firebase deploy.
  • حدّ يبلغ 250 كيلوبايت لحجم مجموعة القواعد المُجمَّعة التي تنتج عندما تعالج Firebase المصدر وتفعّله على الخلفية.