نموذج بيانات Cloud Firestore

‫Cloud Firestore هي قاعدة بيانات NoSQL تعتمد على المستندات. على عكس قاعدة بيانات SQL، لا توجد جداول أو صفوف. بدلاً من ذلك، يتم تخزين البيانات في مستندات يتم تنظيمها في مجموعات.

يحتوي كل مستند على مجموعة من أزواج المفاتيح والقيم. تم تحسين Cloud Firestore لتخزين مجموعات كبيرة من المستندات الصغيرة.

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

يتم إنشاء المجموعات والمستندات ضمنيًا في Cloud Firestore. ما عليك سوى تخصيص البيانات لمستند ضمن مجموعة. إذا لم تكن المجموعة أو المستند متوفّرَين، تنشئهما Cloud Firestore.

المستندات

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

قد يبدو المستند الذي يمثّل المستخدم alovelace على النحو التالي:

• ‫class alovelace

  first : "Ada"
last : "Lovelace"
born : 1815
  

يُطلق على العناصر المعقّدة والمتداخلة في المستند اسم "الخرائط". على سبيل المثال، يمكنك هيكلة اسم المستخدم من المثال أعلاه باستخدام خريطة، مثل هذا:

• ‫class alovelace

  name :
    first : "Ada"
    last : "Lovelace"
born : 1815
  

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

المجموعات

توجد المستندات في مجموعات، وهي ببساطة حاويات للمستندات. على سبيل المثال، يمكنك إنشاء مجموعة users لتضمين المستخدمين المختلفين، ويمثّل كل مستخدم مستندًا:

• collections_bookmark مستخدم

  • ‫class alovelace

    first : "Ada"
last : "Lovelace"
born : 1815
    

  • ‫class في انتظار الردّ

    first : "Alan"
last : "Turing"
born : 1912
    

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

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

تكون أسماء المستندات ضمن المجموعة فريدة. يمكنك تقديم مفاتيحك الخاصة، مثل أرقام تعريف المستخدمين، أو يمكنك السماح لـ "Cloud Firestore" بإنشاء أرقام تعريف عشوائية لك تلقائيًا.

لست بحاجة إلى "إنشاء" مجموعات أو "حذفها". بعد إنشاء المستند الأول في مجموعة، تصبح المجموعة موجودة. إذا حذفت جميع المستندات في مجموعة، لن تعود المجموعة موجودة.

المراجع

يتم تحديد كل مستند في "Cloud Firestore" بشكل فريد من خلال موقعه ضمن قاعدة البيانات. أظهر المثال السابق مستندًا alovelace ضمن المجموعة users. للإشارة إلى هذا الموقع في الرمز البرمجي، يمكنك إنشاء مرجع له.

import { doc } from "firebase/firestore";

const alovelaceDocumentRef = doc(db, 'users', 'alovelace');
doc_reference.js

var alovelaceDocumentRef = db.collection('users').doc('alovelace');
test.firestore.js

let alovelaceDocumentRef = db.collection("users").document("alovelace")
ViewController.swift

FIRDocumentReference *alovelaceDocumentRef =
    [[self.db collectionWithPath:@"users"] documentWithPath:@"alovelace"];
ViewController.m

val alovelaceDocumentRef = db.collection("users").document("alovelace")
DocSnippets.kt

DocumentReference alovelaceDocumentRef = db.collection("users").document("alovelace");
DocSnippets.java

final alovelaceDocumentRef = db.collection("users").doc("alovelace");
firestore.dart

// Reference to a document with id "alovelace" in the collection "users"
DocumentReference document = db.collection("users").document("alovelace");
References.java

a_lovelace_ref = db.collection("users").document("alovelace")
snippets.py

a_lovelace_ref = db.collection("users").document("alovelace")
snippets.py

DocumentReference alovelace_document_reference =
    db->Collection("users").Document("alovelace");
snippets.cpp

const alovelaceDocumentRef = db.collection('users').doc('alovelace');
index.js

import (
	"cloud.google.com/go/firestore"
)

func createDocReference(client *firestore.Client) {

	alovelaceRef := client.Collection("users").Doc("alovelace")

	_ = alovelaceRef
}
retrieve_data_reference_document.go

$document = $db->collection('samples/php/users')->document('alovelace');
data_reference_document.php

DocumentReference documentRef = db.Collection("users").Document("alovelace");

DocumentReference documentRef = db.Collection("users").Document("alovelace");
Program.cs

document_ref = firestore.col("users").doc("alovelace")
data_model.rb

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

يمكنك أيضًا إنشاء مراجع للمجموعات:

import { collection } from "firebase/firestore";

const usersCollectionRef = collection(db, 'users');
collection_reference.js

var usersCollectionRef = db.collection('users');
test.firestore.js

let usersCollectionRef = db.collection("users")
ViewController.swift

FIRCollectionReference *usersCollectionRef = [self.db collectionWithPath:@"users"];
ViewController.m

val usersCollectionRef = db.collection("users")
DocSnippets.kt

CollectionReference usersCollectionRef = db.collection("users");
DocSnippets.java

final usersCollectionRef = db.collection("users");
firestore.dart

// Reference to the collection "users"
CollectionReference collection = db.collection("users");
References.java

users_ref = db.collection("users")
snippets.py

users_ref = db.collection("users")
snippets.py

CollectionReference users_collection_reference = db->Collection("users");
snippets.cpp

const usersCollectionRef = db.collection('users');
index.js

import (
	"cloud.google.com/go/firestore"
)

func createCollectionReference(client *firestore.Client) {
	usersRef := client.Collection("users")

	_ = usersRef
}
retrieve_data_reference_collection.go

$collection = $db->collection('samples/php/users');
data_reference_collection.php

CollectionReference collectionRef = db.Collection("users");

CollectionReference collectionRef = db.Collection("users");
Program.cs

collection_ref = firestore.col "users"
data_model.rb

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

import { doc } from "firebase/firestore"; 

const alovelaceDocumentRef = doc(db, 'users/alovelace');
doc_reference_alternative.js

var alovelaceDocumentRef = db.doc('users/alovelace');
test.firestore.js

let aLovelaceDocumentReference = db.document("users/alovelace")
ViewController.swift

FIRDocumentReference *aLovelaceDocumentReference =
    [self.db documentWithPath:@"users/alovelace"];
ViewController.m

val alovelaceDocumentRef = db.document("users/alovelace")
DocSnippets.kt

DocumentReference alovelaceDocumentRef = db.document("users/alovelace");
DocSnippets.java

final aLovelaceDocRef = db.doc("users/alovelace");
firestore.dart

// Reference to a document with id "alovelace" in the collection "users"
DocumentReference document = db.document("users/alovelace");
References.java

a_lovelace_ref = db.document("users/alovelace")
snippets.py

a_lovelace_ref = db.document("users/alovelace")
snippets.py

DocumentReference alovelace_document = db->Document("users/alovelace");
snippets.cpp

const alovelaceDocumentRef = db.doc('users/alovelace');
index.js

import (
	"cloud.google.com/go/firestore"
)

func createDocReferenceFromString(client *firestore.Client) {
	// Reference to a document with id "alovelace" in the collection "users"
	alovelaceRef := client.Doc("users/alovelace")

	_ = alovelaceRef
}
retrieve_data_reference_document_path.go

$document = $db->document('users/alovelace');
data_reference_document_path.php

DocumentReference documentRef = db.Document("users/alovelace");

DocumentReference documentRef = db.Document("users/alovelace");
Program.cs

document_path_ref = firestore.doc "users/alovelace"
data_model.rb

البيانات الهرمية

لفهم طريقة عمل بُنى البيانات الهرمية في Cloud Firestore، لنفترض أنّ لدينا تطبيق محادثات يتضمّن رسائل وغرف محادثة.

يمكنك إنشاء مجموعة باسم rooms لتخزين غرف محادثة مختلفة:

• collections_bookmark غرفة

  • class roomA

    name : "my chat room"
    

  • class غرفة

    ...
    

بعد إنشاء غرف المحادثة، عليك تحديد كيفية تخزين رسائلك. قد لا ترغب في تخزينها في مستند غرفة المحادثة. يجب أن تكون المستندات في Cloud Firestore خفيفة، ويمكن أن تحتوي غرفة المحادثة على عدد كبير من الرسائل. ومع ذلك، يمكنك إنشاء مجموعات إضافية داخل مستند غرفة المحادثة، كمجموعات فرعية.

المجموعات الفرعية

أفضل طريقة لتخزين الرسائل في هذا السيناريو هي استخدام المجموعات الفرعية. المجموعة الفرعية هي مجموعة مرتبطة بمستند معيّن.

يمكنك إنشاء مجموعة فرعية باسم messages لكل مستند غرفة في مجموعة rooms:

• collections_bookmark غرفة

  • class roomA

    name : "my chat room"
    

    • ‫collections_bookmark رسالة

      • class message1

        from : "alex"
msg : "Hello World!"
        

      • class message2

        ...
        

  • class غرفة

    ...
    

في هذا المثال، يمكنك إنشاء مرجع لرسالة في المجموعة الفرعية باستخدام الرمز التالي:

import { doc } from "firebase/firestore"; 

const messageRef = doc(db, "rooms", "roomA", "messages", "message1");
subcollection_reference.js

var messageRef = db.collection('rooms').doc('roomA')
                .collection('messages').doc('message1');
test.firestore.js

let messageRef = db
  .collection("rooms").document("roomA")
  .collection("messages").document("message1")
ViewController.swift

FIRDocumentReference *messageRef =
    [[[[self.db collectionWithPath:@"rooms"] documentWithPath:@"roomA"]
    collectionWithPath:@"messages"] documentWithPath:@"message1"];
ViewController.m

val messageRef = db
    .collection("rooms").document("roomA")
    .collection("messages").document("message1")
DocSnippets.kt

DocumentReference messageRef = db
        .collection("rooms").document("roomA")
        .collection("messages").document("message1");
DocSnippets.java

final messageRef = db
    .collection("rooms")
    .doc("roomA")
    .collection("messages")
    .doc("message1");
firestore.dart

// Reference to a document in subcollection "messages"
DocumentReference document =
    db.collection("rooms").document("roomA").collection("messages").document("message1");
References.java

room_a_ref = db.collection("rooms").document("roomA")
message_ref = room_a_ref.collection("messages").document("message1")
snippets.py

room_a_ref = db.collection("rooms").document("roomA")
message_ref = room_a_ref.collection("messages").document("message1")
snippets.py

DocumentReference message_reference = db->Collection("rooms")
    .Document("roomA")
    .Collection("messages")
    .Document("message1");
snippets.cpp

const messageRef = db.collection('rooms').doc('roomA')
  .collection('messages').doc('message1');
index.js

import (
	"cloud.google.com/go/firestore"
)

func createSubcollectionReference(client *firestore.Client) {
	messageRef := client.Collection("rooms").Doc("roomA").
		Collection("messages").Doc("message1")

	_ = messageRef
}
retrieve_data_reference_subcollection.go

$document = $db
    ->collection('rooms')
    ->document('roomA')
    ->collection('messages')
    ->document('message1');
data_reference_subcollection.php

DocumentReference documentRef = db
	.Collection("Rooms").Document("RoomA")
	.Collection("Messages").Document("Message1");

DocumentReference documentRef = db
    .Collection("Rooms").Document("RoomA")
    .Collection("Messages").Document("Message1");
Program.cs

message_ref = firestore.col("rooms").doc("roomA").col("messages").doc("message1")
data_model.rb

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

تتيح لك المجموعات الفرعية تنظيم البيانات بشكل هرمي، ما يسهّل الوصول إليها. للحصول على جميع الرسائل في roomA، يمكنك إنشاء مرجع مجموعة للمجموعة الفرعية messages والتفاعل معها مثل أي مرجع مجموعة آخر.

يمكن أن تحتوي المستندات في المجموعات الفرعية على مجموعات فرعية أيضًا، ما يتيح لك تداخل البيانات بشكل أكبر. يمكنك دمج البيانات حتى 100 مستوى.