原生模式下的 Cloud Firestore 企业版现已推出！了解详情。

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

Cloud Firestore डेटा मॉडल

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

हर दस्तावेज़ में की-वैल्यू पेयर का एक सेट होता है. 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 की तरह दिखते हैं. असल में, वे एक ही हैं. इनमें कुछ अंतर होते हैं. उदाहरण के लिए, दस्तावेज़ों में ज़्यादा डेटा टाइप इस्तेमाल किए जा सकते हैं. साथ ही, ये दस्तावेज़ के साइज़ की सीमा तक ही सीमित होते हैं. हालांकि, आम तौर पर दस्तावेज़ों को लाइटवेट JSON रिकॉर्ड के तौर पर इस्तेमाल किया जा सकता है.

संग्रह

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

उपयोगकर्ता
- alovelace
  
  first : "Ada"
  last : "Lovelace"
  born : 1815
- पर उपलब्ध है
  
  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

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 में पुष्टि करने के लिए, ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल सेट अप करें. ज़्यादा जानकारी के लिए, लोकल डेवलपमेंट एनवायरमेंट के लिए पुष्टि करने की सुविधा सेट अप करना लेख पढ़ें.

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

Unity

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

C#

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

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

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

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

Unity

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

C#

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

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

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');

Unity

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

C#

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

Ruby

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

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

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

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

कमरे
- कमरा
  
  name : "my chat room"
- roomB
  
  ...

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

सब-कलेक्शन

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

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

कमरे
- कमरा
  
  name : "my chat room"
  - मैसेज
    - message1
      
      from : "alex"
      msg : "Hello World!"
    - message2
      
      ...
- 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

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');

Unity

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

C#

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

Ruby

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

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

सब-कलेक्शन की मदद से, डेटा को हैरारकी के हिसाब से व्यवस्थित किया जा सकता है. इससे डेटा को ऐक्सेस करना आसान हो जाता है. roomA में मौजूद सभी मैसेज पाने के लिए, सब-कलेक्शन messages का कलेक्शन रेफ़रंस बनाया जा सकता है. साथ ही, इसके साथ उसी तरह इंटरैक्ट किया जा सकता है जिस तरह किसी अन्य कलेक्शन रेफ़रंस के साथ किया जाता है.

सब-कलेक्शन में मौजूद दस्तावेज़ों में भी सब-कलेक्शन हो सकते हैं. इससे आपको डेटा को और नेस्ट करने की सुविधा मिलती है. डेटा को 100 लेवल तक नेस्ट किया जा सकता है.

चेतावनी: किसी दस्तावेज़ को मिटाने से उसके सब-कलेक्शन नहीं मिटते!

जब सब-कलेक्शन वाले किसी दस्तावेज़ को मिटाया जाता है, तो वे सब-कलेक्शन नहीं मिटते. उदाहरण के लिए, ऐसा हो सकता है कि coll/doc/subcoll/subdoc पर कोई दस्तावेज़ मौजूद हो, भले ही coll/doc दस्तावेज़ अब मौजूद न हो. अगर आपको पैरंट दस्तावेज़ को मिटाते समय, सब-कलेक्शन में मौजूद दस्तावेज़ों को मिटाना है, तो आपको ऐसा मैन्युअल तरीके से करना होगा. इसके बारे में कलेक्शन मिटाना में बताया गया है.