فهم الفوترة في 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. استخدِم لوحة البيانات لقياس معدّل استخدامك على مدار فترات زمنية مختلفة.