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

توضّح هذه الصفحة حصص الطلبات وحدود إصدار Enterprise من Cloud Firestore في "الوضع الأصلي".

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

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

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

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

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

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

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

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

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

100

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

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

0

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

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

الحدّ التفاصيل
القيود المفروضة على أرقام تعريف المجموعات
  • يجب أن تكون أحرف 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 (على سبيل المثال، اطّلِع على FieldPath في JavaScript).
الحد الأقصى لحجم مسار الحقل ‫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

الفهارس

الحدّ التفاصيل
الحد الأقصى لعدد الفهارس لقاعدة بيانات

الحد الأقصى لعدد إدخالات الفهرس لكل مستند

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

‫7.5 كيلوبايت
الحد الأقصى لمجموع أحجام إدخالات فهرس المستند

‫8 ميبيبايت

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

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

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

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

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

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

قواعد الأمان

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

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

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

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

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