يمكنك استخدام هذا الدليل لفهم حدود Cloud Firestore واطّلِع على أسعار Cloud Firestore للحصول على شرح مفصّل وكامل تكاليف Cloud Firestore، بما في ذلك العناصر التي يجب التنبّه لها
مراقبة استخدامك
لمراقبة استخدام Cloud Firestore، افتح Cloud Firestore علامة التبويب الاستخدام في وحدة تحكُّم Firebase. استخدِم لوحة البيانات لقياس استخدامك الفترات الزمنية.
تفاصيل الاستخدام في Google Cloud Console
عند إنشاء مشروع على Firebase، يتم أيضًا إنشاء مشروع على Google Cloud. تشير رسالة الأشكال البيانية حصص واجهة برمجة التطبيقات في Cloud Firestore أو حصص App Engine الصفحات في Google Cloud Console لتتبُّع استخدام Cloud Firestore وحصتها المعلومات.
الحصة المجانية
توفّر Cloud Firestore حصة مجانية تتيح لك بدء استخدام
بقاعدة بياناتك في (default)
بدون أي تكلفة. يتم إدراج مبالغ الحصص المجانية أدناه.
إذا كنت بحاجة إلى حصة أكبر، عليك تفعيل الفوترة لمشروعك على Google Cloud.
يتم تطبيق الحصص يوميًا، وتتم إعادة ضبطها قرابة منتصف الليل بتوقيت المحيط الهادئ.
تكون قاعدة بيانات (default)
فقط مؤهّلة للحصة المجانية.
الفئة المجانية | الحصة |
---|---|
البيانات المخزنة | 1 غيبي بايت |
قراءة المستند | 50.000 في اليوم |
عمليات كتابة المستند | 20.000 في اليوم |
عمليات حذف المستندات | 20000 في اليوم |
نقل البيانات الصادرة | 10 غيبي بايت في الشهر |
لا تشمل العمليات والميزات التالية الاستخدام المجاني. يجب تفعيل الفوترة لاستخدام الميزات التالية:
- استخدام قواعد البيانات المسماة (غير الافتراضية)
- عمليات حذف مدة البقاء (TTL)
- بيانات PITR
- الاحتفاظ بنسخة احتياطية من البيانات
- عمليات الاستعادة
لمزيد من المعلومات عن كيفية فوترة هذه الميزات، يُرجى الاطّلاع على أسعار مساحة التخزين:
الحدود العادية
تعرض الجداول التالية الحدود التي تنطبق على Cloud Firestore. وهذه حدود صارمة ما لم يُذكر خلاف ذلك.
قواعد البيانات
الحدّ المسموح به | التفاصيل |
---|---|
الحد الأقصى لعدد قواعد البيانات لكل مشروع |
100 يمكنك التواصل مع فريق الدعم أن يطلب زيادة هذا الحد. |
المجموعات والمستندات والحقول
الحدّ المسموح به | التفاصيل |
---|---|
القيود المفروضة على أرقام تعريف المجموعات |
|
الحد الأقصى لعمق المجموعات الفرعية | 100 |
القيود المفروضة على معرّفات المستندات |
|
الحد الأقصى لحجم اسم المستند | 6 كيبيبايت |
الحد الأقصى لحجم المستند | 1 مبيبايت (1,048,576 بايت) |
القيود المفروضة على أسماء الحقول | يجب أن تكون أحرف UTF-8 صالحة. |
الحد الأقصى لحجم اسم الحقل | 1,500 بايت |
القيود على مسارات الحقول |
` ). على سبيل المثال، تشير foo.`x&y` إلى الحقل x&y المتداخل ضمن الحقل foo . لإنشاء اسم حقل باستخدام حرف الفاصلة العليا المائلة، يمكنك الهروب من حرف الفاصلة العليا المائلة بحرف الشرطة المائلة للخلف (\ ). ولتسهيل الأمر، يمكنك تجنُّب أسماء الحقول ذات علامات الاقتباس من خلال تمرير مسار الحقل ككائن FieldPath (على سبيل المثال، راجع JavaScript FieldPath).
|
الحد الأقصى لحجم مسار الحقل | 1,500 بايت |
الحد الأقصى لحجم قيمة الحقل | 1 مبيبايت إلى 89 بايت (1,048,487 بايت) |
الحد الأقصى لعمق الحقول في خريطة أو مصفوفة | 20 تضيف حقول الخريطة والصفيف مستوى واحدًا إلى العمق الكلي لكائن. على سبيل المثال، يتألف العمق الإجمالي للكائن التالي من ثلاثة مستويات:
|
عمليات الكتابة والمعاملات
بالإضافة إلى هذه الحدود، ينبغي أن تشاهد أيضًا أفضل الممارسات للتصميم على نطاق واسع.
الحدّ المسموح به | التفاصيل |
---|---|
الحد الأقصى لحجم طلب البيانات من واجهة برمجة التطبيقات | 10 مبيبايت |
الحدّ الزمني لإجراء معاملة | 270 ثانية، مع مدة انتهاء صلاحية غير نشطة تبلغ 60 ثانية |
المؤشرات
تنطبق الحدود التالية على فهارس الحقل الواحد والفهارس المركّبة:
الحدّ المسموح به | التفاصيل |
---|---|
الحد الأقصى لعدد الفهارس المركبة لقاعدة بيانات |
|
الحد الأقصى لعدد عمليات ضبط الحقل الواحد لقاعدة بيانات |
ضبط على مستوى حقل واحد يمكن أن يحتوي على تكوينات متعددة لنفس الحقل. على سبيل المثال: الإعفاء من الفهرسة ذات الحقل الواحد وسياسة TTL في الحقل نفسه احتسابه كإعداد لحقل واحد ضمن الحدّ الأقصى. |
الحد الأقصى لعدد إدخالات الفهرس لكل مستند |
40,000 عدد إدخالات الفهرس هو مجموع ما يلي في أي مستند:
لمعرفة كيف تقوم Cloud Firestore بتحويل مستند ومجموعة من الفهارس إلى إدخالات فهرس، فراجع هذا المثال على عدد إدخالات الفهرس. |
الحد الأقصى لعدد الحقول في الفهرس المركب | 100 |
الحد الأقصى لحجم إدخال فهرس |
7.5 كيبيبايت لمعرفة طريقة احتساب Cloud Firestore لحجم إدخال الفهرس، يُرجى الاطّلاع على حجم إدخال الفهرس. |
الحد الأقصى لمجموع أحجام إدخالات الفهرس في المستند |
8 مبيبايت الحجم الإجمالي هو مجموع ما يلي في أي مستند: |
الحد الأقصى لحجم قيمة حقل مفهرس |
1500 بايت يتم اقتطاع قيم الحقول التي تزيد عن 1500 بايت. طلبات البحث التي تتضمن قد تؤدي قيم الحقول المقتطعة إلى عرض نتائج غير متسقة. |
مدة البقاء (TTL)
الحدّ المسموح به | التفاصيل |
---|---|
الحد الأقصى لعدد عمليات ضبط الحقل الواحد لقاعدة بيانات |
ضبط على مستوى حقل واحد يمكن أن يحتوي على تكوينات متعددة لنفس الحقل. على سبيل المثال: الإعفاء من الفهرسة ذات الحقل الواحد وسياسة TTL في الحقل نفسه احتسابه كإعداد لحقل واحد ضمن الحدّ الأقصى. |
تصدير/استيراد
تنطبق الحدود التالية على عمليات الاستيراد والتصدير المُدارة:
الحدّ المسموح به | التفاصيل |
---|---|
الحدّ الأقصى لإجمالي عدد طلبات التصدير والاستيراد لمشروع مسموح به في الدقيقة | 20 |
الحد الأقصى لعدد عمليات التصدير وعمليات الاستيراد المتزامنة | 50 |
الحدّ الأقصى لعدد فلاتر أرقام تعريف المجموعة لطلبات التصدير والاستيراد | 100 |
قواعد الأمان
الحدّ المسموح به | التفاصيل |
---|---|
الحد الأقصى لعدد المكالمات: exists() وget() وgetAfter() لكل طلب |
يؤدي تجاوز أي من هذين الحدّين إلى ظهور خطأ "تم رفض الإذن". قد يتم تخزين بعض مكالمات الوصول إلى المستندات مؤقتًا، ولن يتم احتساب الاتصالات المخزنة مؤقتًا ضمن الحدود المسموح بها. |
الحد الأقصى لعمق عبارة match المتداخلة |
10 |
الحد الأقصى لطول المسار، في أجزاء المسار، مسموح به ضمن مجموعة من المسارات المتداخلة
match كشف حساب |
100 |
الحد الأقصى لعدد متغيرات التقاط المسارات المسموح بها ضمن مجموعة من
عبارات match مدمَجة |
20 |
الحد الأقصى لعمق استدعاء الدالة | 20 |
الحد الأقصى لعدد وسيطات الدوال | 7 |
الحد الأقصى لعدد عمليات ربط المتغيّرات let لكل دالة |
10 |
الحد الأقصى لعدد طلبات الدوال التكرارية أو الدورية | 0 (غير مسموح به) |
الحد الأقصى لعدد التعبيرات التي تم تقييمها لكل طلب | 1,000 |
الحد الأقصى لحجم مجموعة القواعد | يجب أن تمتثل القواعد لحدين للحجم:
|
إدارة الإنفاق
للمساعدة في تجنُّب تحصيل رسوم غير متوقعة من فاتورتك، يمكنك تحديد ميزانيات وتنبيهات شهرية.
تحديد ميزانية شهرية
لتتبع تكاليف Cloud Firestore، يمكنك إنشاء ميزانية شهرية في وحدة تحكُّم Google Cloud. لن تحدّ الميزانيات من استخدامك، ولكن يمكنك ضبط التنبيهات على إعلامك عند اقترابك من التكاليف المخطّط لها أو تجاوزها شهر.
لضبط ميزانية، يُرجى الانتقال إلى صفحة الفوترة. في Google Cloud Console وإنشاء ميزانية حساب فوترة Cloud. ويمكنك استخدام إعدادات التنبيهات التلقائية أو تعديل لإرسال الإشعارات بنسب مئوية مختلفة من ميزانيتك الشهرية.
مزيد من المعلومات حول إعداد تنبيهات الميزانيات وتنبيهات الميزانية