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

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

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

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

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

المستندات

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

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

• حبة واحدة ()

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

ملاحظة: يتوافق تطبيق "Cloud Firestore" مع مجموعة متنوعة من أنواع البيانات للقيم: القيمة المنطقية والرقم وسلسلة ونقطة جغرافية وثنائي ثنائي والطابع الزمني. يمكنك أيضًا استخدام الصفائف أو الكائنات المدمجة، المعروفة بالخرائط، لتنظيم البيانات في مستند.

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

• حبة واحدة ()

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

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

المجموعات

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

• مستخدم

  • حبة واحدة ()

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

  • في الجولة

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

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

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

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

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

المراجع

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

Web

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

import { doc } from "firebase/firestore";

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

Web

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

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

Swift

ملاحظة: لا يتوفّر هذا المنتج ضمن نظامَي التشغيل WatchOS وApp Clip.

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

Objective-C

ملاحظة: لا يتوفّر هذا المنتج ضمن نظامَي التشغيل WatchOS وApp Clip.

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

Kotlin+KTX

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

Java

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

Dart

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

Python

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

Python

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

C++‎

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

Node.js

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

PHP

PHP

لمزيد من المعلومات عن تثبيت برنامج "Cloud Firestore" وإنشائه، يمكنك الاطّلاع على مكتبات عملاء Cloud Firestore.

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

Unity

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

#C

#C

لمزيد من المعلومات عن تثبيت برنامج "Cloud Firestore" وإنشائه، يمكنك الاطّلاع على مكتبات عملاء Cloud Firestore.

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

لغة Ruby

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

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

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

Web

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

import { collection } from "firebase/firestore";

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

Web

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

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

Swift

ملاحظة: لا يتوفّر هذا المنتج ضمن نظامَي التشغيل WatchOS وApp Clip.

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

Objective-C

ملاحظة: لا يتوفّر هذا المنتج ضمن نظامَي التشغيل WatchOS وApp Clip.

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

Kotlin+KTX

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

Java

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

Dart

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

جافا

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

Python

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

Python

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

C++‎

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

Node.js

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

PHP

PHP

لمزيد من المعلومات عن تثبيت برنامج "Cloud Firestore" وإنشائه، يمكنك الاطّلاع على مكتبات عملاء Cloud Firestore.

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

Unity

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

#C

#C

لمزيد من المعلومات عن تثبيت برنامج "Cloud Firestore" وإنشائه، يمكنك الاطّلاع على مكتبات عملاء Cloud Firestore.

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

لغة Ruby

collection_ref = firestore.col "users"
data_model.rb

ملاحظة: المراجع الخاصة بالمجموعات والمراجع الخاصة بالمستندات نوعان مختلفان. من المراجع وتسمح لك بإجراء عمليات مختلفة. على سبيل المثال، يمكنك استخدام مرجع مجموعة للاستعلام عن المستندات الموجودة في المجموعة، استخدام مرجع مستند لقراءة مستند فردي أو كتابته.

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

Web

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

import { doc } from "firebase/firestore"; 

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

Web

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

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

Swift

ملاحظة: لا يتوفّر هذا المنتج ضمن نظامَي التشغيل WatchOS وApp Clip.

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

Objective-C

ملاحظة: لا يتوفّر هذا المنتج ضمن نظامَي التشغيل WatchOS وApp Clip.

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

Kotlin+KTX

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

Java

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

Dart

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

Python

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

Python

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

C++‎

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

Node.js

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

PHP

PHP

لمزيد من المعلومات عن تثبيت برنامج "Cloud Firestore" وإنشائه، يمكنك الاطّلاع على مكتبات عملاء Cloud Firestore.

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

Unity

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

#C

#C

لمزيد من المعلومات عن تثبيت برنامج "Cloud Firestore" وإنشائه، يمكنك الاطّلاع على مكتبات عملاء Cloud Firestore.

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

لغة Ruby

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

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

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

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

• غرفتان ()

  • غرفة واحدة () أ

    name : "my chat room"
    

  • غرفة واحدة ()

    ...
    

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

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

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

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

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

• غرفتان ()

  • غرفة واحدة () أ

    name : "my chat room"
    

    • الرَّسَايِلْ

      • رسالة1

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

      • الرسالة 2

        ...
        

  • غرفة واحدة ()

    ...
    

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

Web

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

import { doc } from "firebase/firestore"; 

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

Web

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

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

Swift

ملاحظة: لا يتوفّر هذا المنتج ضمن نظامَي التشغيل WatchOS وApp Clip.

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

Objective-C

ملاحظة: لا يتوفّر هذا المنتج ضمن نظامَي التشغيل WatchOS وApp Clip.

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

Kotlin+KTX

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

Java

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

Dart

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

Python

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

Python

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

C++‎

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

Node.js

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

PHP

PHP

لمزيد من المعلومات عن تثبيت برنامج "Cloud Firestore" وإنشائه، يمكنك الاطّلاع على مكتبات عملاء Cloud Firestore.

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

Unity

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

#C

#C

لمزيد من المعلومات عن تثبيت برنامج "Cloud Firestore" وإنشائه، يمكنك الاطّلاع على مكتبات عملاء Cloud Firestore.

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

لغة Ruby

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

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

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

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

تحذير: لا يؤدي حذف المستند إلى حذف مجموعاته الفرعية.

عند تقوم بحذف مستند يحتوي على مجموعات فرعية، تكون هذه المجموعات الفرعية لم يتم حذفه. على سبيل المثال، قد يكون هناك مستند في coll/doc/subcoll/subdoc. على الرغم من أنّ المستند coll/doc لم يعُد متوفّرًا. إذا أردت حذف مستندات في مجموعات فرعية عند حذف مستند رئيسي، يجب عليك القيام بذلك يدويًا، كما هو موضح في حذف المجموعات: