الاستخدام والحدود

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

مراقبة استخدامك

لمراقبة استخدامك لجهاز "Cloud Firestore"، افتح "Cloud Firestore". علامة تبويب الاستخدام في وحدة تحكُّم Firebase. استخدِم لوحة البيانات لقياس استخدامك الفترات الزمنية.

تفاصيل الاستخدام في وحدة تحكّم "Google Cloud"

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

الحصة المجانية

يوفّر Cloud Firestore حصة مجانية تتيح لك بدء استخدام قاعدة بيانات (default) بدون أي تكلفة. يتم إدراج مبالغ الحصص المجانية أدناه. إذا كنت بحاجة إلى حصة أكبر، عليك تفعيل الفوترة لمشروعك على "Google Cloud".

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

تكون قاعدة بيانات (default) فقط مؤهّلة للحصة المجانية.

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

لا تشمل العمليات والميزات التالية الاستخدام المجاني. يجب تفعيل الفوترة لاستخدام الميزات التالية:

  • استخدام قواعد بيانات مُسمّاة (غير تلقائية)
  • عمليات حذف مدة البقاء (TTL)
  • بيانات PITR
  • الاحتفاظ بنسخة احتياطية من البيانات
  • استعادة العمليات

لمزيد من المعلومات عن كيفية فوترة هذه الميزات، يُرجى الاطّلاع على أسعار مساحة التخزين:

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

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

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

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

100

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

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

الحدّ المسموح به التفاصيل
القيود المفروضة على أرقام تعريف المجموعات
  • يجب أن تكون أحرف 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 ثانية

المؤشرات

تنطبق الحدود التالية على الفهارس التي تتألف من حقل واحد والفهارس المركبة:

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

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

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

40,000

عدد إدخالات الفهرس هو مجموع ما يلي للمستند:

  • عدد إدخالات الفهرس ذات الحقل الواحد
  • عدد إدخالات الفهرس المركّبة

لمعرفة كيفية تحويل Cloud Firestore لمستند ومجموعة من الفهارس إلى إدخالات فهرس، اطّلِع على مثال عدد إدخالات الفهرس هذا.
الحد الأقصى لعدد الحقول في الفهرس المركب 100
الحد الأقصى لحجم إدخال الفهرس

7.5 كيبيبايت

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

‫8 ميبيبايت

الحجم الإجمالي هو مجموع ما يلي في أي مستند:

  • مجموع حجم إدخالات الفهرس ذات الحقل الواحد لمستند
  • مجموع حجم إدخالات الفهرس المركب للمستند
    		•
    الحد الأقصى لحجم قيمة حقل مفهرَس

    1500 بايت

    يتم اقتطاع قيم الحقول التي تزيد عن 1500 بايت. قد تعرِض طلبات البحث التي تتضمّن قيم حقول مقتطعة نتائج غير متّسقة.

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

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

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

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

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

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

    قواعد الأمان

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

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

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

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

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

    إدارة الإنفاق

    للمساعدة في تجنُّب تحصيل رسوم غير متوقعة من فاتورتك، يمكنك تحديد ميزانيات وتنبيهات شهرية.

    تحديد ميزانية شهرية

    لتتبُّع تكاليف Cloud Firestore، أنشئ ميزانية شهرية في وحدة تحكّم Google Cloud. لن تحدّ الميزانيات من استخدامك، ولكن يمكنك ضبط تنبيهات لتلقّي إشعارات عند اقتراب التكاليف المخطّط لها في الشهر أو تجاوزها.

    لضبط ميزانية، انتقِل إلى قسم الفوترة في وحدة تحكّم Google Cloud وأنشئ ميزانية لحسابك على Cloud Billing. يمكنك استخدام إعدادات التنبيهات التلقائية أو تعديل التنبيهات لإرسال إشعارات بنسبة مئوية مختلفة من ميزانيتك الشهرية.

    مزيد من المعلومات عن إعداد الميزانيات والتنبيهات المتعلّقة بالميزانية