इस क्विकस्टार्ट में, आप Firebase Data Connect बनाने का तरीका जानेंगे. आपका ऐप्लिकेशन.
- अपने Firebase प्रोजेक्ट में Firebase Data Connect जोड़ें.
- प्रोडक्शन इंस्टेंस के साथ काम करने के लिए, Visual Studio कोड एक्सटेंशन के साथ डेवलपमेंट एनवायरमेंट सेट अप करें.
- इसके बाद, हम आपको बताएंगे कि:
- मूवी की समीक्षा करने वाले ऐप्लिकेशन के लिए स्कीमा बनाएं और उसे प्रोडक्शन में डिप्लॉय करें.
- अपने स्कीमा के लिए क्वेरी और म्यूटेशन तय करें.
- स्ट्रोंगली टाइप किए गए SDK टूल जनरेट करना और उन्हें अपने ऐप्लिकेशन में इस्तेमाल करना
- अपने फ़ाइनल स्कीमा, क्वेरी, और डेटा को प्रोडक्शन में डिप्लॉय करें.
ज़रूरी शर्तें
अपने स्थानीय एनवायरमेंट में, इस शुरुआती निर्देश का इस्तेमाल करने के लिए, आपके पास ये चीज़ें होनी चाहिए.
- Linux, macOS या Windows
- Visual Studio Code
अपने Firebase प्रोजेक्ट से कनेक्ट करना
- अगर आपने पहले से कोई Firebase प्रोजेक्ट नहीं बनाया है, तो एक प्रोजेक्ट बनाएं.
- Firebase कंसोल में, प्रोजेक्ट जोड़ें पर क्लिक करें. इसके बाद, स्क्रीन पर दिए गए निर्देशों का पालन करें.
- Firebase कंसोल के Data Connect सेक्शन पर जाएं और प्रॉडक्ट सेटअप करने के वर्कफ़्लो का पालन करें.
अपने प्रोजेक्ट को Blaze प्लान पर अपग्रेड करें. इसकी मदद से, PostgreSQL इंस्टेंस के लिए Cloud SQL बनाया जा सकता है.
'PostgreSQL के लिए CloudSQL' डेटाबेस के लिए कोई जगह चुनें.
बाद में पुष्टि करने के लिए, प्रोजेक्ट, सेवा, और डेटाबेस के नाम और आईडी नोट कर लें.
बचे हुए सेटअप फ़्लो का पालन करें. इसके बाद, हो गया पर क्लिक करें.
डेवलपमेंट एनवायरमेंट चुनना और सेट अप करना
Data Connect, डेवलपमेंट के लिए दो तरीकों का इस्तेमाल करता है:
- अगर आप Kotlin Android, iOS, Flutter या वेब डेवलपर हैं, तो VS Code डेवलपमेंट का इस्तेमाल करके, PostgreSQL के लिए Cloud SQL इंस्टेंस से कनेक्ट करते समय, स्कीमा और ऑपरेशन को डिज़ाइन और टेस्ट किया जा सकता है.
- अगर आप वेब डेवलपर हैं, तो IDX डेवलपमेंट का इस्तेमाल करके, IDX वर्कस्पेस में प्रोटोटाइप बनाएं. इसके लिए, PostgreSQL के साथ पहले से कॉन्फ़िगर किए गए IDX टेंप्लेट, Data Connect एमुलेटर के साथ VS Code एक्सटेंशन, और आपके लिए सेट अप किए गए क्विकस्टार्ट क्लाइंट कोड का इस्तेमाल करें. ज़्यादा जानकारी के लिए, Project IDX की साइट पर जाएं.
यह क्विकस्टार्ट, बनाम कोड के एक्सटेंशन डेवलपमेंट फ़्लो पर फ़ोकस करता है. जारी रखने के लिए:
- अपने लोकल प्रोजेक्ट के लिए नई डायरेक्ट्री बनाएं.
- बनाम कोड को नई डायरेक्ट्री में खोलें.
Visual Studio Code Marketplace से Firebase Data Connect एक्सटेंशन इंस्टॉल करें.
अपना लोकल प्रोजेक्ट सेट अप करना
सामान्य निर्देशों का पालन करके, सीएलआई इंस्टॉल करें. अगर आपके पास एनपीएम है पहले से इंस्टॉल है, तो निम्न आदेश चलाएं:
npm install -g firebase-tools
अपनी प्रोजेक्ट डायरेक्ट्री सेट अप करना
अपना लोकल प्रोजेक्ट सेट अप करने के लिए, प्रोजेक्ट डायरेक्ट्री शुरू करें.
बनाम कोड के बाईं ओर मौजूद पैनल में, Firebase आइकॉन पर क्लिक करके Firebase बनाम कोड एक्सटेंशन का यूज़र इंटरफ़ेस (यूआई) खोलें.
- Google से साइन इन करें बटन पर क्लिक करें.
- Firebase प्रोजेक्ट से कनेक्ट करें बटन पर क्लिक करें और वह प्रोजेक्ट चुनें कंसोल में पहले बनाया गया था.
- Firebase init चलाएं बटन पर क्लिक करें.
- अगर आपका प्रोजेक्ट ब्लेज़ प्लान पर है, तो प्रॉम्प्ट मिलने पर "क्या आपको अभी अपने बैकएंड संसाधनों को कॉन्फ़िगर करना है?", जवाब "हां" हो.
एम्युलेटर शुरू करें बटन पर क्लिक करें.
स्कीमा बनाना
अपनी Firebase प्रोजेक्ट डायरेक्ट्री में, /dataconnect/schema/schema.gql
फ़ाइल में, एक ऐसा GraphQL स्कीमा तय करें जिसमें फ़िल्में शामिल हों.
मूवी
Data Connect में, ग्राफ़क्यूएल फ़ील्ड को कॉलम में मैप किया जाता है. Movie
प्रकार में id
, title
, imageUrl
, और genre
हैं. Data Connect
प्राइमटिव डेटा टाइप String
और UUID
को पहचानता है.
नीचे दिए गए स्निपेट को कॉपी करें या फ़ाइल में इससे जुड़ी लाइनों की टिप्पणी हटाएं.
# File `/dataconnect/schema/schema.gql`
# By default, a UUID id key will be created by default as primary key.
type Movie @table {
id: UUID! @default(expr: "uuidV4()")
title: String!
imageUrl: String!
genre: String
}
फ़िल्म मेटाडेटा
अब जब आपके पास फ़िल्में हैं, तो फ़िल्म के मेटाडेटा को मॉडल किया जा सकता है.
नीचे दिया गया स्निपेट कॉपी करें या फ़ाइल में मौजूद उससे जुड़ी लाइनों से कम्यूट हटाएं.
# Movie - MovieMetadata is a one-to-one relationship
type MovieMetadata @table {
# This time, we omit adding a primary key because
# you can rely on Data Connect to manage it.
# @unique indicates a 1-1 relationship
movie: Movie! @unique
# movieId: UUID <- this is created by the above reference
rating: Float
releaseYear: Int
description: String
}
ध्यान दें कि movie
फ़ील्ड को एक तरह के Movie
के हिसाब से मैप किया गया है.
Data Connect को पता है कि यह Movie
और MovieMetadata
के बीच का संबंध है. साथ ही, वह आपके लिए इस संबंध को मैनेज करेगा.
दस्तावेज़ में, Data Connect स्कीमा के बारे में ज़्यादा जानें
अपने स्कीमा को प्रोडक्शन में डिप्लॉय करना
अगर Firebase बनाम कोड एक्सटेंशन का इस्तेमाल करके, कैसे काम किया जा रहा है प्रोडक्शन डेटाबेस के लिए, आपको जारी रखने से पहले अपना स्कीमा डिप्लॉय करना होगा. अपने प्रोडक्शन डेटाबेस में स्कीमा को डिप्लॉय करने के बाद, आपको कंसोल पर स्कीमा दिखने लगेगा.
- डिप्लॉय करने के लिए, Data Connect VS Code एक्सटेंशन का इस्तेमाल किया जा सकता है.
- एक्सटेंशन के यूज़र इंटरफ़ेस (यूआई) में, Firebase Data Connect पैनल में जाकर, प्रोडक्शन में डिप्लॉय करें पर क्लिक करें.
- आपको स्कीमा में हुए बदलावों की समीक्षा करनी पड़ सकती है और उन्हें अनुमति देनी पड़ सकती है कि वे नुकसान पहुंचा सकते हैं
बदलाव. आपसे यह करने के लिए कहा जाएगा:
firebase dataconnect:sql:diff
का इस्तेमाल करके, स्कीमा में हुए बदलावों की समीक्षा करना- जब आप बदलावों से संतुष्ट हो जाएं, तो
firebase dataconnect:sql:migrate
से शुरू किए गए फ़्लो का इस्तेमाल करके उन्हें लागू करें.
अपनी टेबल में डेटा जोड़ना
VS Code एडिटर पैनल में, आपको
/dataconnect/schema/schema.gql
में ग्राफ़क्यूएल टाइप. आपने डिप्लॉय किए हैं
स्कीमा को प्रोडक्शन में बंद नहीं किया जा सकता, तो डेटा जोड़ें का इस्तेमाल किया जा सकता है और
चलाएं (प्रोडक्शन) बटन, बैकएंड पर आपके डेटाबेस में डेटा जोड़ते हैं.
Movie
टेबल में रिकॉर्ड जोड़ने के लिए:
schema.gql
में,Movie
टाइप के ऊपर मौजूद डेटा जोड़ें बटन पर क्लिक करें एलान के लिए उपलब्ध है.
- जनरेट होने वाली
Movie_insert.gql
फ़ाइल में, चार फ़ील्ड. - चालू करें (प्रोडक्शन) बटन पर क्लिक करें.
डेटा जोड़े जाने की तुरंत पुष्टि करने के लिए:
schema.gql
पेज पर वापस जाकर, डेटा पढ़ें बटन पर क्लिक करें.Movie_read.gql
फ़ाइल में, क्वेरी को लागू करने के लिए चालू करें (प्रोडक्शन) बटन पर क्लिक करें.
दस्तावेज़ में, Data Connect म्यूटेशन के बारे में ज़्यादा जानें
अपनी क्वेरी तय करें
अब मज़ेदार हिस्सा, क्वेरी. डेवलपर के तौर पर, आपको GraphQL क्वेरी के बजाय SQL क्वेरी लिखने की आदत होती है. इसलिए, शुरुआत में आपको यह थोड़ा अलग लग सकता है. हालांकि, GraphQL, रॉ SQL की तुलना में ज़्यादा छोटा और टाइप-सेफ़ है. साथ ही, हमारा VS Code ऐप्लिकेशन, डेवलपमेंट का अनुभव आसान बनाता है.
/dataconnect/connector/queries.gql
फ़ाइल में बदलाव करना शुरू करें. अगर आपको सभी मूवी चाहिए, तो इस तरह की क्वेरी का इस्तेमाल करें.
# File `/dataconnect/connector/queries.gql`
# @auth() directives control who can call each operation.
# Anyone should be able to list all movies, so the auth level
# is set to PUBLIC
query ListMovies @auth(level: PUBLIC) {
movies {
id
title
imageUrl
genre
}
}
आस-पास मौजूद CodeLens बटन का इस्तेमाल करके क्वेरी एक्ज़ीक्यूट करें.
दस्तावेज़ में, Data Connect क्वेरी के बारे में ज़्यादा जानें
SDK टूल जनरेट करना और उन्हें अपने ऐप्लिकेशन में इस्तेमाल करना
- ऐप्लिकेशन में SDK टूल जोड़ें बटन पर क्लिक करें.
डायलॉग बॉक्स में, कोड वाली डायरेक्ट्री चुनें आपके ऐप्लिकेशन के लिए. Data Connect. SDK कोड जनरेट होगा और सेव कर लिया है.
अपना ऐप्लिकेशन प्लैटफ़ॉर्म चुनें. इसके बाद, ध्यान रखें कि SDK कोड तुरंत आपकी चुनी गई डायरेक्ट्री में जनरेट किया गया.
क्लाइंट ऐप्लिकेशन (वेब, Android, iOS, Flutter) से क्वेरी और म्यूटेशन को कॉल करने के लिए, जनरेट किए गए SDK टूल का इस्तेमाल करने का तरीका जानें.
अपने स्कीमा और क्वेरी को प्रोडक्शन में डिप्लॉय करें
आपने डेवलपमेंट के किसी चरण पर काम किया हो. अब Firebase एक्सटेंशन के यूज़र इंटरफ़ेस (यूआई) या Firebase CLI की मदद से, अपने स्कीमा की तरह ही स्कीमा, डेटा, और क्वेरी को सर्वर पर डिप्लॉय किया जा सकता है.
अगर डिप्लॉय करने के लिए Firebase बनाम कोड एक्सटेंशन का इस्तेमाल किया जाता है, तो प्रोडक्शन में डिप्लॉय करें बटन.
डिप्लॉय करने के बाद, Firebase कंसोल पर जाकर, पुष्टि करें कि स्कीमा, कार्रवाइयां, और डेटा क्लाउड पर अपलोड हो गया है. आपने लोगों तक पहुंचाया मुफ़्त में स्कीमा को देखने और कंसोल पर इस तरह से आपके ऑपरेशन चलाने में सक्षम होना चाहिए करते हैं. 'PostgreSQL के लिए Cloud SQL' इंस्टेंस को, डिप्लॉय किए गए आखिरी स्कीमा और डेटा के साथ अपडेट किया जाएगा.
दस्तावेज़ में, Data Connect एमुलेटर का इस्तेमाल करने के बारे में ज़्यादा जानें
अगले चरण
डिप्लॉय किए गए प्रोजेक्ट की समीक्षा करें और ज़्यादा टूल खोजें:
अपने डेटाबेस में डेटा जोड़ें, अपने स्कीमा की जांच करें और उनमें बदलाव करें. साथ ही, Firebase कंसोल में अपनी Data Connect सेवा को मॉनिटर करें. दस्तावेज़ में ज़्यादा जानकारी ऐक्सेस करें. उदाहरण के लिए, आपने क्विकस्टार्ट पूरा कर लिया है:
स्कीमा, क्वेरी, और म्यूटेशन डेवलपमेंट के बारे में ज़्यादा जानें
इनसे, क्लाइंट SDK टूल और कॉल करने की क्वेरी और म्यूटेशन जनरेट करने के बारे में जानें वेब, Android के लिए क्लाइंट कोड, iOS और Flutter.