इस क्विकस्टार्ट गाइड में, Firestore Enterprise वर्शन को सेट अप करने और डेटा जोड़ने का तरीका बताया गया है. इसके बाद, C#, Go, Java, Node.js, PHP, Python, और Ruby के लिए सर्वर क्लाइंट लाइब्रेरी का इस्तेमाल करके, Firebase कंसोल में जोड़े गए डेटा को देखने का तरीका बताया गया है.
इन क्लाइंट लाइब्रेरी का इस्तेमाल करके, अपने डेटाबेस के पूरे ऐक्सेस के साथ खास सर्वर एनवायरमेंट सेट अप करें.
Cloud Firestore डेटाबेस बनाएं
अगर आपने पहले से कोई Firebase प्रोजेक्ट नहीं बनाया है, तो कोई Firebase प्रोजेक्ट बनाएं: Firebase कंसोल में, प्रोजेक्ट जोड़ें पर क्लिक करें. इसके बाद, Firebase प्रोजेक्ट बनाने या किसी मौजूदा Google Cloud प्रोजेक्ट में Firebase की सेवाएं जोड़ने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
बाईं ओर मौजूद पैनल में, Databases & Storage > Firestore पर जाएं.
डेटाबेस बनाएं पर क्लिक करें.
अपने डेटाबेस के लिए कोई जगह चुनें.
अगर आपको कोई जगह चुनने का विकल्प नहीं मिल रहा है, तो इसका मतलब है कि आपके प्रोजेक्ट के लिए, "डिफ़ॉल्ट Google Cloud संसाधनों के लिए जगह" पहले से सेट है. आपके प्रोजेक्ट के कुछ संसाधन (जैसे, डिफ़ॉल्ट Cloud Firestore इंस्टेंस) एक ही जगह की जानकारी पर निर्भर करते हैं. इनकी जगह की जानकारी, प्रोजेक्ट बनाते समय या इस जगह की जानकारी पर निर्भर करने वाली किसी दूसरी सेवा को सेट अप करते समय सेट की जा सकती है.
अपने Cloud Firestore Security Rules के लिए, शुरुआती मोड चुनें:
- टेस्ट मोड
यह मोबाइल और वेब क्लाइंट लाइब्रेरी का इस्तेमाल शुरू करने के लिए अच्छा है. हालांकि, इससे कोई भी व्यक्ति आपके डेटा को पढ़ सकता है और उसे ओवरराइट कर सकता है. जांच करने के बाद, अपना डेटा सुरक्षित करें सेक्शन को ज़रूर देखें.
वेब, Apple प्लैटफ़ॉर्म या Android SDK टूल का इस्तेमाल शुरू करने के लिए, टेस्ट मोड चुनें.
- प्रोडक्शन मोड
मोबाइल और वेब क्लाइंट से, डेटा को पढ़ने और उसमें बदलाव करने की अनुमति नहीं देता. पुष्टि किए गए आपके ऐप्लिकेशन सर्वर (C#, Go, Java, Node.js, PHP, Python या Ruby) अब भी आपके डेटाबेस को ऐक्सेस कर सकते हैं.
C#, Go, Java, Node.js, PHP, Python या Ruby सर्वर क्लाइंट लाइब्रेरी का इस्तेमाल शुरू करने के लिए, प्रोडक्शन मोड चुनें.
Cloud Firestore Security Rules का आपका शुरुआती सेट, आपके डिफ़ॉल्ट Cloud Firestore डेटाबेस पर लागू होगा. अगर आपने अपने प्रोजेक्ट के लिए कई डेटाबेस बनाए हैं, तो हर डेटाबेस के लिए Cloud Firestore Security Rules को डिप्लॉय किया जा सकता है.
बनाएं पर क्लिक करें.
Cloud Firestore को चालू करने पर, Cloud API Manager में भी एपीआई चालू हो जाता है.
अपना डेवलपमेंट एनवायरमेंट सेट अप करना
अपने ऐप्लिकेशन में ज़रूरी डिपेंडेंसी और क्लाइंट लाइब्रेरी जोड़ें.
Java
- अपने ऐप्लिकेशन में Firebase Admin SDK जोड़ें:
-
Gradle का इस्तेमाल करना:
implementation 'com.google.firebase:firebase-admin:9.11.0'
-
Maven का इस्तेमाल करना:
<dependency> <groupId>com.google.firebase</groupId> <artifactId>firebase-admin</artifactId> <version>9.11.0</version> </dependency>
-
Gradle का इस्तेमाल करना:
- अपने एनवायरमेंट में सही क्रेडेंशियल के साथ Cloud Firestore को शुरू करने के लिए, यहां दिए गए निर्देशों का पालन करें.
Python
- अपने Python ऐप्लिकेशन में Firebase Admin SDK जोड़ें:
pip install --upgrade firebase-admin
- अपने एनवायरमेंट में सही क्रेडेंशियल के साथ Cloud Firestore को शुरू करने के लिए, यहां दिए गए निर्देशों का पालन करें.
Node.js
-
अपने ऐप्लिकेशन में Firebase Admin SDK जोड़ें:
npm install firebase-admin --save
- अपने एनवायरमेंट में सही क्रेडेंशियल के साथ Cloud Firestore को शुरू करने के लिए, यहां दिए गए निर्देशों का पालन करें.
जाएं
- अपने Go ऐप्लिकेशन में Firebase Admin SDK जोड़ें:
go get firebase.google.com/go
- अपने एनवायरमेंट में सही क्रेडेंशियल के साथ Cloud Firestore को शुरू करने के लिए, यहां दिए गए निर्देशों का पालन करें.
PHP
-
Cloud Firestore सर्वर क्लाइंट लाइब्रेरी (Java, Node.js, Python, Go, PHP, C#, और Ruby), पुष्टि करने के लिए Google ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल का इस्तेमाल करती हैं.
-
अपने डेवलपमेंट एनवायरमेंट से पुष्टि करने के लिए,
GOOGLE_APPLICATION_CREDENTIALSएनवायरमेंट वैरिएबल को JSON सेवा खाते की कुंजी वाली फ़ाइल पर सेट करें. API Console के क्रेडेंशियल पेज पर जाकर, पासकोड फ़ाइल बनाई जा सकती है.export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/keyfile.json" - अगर आपको अपने प्रोडक्शन एनवायरमेंट में, App Engine या Compute Engine पर अपना ऐप्लिकेशन चलाना है, तो आपको पुष्टि करने की ज़रूरत नहीं है. इसके लिए, आपको उसी प्रोजेक्ट का इस्तेमाल करना होगा जिसका इस्तेमाल Cloud Firestore के लिए किया जाता है. अगर ऐसा नहीं है, तो सेवा खाता सेट अप करें.
-
अपने डेवलपमेंट एनवायरमेंट से पुष्टि करने के लिए,
- PHP के लिए gRPC एक्सटेंशन इंस्टॉल और चालू करें. क्लाइंट लाइब्रेरी का इस्तेमाल करने के लिए, आपको इसकी ज़रूरत होगी.
-
अपने ऐप्लिकेशन में Cloud Firestore PHP लाइब्रेरी जोड़ें:
composer require google/cloud-firestore
Ruby
-
Cloud Firestore सर्वर क्लाइंट लाइब्रेरी (Java, Node.js, Python, Go, PHP, C#, और Ruby), पुष्टि करने के लिए Google ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल का इस्तेमाल करती हैं.
-
अपने डेवलपमेंट एनवायरमेंट से पुष्टि करने के लिए,
GOOGLE_APPLICATION_CREDENTIALSएनवायरमेंट वैरिएबल को JSON सेवा खाते की कुंजी वाली फ़ाइल पर सेट करें. API Console के क्रेडेंशियल पेज पर जाकर, पासकोड फ़ाइल बनाई जा सकती है.export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/keyfile.json"
- अगर आपको अपने प्रोडक्शन एनवायरमेंट में, App Engine या Compute Engine पर ऐप्लिकेशन चलाना है, तो आपको पुष्टि करने की ज़रूरत नहीं है. इसके लिए, आपको उसी प्रोजेक्ट का इस्तेमाल करना होगा जिसका इस्तेमाल Cloud Firestore के लिए किया जाता है. अगर ऐसा नहीं है, तो सेवा खाता सेट अप करें.
-
अपने डेवलपमेंट एनवायरमेंट से पुष्टि करने के लिए,
-
अपने
Gemfileमें, Cloud Firestore Ruby लाइब्रेरी को अपने ऐप्लिकेशन में जोड़ें:gem "google-cloud-firestore"
-
इनका इस्तेमाल करके, अपने
Gemfileसे डिपेंडेंसी इंस्टॉल करें:bundle install
(ज़रूरी नहीं) Firebase Local Emulator Suite की मदद से प्रोटोटाइप बनाना और उसकी जांच करना
मोबाइल डेवलपर के लिए, यह बताने से पहले कि आपका ऐप्लिकेशन Cloud Firestore में डेटा कैसे लिखता है और कैसे पढ़ता है, आइए हम आपको टूल के एक सेट के बारे में बताते हैं. इसका इस्तेमाल करके, Cloud Firestore की सुविधाओं का प्रोटोटाइप बनाया जा सकता है और उन्हें टेस्ट किया जा सकता है: Firebase Local Emulator Suite. अगर आपको अलग-अलग डेटा मॉडल आज़माने हैं, सुरक्षा नियमों को ऑप्टिमाइज़ करना है या बैक-एंड के साथ इंटरैक्ट करने का सबसे किफ़ायती तरीका ढूंढना है, तो लाइव सेवाओं को डिप्लॉय किए बिना लोकल लेवल पर काम करना एक अच्छा आइडिया हो सकता है.
Cloud Firestore एम्युलेटर, Local Emulator Suite का हिस्सा है. इसकी मदद से, आपका ऐप्लिकेशन आपके एम्युलेट किए गए डेटाबेस कॉन्टेंट और कॉन्फ़िगरेशन के साथ इंटरैक्ट कर सकता है. साथ ही, आपके एम्युलेट किए गए प्रोजेक्ट रिसॉर्स (फ़ंक्शन, अन्य डेटाबेस, और सुरक्षा के नियम) के साथ भी इंटरैक्ट कर सकता है.
Cloud Firestore एम्युलेटर का इस्तेमाल करने के लिए, बस कुछ ही चरणों को पूरा करना होता है:
- एम्युलेटर से कनेक्ट करने के लिए, अपने ऐप्लिकेशन के टेस्ट कॉन्फ़िगरेशन में कोड की एक लाइन जोड़ना.
- अपनी लोकल प्रोजेक्ट डायरेक्ट्री के रूट से,
firebase emulators:startचलाएं. - हमेशा की तरह, Cloud Firestore प्लैटफ़ॉर्म SDK टूल का इस्तेमाल करके, अपने ऐप्लिकेशन के प्रोटोटाइप कोड से कॉल करना.
Cloud Firestore और Cloud Functions के बारे में ज़्यादा जानकारी देने वाला वॉकथ्रू उपलब्ध है. आपको Local Emulator Suite के बारे में जानकारी भी देखनी चाहिए.
Cloud Firestore को शुरू करें
Cloud Firestore का कोई इंस्टेंस शुरू करें:
Java
Cloud Firestore SDK टूल को आपके एनवायरमेंट के हिसाब से अलग-अलग तरीकों से शुरू किया जाता है. सबसे ज़्यादा इस्तेमाल किए जाने वाले तरीके, यहां दिए गए हैं. ज़्यादा जानकारी के लिए, Admin SDK को शुरू करना लेख पढ़ें.import com.google.auth.oauth2.GoogleCredentials; import com.google.cloud.firestore.Firestore; import com.google.firebase.FirebaseApp; import com.google.firebase.FirebaseOptions; // Use the application default credentials GoogleCredentials credentials = GoogleCredentials.getApplicationDefault(); FirebaseOptions options = new FirebaseOptions.Builder() .setCredentials(credentials) .setProjectId(projectId) .build(); FirebaseApp.initializeApp(options); Firestore db = FirestoreClient.getFirestore();
अपने सर्वर पर Firebase Admin SDK का इस्तेमाल करने के लिए, सेवा खाते का इस्तेमाल करें.
Google Cloud Console में, आईएएम और एडमिन > सेवा खाते पर जाएं. एक नई निजी कुंजी जनरेट करें और JSON फ़ाइल को सेव करें. इसके बाद, SDK टूल को शुरू करने के लिए फ़ाइल का इस्तेमाल करें:
import com.google.auth.oauth2.GoogleCredentials; import com.google.cloud.firestore.Firestore; import com.google.firebase.FirebaseApp; import com.google.firebase.FirebaseOptions; // Use a service account InputStream serviceAccount = new FileInputStream("path/to/serviceAccount.json"); GoogleCredentials credentials = GoogleCredentials.fromStream(serviceAccount); FirebaseOptions options = new FirebaseOptions.Builder() .setCredentials(credentials) .build(); FirebaseApp.initializeApp(options); Firestore db = FirestoreClient.getFirestore();
Python
Cloud Firestore SDK टूल को आपके एनवायरमेंट के हिसाब से अलग-अलग तरीकों से शुरू किया जाता है. सबसे ज़्यादा इस्तेमाल किए जाने वाले तरीके, यहां दिए गए हैं. ज़्यादा जानकारी के लिए, Admin SDK को शुरू करना लेख पढ़ें.import firebase_admin from firebase_admin import firestore # Application Default credentials are automatically created. app = firebase_admin.initialize_app() db = firestore.client()
SDK टूल को शुरू करने के लिए, ऐप्लिकेशन के मौजूदा डिफ़ॉल्ट क्रेडेंशियल का भी इस्तेमाल किया जा सकता है.
import firebase_admin from firebase_admin import credentials from firebase_admin import firestore # Use the application default credentials. cred = credentials.ApplicationDefault() firebase_admin.initialize_app(cred) db = firestore.client()
अपने सर्वर पर Firebase Admin SDK का इस्तेमाल करने के लिए, सेवा खाते का इस्तेमाल करें.
Google Cloud Console में, आईएएम और एडमिन > सेवा खाते पर जाएं. नई निजी कुंजी जनरेट करें और JSON फ़ाइल को सेव करें. इसके बाद, SDK टूल को शुरू करने के लिए फ़ाइल का इस्तेमाल करें:
import firebase_admin from firebase_admin import credentials from firebase_admin import firestore # Use a service account. cred = credentials.Certificate('path/to/serviceAccount.json') app = firebase_admin.initialize_app(cred) db = firestore.client()
Python
Cloud Firestore SDK टूल को आपके एनवायरमेंट के हिसाब से अलग-अलग तरीकों से शुरू किया जाता है. सबसे ज़्यादा इस्तेमाल किए जाने वाले तरीके, यहां दिए गए हैं. ज़्यादा जानकारी के लिए, Admin SDK को शुरू करना लेख पढ़ें.import firebase_admin from firebase_admin import firestore_async # Application Default credentials are automatically created. app = firebase_admin.initialize_app() db = firestore_async.client()
SDK टूल को शुरू करने के लिए, ऐप्लिकेशन के मौजूदा डिफ़ॉल्ट क्रेडेंशियल का भी इस्तेमाल किया जा सकता है.
import firebase_admin from firebase_admin import credentials from firebase_admin import firestore_async # Use the application default credentials. cred = credentials.ApplicationDefault() firebase_admin.initialize_app(cred) db = firestore_async.client()
अपने सर्वर पर Firebase Admin SDK का इस्तेमाल करने के लिए, सेवा खाते का इस्तेमाल करें.
Google Cloud Console में, आईएएम और एडमिन > सेवा खाते पर जाएं. एक नई निजी कुंजी जनरेट करें और JSON फ़ाइल को सेव करें. इसके बाद, SDK टूल को शुरू करने के लिए फ़ाइल का इस्तेमाल करें:
import firebase_admin from firebase_admin import credentials from firebase_admin import firestore_async # Use a service account. cred = credentials.Certificate('path/to/serviceAccount.json') app = firebase_admin.initialize_app(cred) db = firestore_async.client()
Node.js
Cloud Firestore SDK टूल को आपके एनवायरमेंट के हिसाब से अलग-अलग तरीकों से शुरू किया जाता है. सबसे ज़्यादा इस्तेमाल किए जाने वाले तरीके, यहां दिए गए हैं. ज़्यादा जानकारी के लिए, Admin SDK को शुरू करना लेख पढ़ें.-
Cloud Functions को शुरू करें
const { initializeApp, applicationDefault, cert } = require('firebase-admin/app'); const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');
initializeApp(); const db = getFirestore();
-
Google Cloud पर शुरू करें
const { initializeApp, applicationDefault, cert } = require('firebase-admin/app'); const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');
initializeApp({ credential: applicationDefault() }); const db = getFirestore();
-
अपने सर्वर पर शुरू करना
अपने सर्वर (या किसी अन्य Node.js एनवायरमेंट) पर Firebase Admin SDK का इस्तेमाल करने के लिए, सेवा खाते का इस्तेमाल करें. Google Cloud Console में, आईएएम और एडमिन > सेवा खाते पर जाएं. नई निजी कुंजी जनरेट करें और JSON फ़ाइल को सेव करें. इसके बाद, SDK टूल को शुरू करने के लिए फ़ाइल का इस्तेमाल करें:
const { initializeApp, applicationDefault, cert } = require('firebase-admin/app'); const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');
const serviceAccount = require('./path/to/serviceAccountKey.json'); initializeApp({ credential: cert(serviceAccount) }); const db = getFirestore();
जाएं
Cloud Firestore SDK टूल को आपके एनवायरमेंट के हिसाब से अलग-अलग तरीकों से शुरू किया जाता है. सबसे ज़्यादा इस्तेमाल किए जाने वाले तरीके, यहां दिए गए हैं. ज़्यादा जानकारी के लिए, Admin SDK को शुरू करना लेख पढ़ें.import ( "log" firebase "firebase.google.com/go" "google.golang.org/api/option" ) // Use the application default credentials ctx := context.Background() conf := &firebase.Config{ProjectID: projectID} app, err := firebase.NewApp(ctx, conf) if err != nil { log.Fatalln(err) } client, err := app.Firestore(ctx) if err != nil { log.Fatalln(err) } defer client.Close()
अपने सर्वर पर Firebase Admin SDK का इस्तेमाल करने के लिए, सेवा खाते का इस्तेमाल करें.
Google Cloud Console में, आईएएम और एडमिन > सेवा खाते पर जाएं. एक नई निजी कुंजी जनरेट करें और JSON फ़ाइल को सेव करें. इसके बाद, SDK टूल को शुरू करने के लिए फ़ाइल का इस्तेमाल करें:
import ( "log" firebase "firebase.google.com/go" "google.golang.org/api/option" ) // Use a service account ctx := context.Background() sa := option.WithCredentialsFile("path/to/serviceAccount.json") app, err := firebase.NewApp(ctx, nil, sa) if err != nil { log.Fatalln(err) } client, err := app.Firestore(ctx) if err != nil { log.Fatalln(err) } defer client.Close()
PHP
PHP
Cloud Firestore क्लाइंट को इंस्टॉल करने और बनाने के बारे में ज़्यादा जानने के लिए, Cloud Firestore क्लाइंट लाइब्रेरी देखें.
C#
C#
Cloud Firestore क्लाइंट को इंस्टॉल करने और बनाने के बारे में ज़्यादा जानने के लिए, Cloud Firestore क्लाइंट लाइब्रेरी देखें.
Ruby
डेटा जोड़ें
Cloud Firestore, डेटा को दस्तावेज़ों में सेव करता है. ये दस्तावेज़, कलेक्शन में सेव किए जाते हैं. Cloud Firestore, दस्तावेज़ में पहली बार डेटा जोड़ने पर, कलेक्शन और दस्तावेज़ों को अपने-आप बनाता है. आपको अलग से कलेक्शन या दस्तावेज़ बनाने की ज़रूरत नहीं है.
यहां दिए गए उदाहरण कोड का इस्तेमाल करके, नया कलेक्शन और दस्तावेज़ बनाएं.
Java
Python
Python
Node.js
जाएं
PHP
PHP
Cloud Firestore क्लाइंट को इंस्टॉल करने और बनाने के बारे में ज़्यादा जानने के लिए, Cloud Firestore क्लाइंट लाइब्रेरी देखें.
C#
Ruby
अब users कलेक्शन में कोई दूसरा दस्तावेज़ जोड़ें. ध्यान दें कि इस दस्तावेज़ में एक ऐसा की-वैल्यू पेयर (मिडिल नेम) शामिल है जो पहले दस्तावेज़ में नहीं दिखता. किसी कलेक्शन में मौजूद दस्तावेज़ों में, अलग-अलग तरह की जानकारी हो सकती है.
Java
Python
Python
Node.js
जाएं
PHP
PHP
Cloud Firestore क्लाइंट को इंस्टॉल करने और बनाने के बारे में ज़्यादा जानने के लिए, Cloud Firestore क्लाइंट लाइब्रेरी देखें.
C#
Ruby
डेटा पढ़ने की अनुमति दें
Firebase कंसोल में डेटा व्यूअर का इस्तेमाल करके, तुरंत पुष्टि करें कि आपने Cloud Firestore में डेटा जोड़ा है.
पूरे कलेक्शन को वापस पाने के लिए, "get" तरीके का भी इस्तेमाल किया जा सकता है.
Java
Python
users_ref = db.collection("users") docs = users_ref.stream() for doc in docs: print(f"{doc.id} => {doc.to_dict()}")
Python
Node.js
जाएं
PHP
PHP
Cloud Firestore क्लाइंट को इंस्टॉल करने और बनाने के बारे में ज़्यादा जानने के लिए, Cloud Firestore क्लाइंट लाइब्रेरी देखें.
C#
Ruby
अगले चरण
इन विषयों के बारे में ज़्यादा जानकारी पाएं:
- डेटा मॉडल — इस बारे में ज़्यादा जानें कि Cloud Firestore में डेटा को कैसे स्ट्रक्चर किया जाता है. इसमें हैरारकी वाला डेटा और सब-कलेक्शन शामिल हैं.
- डेटा जोड़ना — Cloud Firestore में डेटा बनाने और उसे अपडेट करने के बारे में ज़्यादा जानें.
- डेटा पाना — डेटा वापस पाने के तरीके के बारे में ज़्यादा जानें.
- आसान और मुश्किल क्वेरी करना — आसान और मुश्किल क्वेरी करने का तरीका जानें.
- क्वेरी को क्रम से लगाना और सीमित करना अपनी क्वेरी से मिले डेटा को क्रम से लगाने और सीमित करने का तरीका जानें.