| ينطبق ذلك على إصدار Cloud Firestore Enterprise فقط. |
تتضمّن هذه الصفحة أمثلة على كيفية احتساب وحدات الفوترة في بعض السيناريوهات الأكثر شيوعًا. يُرجى العِلم أنّ كل طلب بحث قد يختلف في البيانات التي تتم معالجتها استنادًا إلى عوامل مثل خطة طلب البحث وشكل البيانات والفهارس المتاحة.
ننصحك باستخدام ميزة شرح الاستعلام لفهم تكلفة وأداء استعلاماتك المحدّدة بشكل أفضل.
عمليات القراءة
تتضمّن معظم عمليات القراءة إما إجراء قراءة نقطية لمستند معيّن أو فحص مجموعة من البيانات استنادًا إلى معرّف. تستهلك عمليات القراءة وحدات القراءة. يتم احتساب وحدات القراءة على دفعات تبلغ 4 كيلوبايت. راجِع الأمثلة التالية.
قراءات ذات نقاط
مثال على الفوترة مقابل النقاط:
- قراءة نقطية لمستند واحد بحجم 1 كيلوبايت تستهلك: وحدة قراءة واحدة
- قراءة نقطة لمستند واحد بحجم 4 كيلوبايت تستهلك: وحدة قراءة واحدة
- قراءة نقطة لمستند واحد بحجم 1 ميغابايت الاستهلاك: 256 وحدة قراءة
- قراءة 100 مستند، حجم كل منها 1 كيلوبايت الاستهلاك: 100 وحدة قراءة
المسح
تتضمّن الأمثلة التالية سيناريوهات تفحص المستندات أو تفهرس الإدخالات.
مسح المستندات ضوئيًا
- طلب بحث يفحص 100 مستند، حجم كل منها 1 كيلوبايت. الاستهلاك: 25 وحدة قراءة
فهرسة عمليات المسح
تكون تكلفة الفحص، من حيث عدد وحدات البايت، هي نفسها بغض النظر عمّا إذا كان يتم فحص مستند أو فهرس. ومع ذلك، تكون إدخالات الفهرس غالبًا أصغر حجمًا. ونتيجةً لذلك، يمكن أن توفّر في كثير من الأحيان طريقة أكثر فعالية من حيث التكلفة لفحص البيانات.
- طلب بحث يفحص 100 إدخال في الفهرس، حجم كل منها 1 كيلوبايت تستهلك: 25 وحدة قراءة.
- طلب بحث يفحص 100 إدخال فهرس، كل منها 128 بايت. تستهلك: 4 وحدات قراءة.
الحد الأدنى لحجم المستند أو إدخال الفهرس
في بعض الحالات، قد لا يكون من الضروري قراءة محتوى مستند أو إدخال فهرس لتلبية طلب بحث. ويشمل ذلك طلبات البحث البسيطة الخاصة بالعدد، مثل حساب إجمالي عدد المستندات في مجموعة. في هذه الحالات، يتم تطبيق حد أدنى للتكلفة يبلغ 32 بايت لكل عنصر يتم فحصه.
- تحسب هذه الدالة عدد المستندات في مجموعة. يفحص طلب البحث 1,000 عنصر في المجموعة. تستهلك: 8 وحدات قراءة.
مزيج من عمليات المسح والقراءات النقطية
تنفّذ العديد من طلبات البحث مزيجًا من عمليات المسح والقراءة النقطية لتلبية عملية معيّنة.
- طلب بحث يفحص 128 إدخال فهرس، كل منها بحجم 256 بايت، وينفّذ عملية قراءة نقطية لـ 128 مستندًا، كل منها بحجم 4 كيلوبايت. يستهلك: 136 وحدة قراءة، ويتألف من:
- 128 وحدة قراءة لعمليات القراءة النقطية
- 8 وحدات قراءة لعمليات البحث في الفهرس
شرح الطلب
تساعدك ميزة شرح طلب البحث في فهم الطريقة التي تنفّذ بها قاعدة البيانات طلبات البحث. يمكن أن تساعدك التفاصيل المقدَّمة في تحسين طلبات البحث.
تنطبق التكاليف التالية عند استخدام Query Explain:
- Query Explain الذي ينفّذ طلب البحث: تنطبق تكلفة طلب البحث.
- Query Explain باستخدام خيار "الخطة فقط" تستهلك: وحدة قراءة واحدة (الحد الأدنى لتكلفة طلب البحث)
عمليات الكتابة
يتم تحصيل رسوم مقابل عمليات الكتابة (الإنشاء والتعديل والحذف) استنادًا إلى حجم المستندات والفهارس التي يتم إنشاؤها أو تعديلها أو حذفها أثناء العملية. تستهلك عمليات الكتابة وحدات الكتابة. يتم احتساب وحدات الكتابة على شكل شرائح بحجم 1 KiB.
لا تتكبّد عمليات الكتابة البسيطة، مثل التعديل حسب معرّف المستند، سوى تكلفة عمليات الكتابة. ستؤدي عمليات الكتابة التي تتطلّب تنفيذ استعلام لتلبية متطلبات العملية إلى تحمّل تكاليف القراءة المرتبطة بالاستعلام.
راجِع الأمثلة التالية.
إنشاء
- أنشئ مستندًا جديدًا بحجم 10 كيلوبايت بدون فهارس. الاستهلاك: 10 وحدات كتابة
- أنشئ مستندًا بحجم 1 كيلوبايت يتضمّن إدخال فهرس واحدًا بحجم 256 بايت في المجموعة. تستهلك: وحدتَي كتابة
التحديثات
- ابحث عن مستند بحجم 10 كيلوبايت باستخدام معرّف المستند وعدِّله بدون فهارس في المجموعة. الاستهلاك: 10 وحدات كتابة
- ابحث عن مستند بحجم 1 كيلوبايت حسب معرّف المستند وعدِّل حقلًا واحدًا باستخدام إدخال فهرس واحد بحجم 256 بايت. تستهلك: 3 وحدات كتابة. ملاحظة: يؤدي تعديل إدخال فهرس في هذه الحالة إلى استهلاك وحدتَي كتابة، واحدة للحذف وأخرى لإعادة إنشاء إدخال الفهرس.
- ابحث عن مستند بحجم 1 كيلوبايت باستخدام معرّف المستند بدون إجراء أي تعديل (بدون تغييرات). الاستهلاك: وحدة كتابة واحدة (الحد الأدنى لتكاليف الكتابة)
- طلب بحث عن جميع المستندات التي تبلغ سعتها 1 كيلوبايت في مجموعة، ما يؤدي إلى فحص 1, 000 مستند، وإدراج حقل جديد بسعة 256 بايت بدون فهارس في المجموعة: 1,000 وحدة قراءة و1, 000 وحدة كتابة
عمليات الحذف
- حذف مستند بحجم 1 كيلوبايت يحتوي على فهرس واحد في المجموعة تستهلك: وحدتَي كتابة
- احذف مستندًا بحجم 1 كيلوبايت ليس لديه فهارس في المجموعة. تستهلك: وحدة كتابة واحدة
إنشاء الفهارس
تفرض عملية إنشاء الفهرس رسومًا على إدخالات الفهرس التي تم إنشاؤها أو تعديلها أثناء عملية الإنشاء. يتم تكبّد هذه التكاليف في أي وقت تتم فيه إضافة تعريف فهرس أو إزالته. يتم تحصيل الرسوم من إدخالات الفهرس بشكل مماثل لعمليات الكتابة التي تتكبّد وحدة كتابة واحدة لكل 1 كيلوبايت.
- أنشئ فهرسًا جديدًا لمجموعة تحتوي على 500 مستند، ويكون حجم كل إدخال في الفهرس 1 كيلوبايت. يستهلك 500 وحدة كتابة.
- حذف فهرس حالي لمجموعة تحتوي على 500 مستند، ويبلغ حجم كل إدخال فهرس تم حذفه 1 كيلوبايت. يستهلك 500 وحدة كتابة.