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

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

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

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

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

وثائق

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

قد يبدو المستند الذي يمثل مستخدم alovelace كما يلي:

• class ألوفليس

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

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

• class ألوفليس

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

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

المجموعات

تعيش المستندات في مجموعات، وهي مجرد حاويات للمستندات. على سبيل المثال، يمكن أن يكون لديك مجموعة users تحتوي على مستخدمين مختلفين، يتم تمثيل كل منهم بواسطة مستند:

• collections_bookmark

  • class ألوفليس

    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 Rooms

  • غرفة class أ

    name : "my chat room"
    

  • غرفة class ب

    ...
    

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

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

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

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

• collections_bookmark Rooms

  • غرفة class أ

    name : "my chat room"
    

    • collections_bookmark الرسائل

      • رسالة class 1

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

      • رسالة class 2

        ...
        

  • غرفة 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 مستوى.