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