Cloud Firestore هي قاعدة بيانات مستندية مستندة إلى NoSQL. وعلى عكس قاعدة بيانات SQL، لا تتضمّن أيّ جداول أو صفوف. بدلاً من ذلك، يمكنك تخزين البيانات في مستندات يتم تنظيمها في مجموعات.
يحتوي كل مستند على مجموعة من أزواج المفاتيح والقيم. Cloud Firestore هو مُحسَّن لتخزين مجموعات كبيرة من المستندات الصغيرة.
يجب تخزين جميع المستندات في مجموعات. يمكن أن تحتوي المستندات على مجموعات فرعية وعناصر متداخلة، ويمكن أن تتضمّن كلتا المجموعتَين حقولًا أساسية مثل السلاسل أو عناصر معقدة مثل القوائم.
يتم إنشاء المجموعات والمستندات بشكل ضمني في Cloud Firestore. ما عليك سوى إسناد البيانات إلى مستند ضمن مجموعة. إذا لم تكن المجموعة أو المستند متوفّرَين، تنشئ Cloud Firestore المجموعة أو المستند.
المستندات
في Cloud Firestore، تكون وحدة التخزين هي المستند. المستند هو سجلّ خفيف يحتوي على حقول ترتبط بالقيم. يتم تحديد كل مستند باسم.
قد يبدو المستند الذي يمثل المستخدم alovelace
على النحو التالي:
alovelace
first : "Ada"
last : "Lovelace"
born : 1815
تُعرف الكائنات المعقدة والمُدمجة في المستند باسم الخرائط. على سبيل المثال، يمكنك هيكلة اسم المستخدم من المثال أعلاه باستخدام خريطة، كما يلي:
alovelace
name :
first : "Ada"
last : "Lovelace"
born : 1815
قد تلاحظ أنّ المستندات تشبه إلى حد كبير ملفات JSON. في الواقع، هذا هو الحال. هناك بعض الاختلافات (على سبيل المثال، تتيح المستندات أنواع بيانات إضافية و يكون حجمها محدودًا بـ 1 ميغابايت)، ولكن بشكل عام، يمكنك التعامل مع المستندات على أنّها سجلّات JSON خفيفة الوزن.
المجموعات
يتم تخزين المستندات في مجموعات، وهي ببساطة حاويات للمستندات. على سبيل المثال، يمكن أن يكون لديك مجموعة users
تحتوي على المستخدمين المختلفين، وكل واحد منهم يمثّل مستندًا:
مستخدم
alovelace
first : "Ada"
last : "Lovelace"
born : 1815
في الجولة
first : "Alan"
last : "Turing"
born : 1912
Cloud Firestore لا يتضمّن مخطّطًا، لذا لديك حرية كاملة في تحديد الحقول التي تضعها في كل مستند وأنواع البيانات التي تخزّنها في هذه الحقول. يمكن أن تحتوي جميع المستندات ضمن المجموعة نفسها على حقول مختلفة أو تخزِّن أنواعًا مختلفة من البيانات في هذه الحقول. ومع ذلك، من المستحسن استخدام الحقول وأنواع البيانات نفسها في عدة مستندات، حتى تتمكّن من إجراء استعلامات عن المستندات بسهولة أكبر.
تحتوي المجموعة على مستندات ولا شيء آخر. ولا يمكن أن تحتوي مباشرةً على ملف شخصي حاوي على قيم، ولا يمكن أن تحتوي على مجموعات أخرى. (اطّلِع على البيانات الهيكلية للحصول على شرح حول كيفية تنظيم data أكثر تعقيدًا في Cloud Firestore.)
تكون أسماء المستندات ضمن مجموعة فريدة. يمكنك تقديم مفاتيح خاصة بك، مثل أرقام تعريف المستخدمين، أو يمكنك السماح لـ Cloud Firestore بإنشاء أرقام تعريف عشوائية نيابةً عنك تلقائيًا.
لست بحاجة إلى "إنشاء" مجموعات أو "حذفها". بعد إنشاء الوثيقة الأولى في مجموعة، تصبح المجموعة متوفّرة. إذا حذفت كل الاطّلاع على المحتوى في الروابط. المستندات في مجموعة، لن تعود متوفّرة.
المراجع
يتم تحديد كل مستند في Cloud Firestore بشكل فريد من خلال موقعه داخل قاعدة البيانات. عرض المثال السابق المستند alovelace
ضمن
المجموعة users
. للإشارة إلى هذا الموقع في الرمز الخاص بك، يمكنك إنشاء مرجع له.
Web
import { doc } from "firebase/firestore"; const alovelaceDocumentRef = doc(db, 'users', 'alovelace');
Web
var alovelaceDocumentRef = db.collection('users').doc('alovelace');
Swift
let alovelaceDocumentRef = db.collection("users").document("alovelace")
Objective-C
FIRDocumentReference *alovelaceDocumentRef = [[self.db collectionWithPath:@"users"] documentWithPath:@"alovelace"];
Kotlin+KTX
val alovelaceDocumentRef = db.collection("users").document("alovelace")
Java
DocumentReference alovelaceDocumentRef = db.collection("users").document("alovelace");
Dart
final alovelaceDocumentRef = db.collection("users").doc("alovelace");
جافا
Python
Python
C++
DocumentReference alovelace_document_reference = db->Collection("users").Document("alovelace");
Node.js
انتقال
PHP
PHP
لمزيد من المعلومات عن تثبيت برنامج Cloud Firestore وإنشائه، يُرجى الاطّلاع على مكتبات العميل في Cloud Firestore.
Unity
DocumentReference documentRef = db.Collection("users").Document("alovelace");
#C
#C
لمزيد من المعلومات عن تثبيت برنامج Cloud Firestore وإنشائه، يُرجى الاطّلاع على مكتبات العميل في Cloud Firestore.
لغة Ruby
المرجع هو عنصر خفيف الوزن يشير إلى موقع في قاعدة بياناتك. ويمكنك إنشاء مرجع سواء كانت البيانات موجودة أم لا، ولا يؤدي إنشاء مرجع إلى تنفيذ أي من عمليات الشبكة.
يمكنك أيضًا إنشاء إشارات إلى المجموعات:
Web
import { collection } from "firebase/firestore"; const usersCollectionRef = collection(db, 'users');
Web
var usersCollectionRef = db.collection('users');
Swift
let usersCollectionRef = db.collection("users")
Objective-C
FIRCollectionReference *usersCollectionRef = [self.db collectionWithPath:@"users"];
Kotlin+KTX
val usersCollectionRef = db.collection("users")
Java
CollectionReference usersCollectionRef = db.collection("users");
Dart
final usersCollectionRef = db.collection("users");
جافا
Python
Python
C++
CollectionReference users_collection_reference = db->Collection("users");
Node.js
انتقال
PHP
PHP
لمزيد من المعلومات عن تثبيت وإنشاء عملاء Cloud Firestore، يُرجى الرجوع إلى مكتبات عملاء Cloud Firestore.
Unity
CollectionReference collectionRef = db.Collection("users");
#C
#C
لمزيد من المعلومات عن تثبيت وإنشاء عملاء Cloud Firestore، يُرجى الرجوع إلى مكتبات عملاء Cloud Firestore.
لغة Ruby
ولتسهيل الأمر، يمكنك أيضًا إنشاء مراجع عن طريق تحديد المسار إلى مستند أو مجموعة كسلسلة، مع فصل مكونات المسار بشرطة مائلة للأمام (/
). على سبيل المثال، لإنشاء مرجع إلى مستند alovelace
:
Web
import { doc } from "firebase/firestore"; const alovelaceDocumentRef = doc(db, 'users/alovelace');
Web
var alovelaceDocumentRef = db.doc('users/alovelace');
Swift
let aLovelaceDocumentReference = db.document("users/alovelace")
Objective-C
FIRDocumentReference *aLovelaceDocumentReference = [self.db documentWithPath:@"users/alovelace"];
Kotlin+KTX
val alovelaceDocumentRef = db.document("users/alovelace")
Java
DocumentReference alovelaceDocumentRef = db.document("users/alovelace");
Dart
final aLovelaceDocRef = db.doc("users/alovelace");
جافا
Python
Python
C++
DocumentReference alovelace_document = db->Document("users/alovelace");
Node.js
انتقال
PHP
PHP
لمزيد من المعلومات عن تثبيت وإنشاء عملاء Cloud Firestore، يُرجى الرجوع إلى مكتبات عملاء Cloud Firestore.
Unity
DocumentReference documentRef = db.Document("users/alovelace");
#C
#C
لمزيد من المعلومات عن تثبيت وإنشاء عملاء Cloud Firestore، يُرجى الرجوع إلى مكتبات عملاء Cloud Firestore.
لغة Ruby
البيانات الهرمية
لفهم آلية عمل هياكل البيانات التسلسلية في Cloud Firestore، نأخذ مثالاً على تطبيق محادثة يتضمّن رسائل وغرف محادثة.
يمكنك إنشاء مجموعة باسم rooms
لتخزين غرف المحادثات المختلفة:
غرفة
غرفة واحدة (
) أname : "my chat room"
غرفة ب
...
الآن بعد أن أصبح لديك غرف محادثة، يمكنك تحديد كيفية تخزين رسائلك. قد لا تريد تخزينها في مستند غرفة المحادثة. يجب أن تكون المستندات في Cloud Firestore خفيفة الوزن، ويمكن أن تحتوي غرفة المحادثة على عدد كبير من الرسائل. ومع ذلك، يمكنك إنشاء مجموعات إضافية في مستند غرفة المحادثة، كمجموعات فرعية.
المجموعات الفرعية
إنّ أفضل طريقة لتخزين الرسائل في هذا السيناريو هي استخدام المجموعات الفرعية. تشكل المجموعة الفرعية مجموعة مرتبطة بمستند معيّن.
يمكنك إنشاء مجموعة فرعية باسم messages
لكل مستند غرفة في
مجموعة rooms
:
غرفة
غرفة أ
name : "my chat room"
الرسائل
رسالة1
from : "alex"
msg : "Hello World!"
message2
...
غرفة واحدة (
)...
في هذا المثال، يمكنك إنشاء مرجع إلى رسالة في المجموعة الفرعية بالتعليمة البرمجية التالية:
Web
import { doc } from "firebase/firestore"; const messageRef = doc(db, "rooms", "roomA", "messages", "message1");
Web
var messageRef = db.collection('rooms').doc('roomA') .collection('messages').doc('message1');
Swift
let messageRef = db .collection("rooms").document("roomA") .collection("messages").document("message1")
Objective-C
FIRDocumentReference *messageRef = [[[[self.db collectionWithPath:@"rooms"] documentWithPath:@"roomA"] collectionWithPath:@"messages"] documentWithPath:@"message1"];
Kotlin+KTX
val messageRef = db .collection("rooms").document("roomA") .collection("messages").document("message1")
Java
DocumentReference messageRef = db .collection("rooms").document("roomA") .collection("messages").document("message1");
Dart
final messageRef = db .collection("rooms") .doc("roomA") .collection("messages") .doc("message1");
جافا
Python
Python
C++
DocumentReference message_reference = db->Collection("rooms") .Document("roomA") .Collection("messages") .Document("message1");
Node.js
انتقال
PHP
PHP
لمزيد من المعلومات عن تثبيت برنامج Cloud Firestore وإنشائه، يُرجى الاطّلاع على مكتبات العميل في Cloud Firestore.
Unity
DocumentReference documentRef = db .Collection("Rooms").Document("RoomA") .Collection("Messages").Document("Message1");
#C
#C
لمزيد من المعلومات عن تثبيت وإنشاء عملاء Cloud Firestore، يُرجى الرجوع إلى مكتبات عملاء Cloud Firestore.
لغة Ruby
لاحظ النمط المتناوب للمجموعات والمستندات. يجب أن تتّبع مجموعاتك ومستنداتك هذا النمط دائمًا. لا يمكنك الإشارة إلى مجموعة في مجموعة أو مستند في مستند.
تسمح لك المجموعات الفرعية بتنظيم البيانات بشكل هرمي، ما يسهّل
الوصول إلى البيانات. للحصول على جميع الرسائل في roomA
، يمكنك إنشاء مرجع مجموعة
للمجموعة الفرعية messages
والتفاعل معه كما تتفاعل مع أي مرجع مجموعة
آخر.
يمكن أن تحتوي المستندات في المجموعات الفرعية على مجموعات فرعية أيضًا، ما يتيح لك تداخل البيانات بشكل أكبر. يمكنك دمج البيانات حتى 100 مستوى.