فهم الفوترة في Cloud Firestore

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يوضّح هذا المستند تفاصيل أسعار Cloud Firestore.

إذا كنت تدفع بعملة غير الدولار الأمريكي، سيتم تطبيق الأسعار المدرَجة بعملتك في رموز التخزين التعريفية لمنصّة السحابة الإلكترونية.

نظرة عامة على الأسعار

عند استخدام Cloud Firestore، يتم تحصيل رسوم منك مقابل ما يلي:

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

يتم احتساب استخدام مساحة التخزين وسعة النطاق بوحدة الغيبي بايت (GiB)، حيث يساوي 1 غيبي بايت 2³⁰ بايت. يتم تحصيل جميع الرسوم يوميًا.

تقدّم الأقسام التالية تفاصيل حول كيفية تحصيل الرسوم منك مقابل استخدام Cloud Firestore.

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

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

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

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

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

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

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

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

الأسعار حسب الموقع الجغرافي

يعرض الجدول التالي أسعار عمليات القراءة والكتابة والحذف والتخزين لكل موقع جغرافي في Cloud Firestore:

اختيار المناطق

إذا كنت تدفع بعملة غير الدولار الأمريكي، سيتم تطبيق الأسعار المدرَجة بعملتك في رموز التخزين التعريفية لمنصّة السحابة الإلكترونية.

لا تتوفّر حصة مجانية لقواعد البيانات المُعنوَنة.

لإنشاء قاعدة بيانات مُسمّاة (غير تلقائية)، عليك ترقية خطة فوترة مشروعك.

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

القراءة والكتابة والحذف

يتم تحصيل رسوم منك مقابل المستندات وإدخالات الفهرس التي تتم قراءتها لتلبية طلب بحث. يتم إعلامك بالرسوم التي يتم تحصيلها منك مقابل كل عملية كتابة وحذف مستند.

تكون رسوم عمليات الكتابة والحذف واضحة ومباشرة. بالنسبة إلى عمليات الكتابة، يتم احتساب كل عملية set أو update على أنّها عملية كتابة واحدة.

هناك بعض الصعوبات المتعلّقة بعمليات القراءة والتي يجب أخذها في الاعتبار. توضّح الأقسام التالية هذه الاختلافات الدقيقة بالتفصيل.

قراءة إدخال الفهرس

يتم تحصيل رسوم منك مقابل عملية قراءة واحدة لكل دفعة تضم ما يصل إلى 1000 إدخال فهرس يقرأها طلب بحث، باستثناء الحالات التالية:

• بالنسبة إلى طلبات البحث عن متجهات الجار الأقرب، يتم تحصيل رسوم عن عملية قراءة واحدة لكل دفعة تضم ما يصل إلى 100 إدخال في فهرس متجهات الجار الأقرب يقرأها طلب البحث.

  على سبيل المثال، إذا كان طلب البحث التالي باستخدام limit: 5 يعرض 5 مستندات ويقرأ 1550 إدخالًا في فهرس المتجهات kNN، يتم تحصيل رسوم منك مقابل 5 عمليات قراءة للمستندات المعروضة و16 عملية قراءة لإدخالات الفهرس:

  // Requires single-field vector index
  const vectorQuery: VectorQuery = db.collection('cities').findNearest('embedding_field', FieldValue.vector([3.0, 1.0, 2.0]), {
    limit: 5,
    distanceMeasure: 'EUCLIDEAN'
  });
  

• لا يتم تحصيل رسوم من طلبات البحث التي تحتوي على حقل نطاق واحد كحد أقصى مقابل إدخالات الفهرس التي تتم قراءة.

  على سبيل المثال، يحتوي طلب البحث التالي على حقل مساواة واحد (age) وحقل نطاق واحد (start_date) ولا يتم تحصيل رسوم مقابل إدخالات الفهرس التي يتم قراءتها:

  db.collection("employees").whereEqualTo("age", 35)
                            .whereGreaterThanOrEqualTo("start_date", new Date(2020, 1, 1))
  

  يحتوي طلب البحث التالي على حقلَي نطاق (age وstart_date) ويتم تحميله لإدخالات الفهرس على النحو التالي:

  db.collection("employees").whereGreaterThanOrEqualTo("age", 35)
                            .whereGreaterThanOrEqualTo("start_date", new Date(2020, 1, 1))
  

  يُعتبر الحقل الذي يظهر في عبارة order by حقلًا لنطاق عندما يكون هناك حقل نطاق واحد على الأقل في الاستعلام. لذلك، يحتوي طلب البحث التالي على حقلَي نطاق (age وstart_date) ويتم تحصيل رسوم مقابل عمليات قراءة إدخالات الفهرس:

  db.collection("employees").whereGreaterThanOrEqualTo("age", 35)
                            .orderBy("start_date")
  

  يُعتبر الحقل __name__ دائمًا حقل نطاق، حتى إذا كان يتم استخدامه فقط في فلتر المساواة. لذلك، يحتوي طلب البحث التالي على حقلَي ملف شخصي (age و__name__) ويتم تحصيل رسوم مقابل عمليات قراءة إدخالات الفهرس:

  db.collection("employees").whereIn("__name__", Arrays.asList("/employees/Alice", "/employees/Bob"))
                            .orderBy("age")
  

طلبات بحث التجميع

بالنسبة إلى طلبات البحث التجميعية مثل count() وsum() وavg()، يتم تحصيل رسوم منك مقابل إدخالات الفهرس التي يقرأها طلب البحث على النحو описан في الفقرة أعلاه. بالنسبة إلى طلبات البحث التجميعية التي تقرأ 0 إدخال في فهرس، يتم تحصيل رسوم بحد أدنى مقابل قراءة مستند واحد.

على سبيل المثال، يتم تحصيل رسوم مقابل قراءة مستند واحد في عمليات count() التي تقرأ بين 0 و1, 000 إدخال في الفهرس. بالنسبة إلى عملية count() التي تقرأ 1500 إدخال في الفهرس، يتم تحصيل رسوم منك مقابل قراءة مستندَين.

لمعرفة مزيد من المعلومات عن الفهارس المستخدَمة وإدخالات الفهرس المقروءة، استخدِم شرح الطلب.

الاستماع إلى نتائج طلبات البحث

يتيح لك Cloud Firestore سماع نتائج طلب بحث والحصول على آخر المعلومات في الوقت الفعلي عند تغيير نتائج طلب البحث.

عند الاستماع إلى نتائج طلب بحث، يتم تحصيل رسوم منك مقابل كل قراءة في كل مرة تتم فيها إضافة مستند إلى مجموعة النتائج أو تعديله. يتم أيضًا تحصيل رسوم منك مقابل عملية قراءة عندما تتم إزالة مستند من مجموعة النتائج بسبب اختلافه. (على عكس ذلك، عندما يتم حذف مستند، لا يتم تحصيل رسوم منك مقابل قراءة المستند).

تعتمد أيضًا فوترة المستمعين في حِزم تطوير البرامج (SDK) للأجهزة الجوّالة والويب على ما إذا كان الحفظ بلا إنترنت مفعّلاً أم لا:

• إذا كان الاحتفاظ بالبيانات بلا إنترنت مفعّلاً وانقطع اتصال المستمع عن الشبكة لمدة تزيد عن 30 دقيقة (على سبيل المثال، إذا انقطع اتصال المستخدم بالإنترنت)، سيتم تحصيل رسوم منك مقابل قراءة المستندات وإدخالات الفهرس كما لو كنت قد أرسلت طلب بحث جديدًا تمامًا.

• في حال إيقاف ميزة "الحفظ بلا إنترنت"، سيتم تحصيل رسوم منك مقابل المستندات وإدخالات ملف الوسيط التي تتم قراءتها كما لو كنت قد أرسلت طلب بحث جديدًا كلما انقطع اتصال العميل بالاستماع إلى البيانات ثم أعد الاتصال.

إدارة مجموعات النتائج الكبيرة

تتضمّن Cloud Firestore عدة ميزات لمساعدتك في إدارة طلبات البحث التي تؤدي إلى عرض عدد كبير من النتائج:

• المؤشرات التي تتيح لك استئناف استعلام يستغرق وقتًا طويلاً
• رموز الصفحات، التي تساعدك في تقسيم نتائج طلب البحث إلى صفحات.
• الحدود التي تحدّد عدد النتائج التي سيتم استرجاعها
• الموضع، الذي يتيح لك تخطّي عدد ثابت من المستندات

ما مِن تكاليف إضافية مقابل استخدام المؤشرات ورموز الصفحات والقيود. في الواقع، يمكن أن تساعدك هذه الميزات في توفير المال من خلال قراءة المستندات التي تحتاج إليها فقط.

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

طلبات البحث غير المتعلقة بقراءة المستندات

بالنسبة إلى طلبات البحث غير عمليات قراءة المستندات، مثل طلب الحصول على قائمة بعناوين ملف شخصي، يتم تحصيل رسوم منك مقابل قراءة مستند واحد. إذا كان جلب المجموعة الكاملة من النتائج يتطلّب أكثر من طلب واحد (على سبيل المثال، إذا كنت تستخدم التنقّل في الصفحات)، يتم تحصيل رسوم منك مرة واحدة لكل طلب.

الحد الأدنى للرسوم المرتبطة بطلبات البحث

يتم تحصيل رسوم قراءة مستند واحد على الأقل لكل طلب بحث تجريه، حتى إذا لم يعرض الطلب أي نتائج.

Cloud Firestore Security Rules

بالنسبة إلى مكتبات عملاء الويب والأجهزة الجوّالة، إذا كانت Cloud Firestore Security Rules تستخدم exists() أو get() أو getAfter() لقراءة مستند واحد أو أكثر من قاعدة بياناتك، يتم تحصيل رسوم منك مقابل عمليات القراءة الإضافية التالية:

• يتم تحصيل رسوم منك مقابل عمليات القراءة اللازمة لتقييم Cloud Firestore Security Rules.

  على سبيل المثال، إذا كانت قواعدك تشير إلى ثلاثة مستندات، ولكن على Cloud Firestore قراءة مستندَين فقط من هذه المستندات لتقييم قواعدك، سيتم تحصيل رسوم منك مقابل قراءة مستندَين إضافيَين للمستندات التابعة.

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

• يتم تحصيل رسوم تقييم القاعدة مرة واحدة فقط لكل طلب.

  ونتيجةً لذلك، قد يكون سعر قراءة مستندات متعددة أقل من قراءة المستندات واحدًا تلو الآخر، لأنّ قراءة مستندات متعددة تتطلّب عددًا أقل من الطلبات.

• عند الاستماع إلى نتائج طلب بحث، يتم تحصيل رسوم منك مقابل تقييم القاعدة في جميع الحالات التالية:

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

حجم مساحة تخزين قاعدة البيانات

يتم تحصيل رسوم منك مقابل كمية البيانات التي تخزّنها في Cloud Firestore، بما في ذلك النفقات العامة للتخزين. وتشمل المساحة المستخدَمة في عمليات التنفيذ غير الأساسية البيانات الوصفية والملفات التلقائية والفهارس المركبة.

يتطلّب كل مستند مخزّن في Cloud Firestore البيانات الوصفية التالية:

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

يتم احتساب تكاليف مساحة التخزين بالكيلوبايت لكل شهر ويتم احتسابها يوميًا. Cloud Firestore يقيس حجم قاعدة البيانات يوميًا. على مدار شهر، يتم احتساب متوسط نقاط العيّنات هذه لاحتساب حجم مساحة التخزين في قاعدة البيانات. ويتم ضرب هذه القيمة المتوسطة في سعر وحدة مساحة التخزين (غيغابايت في الشهر).

تعرَّف على كيفية احتساب مساحة التخزين Cloud Firestore في حجم مساحة التخزين عمليات الحساب.

بيانات PITR

في حال تفعيل ميزة PITR، يتم تحصيل رسوم منك مقابل تخزين بيانات PITR. سيلاحظ معظم العملاء أنّ التكلفة الإجمالية لتخزين بيانات PiTR مشابهة لتكلفة تخزين قاعدة البيانات.

يتم احتساب تكاليف مساحة التخزين لميزة "استرداد نقطة في الوقت" بوحدة غيغابايت في الشهر ويُحتسَب يوميًا. تقيس Cloud Firestore حجم قاعدة البيانات يوميًا. على مدار شهر، يتم احتساب متوسط نقاط العيّنات هذه لاحتساب حجم مساحة التخزين في قاعدة البيانات. ويتم ضرب هذه القيمة المتوسطة في سعر وحدة PITR (غيغا بايت في الشهر).

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

الحد الأدنى للفوترة: قد يتم تحصيل رسوم منك مقابل ما يصل إلى يوم واحد من تكلفة مساحة التخزين في PITR حتى إذا أوقفت ميزة PITR في غضون يوم واحد من تفعيلها.

عمليات الاحتفاظ بنسخة احتياطية من البيانات واستعادتها

في حال تفعيل ميزة الاحتفاظ بنسخة احتياطية، يتم تحصيل رسوم منك مقابل تخزين النُسخ الاحتياطية من قاعدة بياناتك. يساوي حجم مساحة التخزين للنسخة الاحتياطية حجم قاعدة البيانات عند أخذ النسخة الاحتياطية.

يتم احتساب تكاليف مساحة التخزين للنسخ الاحتياطية بوحدة غيغابايت في الشهر. على مدار شهر، يتم أيضًا حساب عدد الأيام التي يتم الاحتفاظ بكل نسخة احتياطية خلالها، مع احتساب المتوسط على مدار الشهر. يتم احتساب تكلفة كل نسخة احتياطية باستخدام حجم التخزين لملف النسخ الاحتياطي ومضاعفته بنسبة الشهر الذي يتم الاحتفاظ بالنسخة الاحتياطية فيه ومضاعفته بسعر الوحدة. يتم تحديد حدود اليوم حسب المنطقة الزمنية America/Los_Angeles لأغراض الفوترة.

عند إجراء عملية استرداد، يقيس Cloud Firestore حجم النسخة الاحتياطية لعملية الاسترداد. يتم ضرب حجم النسخة الاحتياطية بسعر وحدة عمليات الاستعادة (بوحدة غيغابايت).

شرح طلب البحث

يؤدي استخدام شرح طلبات البحث في Firestore إلى تحمُّل تكاليف.

عند شرح طلب بحث باستخدام الخيار التلقائي، لا يتم تنفيذ أي عمليات قراءة للفهرس. بغض النظر عن تعقيد طلب البحث، يتم تحصيل رسوم عملية قراءة واحدة.

عند شرح طلب بحث باستخدام خيار التحليل، يتم تنفيذ عمليات الفهرسة والقراءة، وبالتالي يتم تحصيل رسوم منك مقابل طلب البحث كالمعتاد. لا يتم تحصيل رسوم إضافية مقابل ميزة "الشرح والتحليل"، بل يتم تحصيل الرسوم المعتادة مقابل طلب البحث الذي يتم تنفيذه.

معدل نقل البيانات للشبكة

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

تحسب Cloud Firestore حجم الردّ استنادًا إلى تنسيق رسالة مُسلسل. لا يتم احتساب النفقات العامة للبروتوكول، مثل النفقات العامة لبروتوكول SSL، ضمن استخدام النطاق الترددي للشبكة. لا يتم احتساب الطلبات التي يرفضها Cloud Firestore Security Rules ضِمن استخدام معدل نقل البيانات في الشبكة.

لمعرفة مقدار النطاق الترددي الذي استخدمته للشبكة، يمكنك استخدام Google Cloud Console لتصدير بيانات الفواتير إلى ملف.

الأسعار العامة للشبكة

بالنسبة إلى الطلبات التي تأتي من Google Cloud Platform (على سبيل المثال، من تطبيق قيد التشغيل على Google Compute Engine)، يتم تحصيل الرسوم منك على النحو التالي:

نوع الزيارات	السعر
نقل البيانات الواردة	مجانًا
نقل البيانات داخل منطقة	مجانًا
نقل البيانات بين المناطق في المنطقة المتعددة نفسها	مجانًا
نقل البيانات بين المناطق داخل الولايات المتحدة (لكل غيغا بايت)	0.01 دولار أمريكي (أول 10 غيغابايت في الشهر مجانية)
نقل البيانات بين المناطق، باستثناء الزيارات بين مناطق الولايات المتحدة	معدلات نقل بيانات الإنترنت الصادرة من Google Cloud Platform

إذا كنت تدفع بعملة غير الدولار الأمريكي، سيتم تطبيق الأسعار المدرَجة بعملتك في رموز التخزين التعريفية لمنصّة السحابة الإلكترونية.

يخضع Cloud Firestore أيضًا لرسوم إضافية مقابل الخروج من الإنترنت في ما يلي:

• طلبات Google Cloud بين المناطق، باستثناء الزيارات بين مناطق الولايات المتحدة
• الطلبات الواردة من خارج Google Cloud (على سبيل المثال، من جهاز جوّال للمستخدم)

اطّلِع على Google Cloud تعرفات الخروج من الإنترنت.

الاطّلاع على مثال على الأسعار

للاطّلاع على كيفية تراكم تكاليف الفوترة في Cloud Firestore في نموذج تطبيق من العالم الواقعي، اطّلِع على مثال الفوترة في Cloud Firestore.

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

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

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