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

توضّح هذه الصفحة حجم التخزين للمستندات وأسماء المستندات والحقول وإدخالات الفهرس في Cloud Firestore.

حجم السلسلة

يتم احتساب أحجام السلاسل على أنّها عدد وحدات البايت بترميز UTF-8 + 1.

يتم تخزين ما يلي كسلاسل:

• أرقام تعريف المجموعات
• معرّفات المستندات من النوع String
• أسماء المستندات
• أسماء الحقول
• قيم حقول السلسلة

على سبيل المثال:

• يستخدم معرّف المجموعة tasks 5 بايت + 1 بايت، أي ما مجموعه 6 بايت.
• يستخدم اسم الحقل description 11 بايت + 1 بايت، أي ما مجموعه 12 بايت.

حجم معرّف المستند

يبلغ حجم معرّف المستند إما حجم السلسلة لمعرّف السلسلة أو 8 بايت لمعرّف العدد الصحيح.

حجم اسم المستند

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

• حجم كل معرّف مجموعة ومعرّف مستند في مسار المستند
• 16 بايت إضافية

بالنسبة إلى مستند في المجموعة الفرعية users/jeff/tasks مع معرّف مستند سلسلة my_task_id، يبلغ حجم اسم المستند 6 + 5 + 6 + 11 + 16 = 44 بايت:

• ‫6 بايتات لمعرّف المجموعة users
• ‫5 بايتات لمعرّف المستند jeff
• ‫6 بايتات لمعرّف المجموعة tasks
• ‫11 بايت لمعرّف المستند my_task_id
• 16 بايت إضافية

حجم قيمة الحقل

يوضّح الجدول التالي حجم قيم الحقول حسب النوع.

على سبيل المثال، سيستخدم حقل منطقي باسم done 6 بايتات:

• ‫5 بايتات لاسم الحقل done
• بايت واحد للقيمة المنطقية

حجم المستند

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

• حجم اسم المستند
• مجموع حجم السلسلة لكل اسم حقل
• مجموع حجم كل قيمة حقل
• ‫32 بايت إضافية

هذا المثال مخصّص لمستند في المجموعة الفرعية users/jeff/tasks مع معرّف مستند من النوع "سلسلة" بقيمة my_task_id:

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

يبلغ إجمالي حجم الحقول 71 بايت:

إذًا، حجم المستند هو 44 + 71 + 32 = 147 بايت:

• ‫44 بايت لاسم المستند
• ‫71 بايت للحقول
• ‫32 بايت إضافية

حجم إدخال الفهرس

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

حجم إدخال الفهرس ذي الحقل الواحد

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

نطاق جمع البيانات

حجم الإدخال في فهرس حقل واحد بنطاق المجموعة هو مجموع ما يلي:

• حجم اسم المستند الذي تمت فهرسته
• حجم اسم المستند للمستند الأصلي للمستند المفهرس
• حجم السلسلة لاسم الحقل المفهرَس
• حجم قيمة الحقل المفهرَس
• ‫32 بايت إضافية

لنفترض أنّ لديك مستندًا في المجموعة الفرعية users/jeff/tasks برقم تعريف مستند من النوع سلسلة قيمته my_task_id:

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

بالنسبة إلى فهرس حقل واحد بنطاق مجموعة يفهرس الحقل done، يبلغ الحجم الإجمالي للإدخال في هذا الفهرس 109 بايت:

• ‫44 بايت لاسم المستند users/jeff/tasks/my_task_id
• ‫27 بايت لاسم مستند المستند الرئيسي users/jeff
• ‫5 بايتات لاسم الحقل done
• بايت واحد لقيمة الحقل المنطقي
• ‫32 بايت إضافية

نطاق حزمة المجموعات

حجم الإدخال في فهرس حقل واحد بنطاق مجموعة المجموعة هو مجموع ما يلي:

• حجم اسم المستند الذي تمت فهرسته
• حجم السلسلة لاسم الحقل المفهرَس
• حجم قيمة الحقل المفهرَس
• 48 بايت إضافيًا

لنفترض أنّ لديك مستندًا في المجموعة الفرعية users/jeff/tasks برقم تعريف مستند من النوع سلسلة قيمته my_task_id:

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

بالنسبة إلى فهرس حقل واحد بنطاق حزمة المجموعات الذي يفهرس الحقل done، يبلغ الحجم الإجمالي للإدخال في هذا الفهرس 98 بايت:

• ‫44 بايت لاسم المستند users/jeff/tasks/my_task_id
• ‫5 بايتات لاسم الحقل done
• بايت واحد لقيمة الحقل المنطقي
• 48 بايت إضافيًا

حجم إدخال الفهرس المركّب

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

نطاق جمع البيانات

حجم إدخال الفهرس في فهرس مركّب بنطاق المجموعة هو مجموع ما يلي:

• حجم اسم المستند الذي تمت فهرسته
• حجم اسم المستند للمستند الأصلي للمستند المفهرس
• مجموع قيم الحقل المفهرسة
• ‫32 بايت إضافية

لنفترض أنّ لديك مستندًا في المجموعة الفرعية users/jeff/tasks برقم تعريف مستند من النوع سلسلة قيمته my_task_id:

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

بالنسبة إلى فهرس مركّب بنطاق مجموعة يفهرس الحقلين done وpriority (كلاهما تصاعدي)، يبلغ الحجم الإجمالي للإدخال في هذا الفهرس 112 بايت:

• ‫44 بايت لاسم المستند users/jeff/tasks/my_task_id
• ‫27 بايت لاسم مستند المستند الرئيسي users/jeff
• بايت واحد لقيمة الحقل المنطقي
• 8 بايت لقيمة حقل العدد الصحيح
• ‫32 بايت إضافية

نطاق حزمة المجموعات

حجم إدخال الفهرس في فهرس مركّب بنطاق حزمة المجموعات هو مجموع ما يلي:

• حجم اسم المستند الذي تمت فهرسته
• مجموع قيم الحقل المفهرسة
• ‫32 بايت إضافية

لنفترض أنّ لديك مستندًا في المجموعة الفرعية users/jeff/tasks برقم تعريف مستند من النوع سلسلة قيمته my_task_id:

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

بالنسبة إلى فهرس مركّب بنطاق مجموعة مجموعات يضع الفهرس للحقلَين done وpriority (كلاهما تصاعدي)، يبلغ الحجم الإجمالي لإدخال الفهرس في هذا الفهرس 85 بايت:

• ‫44 بايت لاسم المستند users/jeff/tasks/my_task_id
• بايت واحد لقيمة الحقل المنطقي
• 8 بايت لقيمة حقل العدد الصحيح
• ‫32 بايت إضافية

حجم إدخال فهرس البحث النصي

حجم إدخال فهرس البحث النصي في الفهرس هو مجموع ما يلي:

• حجم السلسلة لاسم المجموعة
• حجم قيمة معرّف المستند
• مجموع وحدات البايت من قيم الحقول المفهرسة (x2)
• ‫48 بايت إضافية للبيانات الوصفية العامة

إليك مثال على حدث إدراج لمستند يحمل رقم تعريف المستند my_task_id في المجموعة tasks:

يبلغ إجمالي حجم إدخال فهرس البحث النصي على description 105 بايت استنادًا إلى ما يلي:

• ‫6 بايتات لاسم المجموعة tasks
• ‫11 بايت لقيمة رقم تعريف المستند
• ‫44 بايت، استنادًا إلى 22 بايت للحقل description مضروبًا في 2
• ‫48 بايت إضافية للبيانات الوصفية العامة

حجم إدخال الفهرس الجغرافي المكاني

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

• حجم السلسلة لاسم المجموعة
• حجم قيمة معرّف المستند
• ‫128 بايت لكل نقطة جغرافية مفهرسة
• ‫48 بايت إضافية للبيانات الوصفية العامة

إليك مثال على حدث إدراج لمستند يحمل رقم تعريف المستند my_place في المجموعة places:

{
     "type": "Restaurant",
     "visited": false,
     "priority": 1,
     "location": GeoPoint(longitude, latitude)
}

يبلغ إجمالي حجم إدخال فهرس جغرافي مكاني على location 192 بايت استنادًا إلى ما يلي:

• ‫7 بايتات لاسم المجموعة places
• ‫9 بايت لمعرّف المستند
• ‫128 بايت لحقل location
• ‫48 بايت إضافية للبيانات الوصفية العامة

الخطوات التالية