इस पेज का अनुवाद Cloud Translation API से किया गया है.

Cloud Firestore डेटा मॉडल

Cloud Firestore एक NoSQL, दस्तावेज़-ओरिएंटेड डेटाबेस है. SQL डेटाबेस के उलट, इसमें कोई टेबल या लाइन नहीं होती. इसके बजाय, डेटा को दस्तावेज़ों में सेव किया जाता है. इन्हें कलेक्शन में व्यवस्थित किया जाता है.

हर दस्तावेज़ में की-वैल्यू पेयर का सेट होता है. Cloud Firestore को छोटे दस्तावेज़ों के बड़े कलेक्शन को स्टोर करने के लिए ऑप्टिमाइज़ किया गया है.

सभी दस्तावेज़ों को कलेक्शन में सेव करना ज़रूरी है. दस्तावेज़ों में सब-कलेक्शन और नेस्ट किए गए ऑब्जेक्ट शामिल हो सकते हैं. इन दोनों में, स्ट्रिंग जैसे प्राइमिटिव फ़ील्ड या सूचियों जैसे जटिल ऑब्जेक्ट शामिल हो सकते हैं.

Cloud Firestore में कलेक्शन और दस्तावेज़ अपने-आप बन जाते हैं. किसी कलेक्शन में मौजूद दस्तावेज़ में डेटा असाइन करें. अगर इनमें से कोई एक या दस्तावेज़ मौजूद नहीं है, तो Cloud Firestore इसे बनाता है.

दस्तावेज़

Cloud Firestore में, स्टोरेज की यूनिट को दस्तावेज़ कहा जाता है. दस्तावेज़ एक हल्का रिकॉर्ड होता है. इसमें ऐसे फ़ील्ड होते हैं जो वैल्यू पर मैप होते हैं. हर दस्तावेज़ को एक नाम से पहचाना जाता है.

उपयोगकर्ता alovelace का दस्तावेज़ कुछ ऐसा दिख सकता है:

alovelace

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

किसी दस्तावेज़ में कॉम्प्लेक्स और नेस्ट किए गए ऑब्जेक्ट को मैप कहा जाता है. उदाहरण के लिए, ऊपर दिए गए उदाहरण में मौजूद उपयोगकर्ता के नाम को मैप की मदद से इस तरह से स्ट्रक्चर किया जा सकता है:

अलोवेलस

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

आपको यह दिख सकता है कि दस्तावेज़, JSON फ़ॉर्मैट में मौजूद डेटा की तरह ही दिखते हैं. असल में, ऐसा ही है. कुछ अंतर हैं. उदाहरण के लिए, दस्तावेज़ में अतिरिक्त डेटा टाइप और आकार में 1 MB तक सीमित होती हैं), लेकिन सामान्य रूप से आप दस्तावेज़ों को लाइटवेट JSON रिकॉर्ड.

संग्रह

दस्तावेज़, कलेक्शन में मौजूद होते हैं, जो सिर्फ़ दस्तावेज़ों के कंटेनर होते हैं. उदाहरण के लिए, आपके पास अपने अलग-अलग उपयोगकर्ताओं को शामिल करने के लिए users कलेक्शन हो सकता है. हर उपयोगकर्ता को एक दस्तावेज़ से दिखाया जाता है:

उपयोगकर्ता
- alovelace
  
  first : "Ada"
  last : "Lovelace"
  born : 1815
- aturing
  
  first : "Alan"
  last : "Turing"
  born : 1912

Cloud Firestore स्कीमा-लेस है. इसलिए, आपके पास यह तय करने की पूरी छूट होती है कि हर दस्तावेज़ में कौनसे फ़ील्ड डाले जाएं और उन फ़ील्ड में किस तरह का डेटा सेव किया जाए. एक ही कलेक्शन में मौजूद दस्तावेज़ों में अलग-अलग फ़ील्ड या स्टोर हो सकते हैं अलग-अलग तरह के डेटा को शामिल करना ज़रूरी है. हालांकि, यह जानना अच्छा है कि कई दस्तावेज़ों में एक ही फ़ील्ड और डेटा टाइप, ताकि आप दस्तावेज़ों को जोड़ना आसान हो जाता है.

कलेक्शन में सिर्फ़ दस्तावेज़ होते हैं. इसमें सीधे तौर पर वैल्यू वाले रॉ फ़ील्ड शामिल नहीं किए जा सकते. साथ ही, इसमें अन्य कलेक्शन भी शामिल नहीं किए जा सकते. Cloud Firestore में ज़्यादा जटिल डेटा को स्ट्रक्चर करने का तरीका जानने के लिए, हियरार्की वाला डेटा देखें.

कलेक्शन में मौजूद दस्तावेज़ों के नाम यूनीक होते हैं. आप अपना खुद का डेटा दे सकते हैं जैसे कि यूज़र आईडी या आप Cloud Firestore को रैंडम आईडी बनाने की अनुमति दे सकते हैं आपके लिए अपने आप.

आपको "बनाने" की ज़रूरत नहीं है या "मिटाएं" संग्रह. किसी कलेक्शन में पहला दस्तावेज़ बनाने के बाद, कलेक्शन मौजूद हो जाता है. अगर आप पूरा दस्तावेज़ हैं, तो यह अब मौजूद नहीं है.

रेफ़रंस

Cloud Firestore में मौजूद हर दस्तावेज़ की पहचान, डेटाबेस में उसकी जगह के हिसाब से की जाती है. पिछले उदाहरण में, कलेक्शन users में मौजूद दस्तावेज़ alovelace दिखाया गया था. अपने कोड में इस जगह का रेफ़रंस देने के लिए, इसका रेफ़रंस बनाया जा सकता है.

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

Java

// 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

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#

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

Java

// 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

Cloud Firestore क्लाइंट को इंस्टॉल करने और बनाने के बारे में ज़्यादा जानने के लिए, Cloud Firestore क्लाइंट लाइब्रेरी देखें.

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

Unity

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

C#

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

Java

// 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

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

Unity

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

C#

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

Ruby

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

हैरारकी वाला डेटा

Cloud Firestore में हैरारकी वाले डेटा स्ट्रक्चर के काम करने का तरीका समझने के लिए, मैसेज और चैट रूम वाले चैट ऐप्लिकेशन का उदाहरण देखें.

अलग-अलग चैट रूम को सेव करने के लिए, rooms नाम का एक कलेक्शन बनाया जा सकता है:

कमरे
- रूमA
  
  name : "my chat room"
- रूमबी
  
  ...

अब जब आपके पास चैट रूम हैं, तो तय करें कि अपने मैसेज को कैसे सेव करना है. शायद आप ये न कर पाएं को चैट रूम के दस्तावेज़ में सेव करना चाहे. Cloud Firestore में मौजूद दस्तावेज़ कम साइज़ का हो और चैट रूम में बड़ी संख्या में मैसेज हो सकते हों. हालांकि, चैट रूम के दस्तावेज़ में, उप-संग्रह के तौर पर अन्य कलेक्शन बनाए जा सकते हैं.

सब-कलेक्शन

इस स्थिति में, सब-कलेक्शन का इस्तेमाल करके मैसेज सेव करने का सबसे अच्छा तरीका है. सब-कलेक्शन, किसी खास दस्तावेज़ से जुड़ा कलेक्शन होता है.

अपने rooms कलेक्शन में मौजूद हर रूम दस्तावेज़ के लिए, messages नाम का सब-कलेक्शन बनाया जा सकता है:

कमरे
- रूमA
  
  name : "my chat room"
  - अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है मैसेज
    - अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है मैसेज1
      
      from : "alex"
      msg : "Hello World!"
    - अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है मैसेज2
      
      ...
- roomB
  
  ...

इस उदाहरण में, आपको सब-कलेक्शन में मौजूद किसी मैसेज के लिए रेफ़रंस बनाना होगा कोड का इस्तेमाल करें:

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

Java

// 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

$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#

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 अब मौजूद नहीं है. अगर आपको पैरंट दस्तावेज़ मिटाते समय, सब-कलेक्शन में मौजूद दस्तावेज़ मिटाने हैं, तो आपको मैन्युअल तरीके से ऐसा करना होगा. इसके बारे में कलेक्शन मिटाना में बताया गया है.