استخدم هذا الدليل لفهم حدود Cloud Firestore ، واطلع على أسعار Cloud Firestore للحصول على شرح كامل ومفصل لتكاليف Cloud Firestore ، بما في ذلك الأشياء التي يجب الانتباه إليها.
راقب استخدامك
لمراقبة استخدام Cloud Firestore ، افتح علامة التبويب Cloud Firestore Usage في وحدة تحكم Firebase. استخدم لوحة القيادة لقياس استخدامك خلال فترات زمنية مختلفة.
استخدام مفصل في Google Cloud Console
عند إنشاء مشروع Firebase ، فأنت تقوم أيضًا بإنشاء مشروع Google Cloud. حصص Cloud Firestore API وصفحات App Engine Quotas في Google Cloud Console تتبع معلومات استخدام Cloud Firestore والحصص.
حصة مجانية
يقدم Cloud Firestore حصة مجانية تتيح لك البدء بدون تكلفة. كميات الحصة المجانية مذكورة أدناه. إذا كنت بحاجة إلى المزيد من الحصة ، يجب عليك تمكين الفوترة لمشروع Cloud Platform الخاص بك .
يتم تطبيق الحصص يوميًا ويتم إعادة تعيينها في منتصف الليل بتوقيت المحيط الهادئ تقريبًا.
| الطبقة المجانية | حصة نسبية |
|---|---|
| بيانات مخزنه | 1 جيجا بايت |
| يقرأ المستند | 50000 في اليوم |
| وثيقة يكتب | 20،000 في اليوم |
| يحذف المستند | 20،000 في اليوم |
| خروج الشبكة | 10 جيجا بايت في الشهر |
الحدود القياسية
توضح الجداول التالية الحدود التي تنطبق على Cloud Firestore. هذه حدود صارمة ما لم يذكر خلاف ذلك.
المجموعات والمستندات والحقول
| حد | تفاصيل |
|---|---|
| القيود على معرفات المجموعة |
|
| أقصى عمق للمجموعات الفرعية | 100 |
| القيود على معرفات المستندات |
|
| الحجم الأقصى لاسم الوثيقة | 6 كيلوبايت |
| الحجم الأقصى للمستند | 1 ميجابايت (1،048،576 بايت) |
| القيود على أسماء الحقول | يجب أن تكون أحرف UTF-8 صالحة |
| الحجم الأقصى لاسم الحقل | 1500 بايت |
| القيود على المسارات الميدانية |
|
| الحجم الأقصى لمسار الحقل | 1500 بايت |
| الحجم الأقصى لقيمة الحقل | 1 ميجابايت - 89 بايت (1،048،487 بايت) |
| أقصى عمق للحقول في الخريطة أو المصفوفة | 20 |
يكتب والمعاملات
بالإضافة إلى هذه الحدود ، يجب أن ترى أيضًا أفضل الممارسات لتصميم الحجم .
| حد | تفاصيل |
|---|---|
| الحد الأقصى لحجم طلب API | 10 ميغا بايت |
الحد الأقصى لعدد تحويلات الحقول التي يمكن إجراؤها على مستند واحد في عملية Commit أو في معاملة | 500 |
| المهلة الزمنية للمعاملة | 270 ثانية ، مع وقت انتهاء صلاحية خامل يبلغ 60 ثانية |
حدود ناعمة
لا يمنعك Cloud Firestore من تجاوز العتبات أدناه ، ولكن القيام بذلك يؤثر على الأداء.
| حد ضعيف | تفاصيل |
|---|---|
| الحد الأقصى لمعدل الكتابة لمجموعة تحتوي فيها المستندات على قيم متسلسلة في حقل مفهرس | 500 في الثانية |
فهارس
تنطبق الحدود التالية على الفهارس أحادية المجال والفهارس المركبة :
| حد | تفاصيل |
|---|---|
| الحد الأقصى لعدد الفهارس المركبة لقاعدة بيانات | 200 يمكنك الاتصال بالدعم لطلب زيادة إلى هذا الحد. |
| الحد الأقصى لعدد تكوينات الحقل الفردي لقاعدة بيانات | 200 يُسمح بإجمالي 200 تكوين على مستوى الحقل. يمكن أن يحتوي تكوين حقل واحد على تكوينات متعددة لنفس الحقل. على سبيل المثال ، يتم احتساب استثناء فهرسة الحقل الفردي وسياسة TTL في نفس الحقل كتكوين حقل واحد نحو الحد الأقصى. |
الحد الأقصى لعدد مدخلات الفهرس لكل مستند | 40000 عدد إدخالات الفهرس هو مجموع ما يلي للمستند:
لمعرفة كيفية تحويل Cloud Firestore مستندًا ومجموعة من الفهارس إلى مدخلات فهرس ، راجع مثال عدد مدخلات الفهرس هذا . |
| الحد الأقصى لعدد الحقول في فهرس مركب | 100 |
| الحجم الأقصى لمدخل الفهرس | 7.5 كيلوبايت لمعرفة كيفية حساب Cloud Firestore لحجم إدخال الفهرس ، راجع حجم إدخال الفهرس . |
| الحد الأقصى لمجموع أحجام مدخلات فهرس المستند | 8 ميغا بايت الحجم الإجمالي هو مجموع ما يلي للمستند: |
| الحجم الأقصى لقيمة حقل مفهرس | 1500 بايت يتم قطع قيم الحقول التي تزيد عن 1500 بايت. قد تُرجع الاستعلامات التي تتضمن قيم حقول مبتورة نتائج غير متناسقة. |
مدة البقاء (TTL)
| حد | تفاصيل |
|---|---|
| الحد الأقصى لعدد تكوينات الحقل الفردي لقاعدة بيانات | 200 يُسمح بإجمالي 200 تكوين على مستوى الحقل. يمكن أن يحتوي تكوين حقل واحد على تكوينات متعددة لنفس الحقل. على سبيل المثال ، يتم احتساب استثناء فهرسة الحقل الفردي وسياسة TTL في نفس الحقل كتكوين حقل واحد نحو الحد الأقصى. |
الاستيراد والتصدير
تنطبق الحدود التالية على عمليات الاستيراد والتصدير المُدارة :
| حد | تفاصيل |
|---|---|
| أقصى عدد مسموح به لكل من طلبات التصدير والاستيراد لمشروع ما في الدقيقة | 20 |
| العدد الأقصى للصادرات والواردات المتزامنة | 50 |
| العدد الأقصى لفلاتر معرف المجموعة لطلبات التصدير والاستيراد | 100 |
قواعد الأمان
| حد | تفاصيل |
|---|---|
الحد الأقصى لعدد المكالمات exists() ، get() ، و getAfter() لكل طلب |
يؤدي تجاوز أي من الحدين إلى خطأ رفض الإذن. قد يتم تخزين بعض مكالمات الوصول إلى المستندات مؤقتًا ، ولا يتم احتساب المكالمات المخزنة مؤقتًا ضمن الحدود. |
أقصى عمق بيان match متداخلة | 10 |
أقصى طول للمسار ، في مقاطع المسار ، مسموح به ضمن مجموعة من عبارات match المتداخلة | 100 |
الحد الأقصى لعدد متغيرات التقاط المسار المسموح بها ضمن مجموعة من عبارات match المتداخلة | 20 |
| الحد الأقصى لعمق استدعاء الوظيفة | 20 |
| العدد الأقصى لوسائط الدوال | 7 |
الحد الأقصى لعدد الروابط let المتغيرة لكل وظيفة | 10 |
| الحد الأقصى لعدد استدعاءات الدوال المتكررة أو الدورية | 0 (غير مسموح به) |
| تم تقييم الحد الأقصى لعدد التعبيرات لكل طلب | 1،000 |
| الحجم الأقصى لمجموعة القواعد | يجب أن تلتزم القواعد بحدود حجم:
|
إدارة الإنفاق
للمساعدة في تجنب الرسوم غير المتوقعة في فاتورتك ، قم بتعيين ميزانيات وتنبيهات شهرية.
ضع ميزانية شهرية
لتتبع تكاليف Cloud Firestore الخاصة بك ، قم بإنشاء ميزانية شهرية في Google Cloud Console. لن تحد الميزانيات من استخدامك ، ولكن يمكنك تعيين تنبيهات لإعلامك عندما تقترب من التكاليف المخطط لها للشهر أو تتجاوزها.
لتعيين ميزانية ، انتقل إلى قسم الفوترة في Google Cloud Console وأنشئ ميزانية لحساب Cloud Billing الخاص بك. يمكنك استخدام إعدادات التنبيه الافتراضية أو تعديل التنبيهات لإرسال إشعارات بنسب مختلفة من ميزانيتك الشهرية.
تعرف على المزيد حول إعداد الميزانيات وتنبيهات الميزانية .
ضع حدًا للإنفاق اليومي
لوضع حد أقصى لاستخدام Cloud Firestore ، عيّن حدًا للإنفاق اليومي من خلال App Engine. يسمح لك App Engine بتعيين حد إنفاق يومي على الموارد المرتبطة بـ App Engine ، بما في ذلك Cloud Firestore. لا ينطبق حد App Engine على أي من منتجات Firebase الأخرى.