इस क्विकस्टार्ट में, आपको डेटाबेस का एक छोटा सैंपल बनाना और उसे डिप्लॉय करना होगा. साथ ही, React फ़्रंटएंड से उसे ऐक्सेस करना होगा.
ज़रूरी शर्तें
इस क्विकस्टार्ट को पूरा करने के लिए, आपको इनकी ज़रूरत होगी:
- NPM के साथ Node.js एनवायरमेंट.
- एक Google खाता.
ट्यूटोरियल
| ट्यूटोरियल | |
|---|---|
1. अपने प्रोजेक्ट को शुरू करनाएक नई डायरेक्ट्री बनाएं और उसमें Firebase प्रोजेक्ट शुरू करें. प्रॉम्प्ट मिलने पर, ये विकल्प चुनें:
|
|
2. GraphQL की परिभाषाओं के उदाहरण देखनाSQL Connect में, GraphQL का इस्तेमाल करके अपने डेटाबेस के सभी स्कीमा और कार्रवाइयां तय की जाती हैं. प्रोजेक्ट शुरू करने पर, Firebase CLI ने कुछ उदाहरण वाली परिभाषाएं बनाई हैं, ताकि आपको शुरुआत करने में मदद मिल सके. |
dataconnect/schema/schema.gql (excerpt)
type Movie @table { title: String! imageUrl: String! genre: String } type MovieMetadata @table { movie: Movie! @unique rating: Float releaseYear: Int description: String } query ListMovies @auth(level: PUBLIC) { movies { id title imageUrl genre } } |
3. अपने स्कीमा और कार्रवाइयों को डिप्लॉय करनाडेटाबेस के स्कीमा, क्वेरी या म्यूटेशन में बदलाव करने पर, आपको उन्हें डिप्लॉय करना होगा. इसके बाद ही, डेटाबेस पर आपके बदलाव लागू होंगे. |
|
4. डेटाबेस में सैंपल डेटा जोड़नासैंपल ऐप्लिकेशन की जांच करते समय, इस डेटा की मदद से यह देखा जा सकेगा कि ऐप्लिकेशन कैसा काम कर रहा है. ध्यान दें कि इस चरण में, GraphQL का इस्तेमाल करके कोई भी कार्रवाई की जा सकती है. एडमिन से जुड़े टास्क के लिए, इसकी अनुमति होती है. |
|
5. JavaScript क्लाइंट SDK जनरेट करनाइस कमांड से, GraphQL की परिभाषाओं का इस्तेमाल करके, खास तौर पर आपके डेटाबेस के लिए JavaScript लाइब्रेरी जनरेट की जाती है. इसमें टाइप की परिभाषाएं भी शामिल होती हैं. क्लाइंट ऐप्लिकेशन में, इस लाइब्रेरी का इस्तेमाल करके डेटाबेस से जुड़ी सभी कार्रवाइयां की जाती हैं. ` |
export interface ListMoviesData { movies: ({ id: UUIDString; title: string; imageUrl: string; genre?: string | null; } & Movie_Key)[]; } export function useListMovies( options?: useDataConnectQueryOptions&<ListMoviesData> ): UseDataConnectQueryResult&<ListMoviesData, undefined>; |
6. वेब ऐप्लिकेशन सेट अप करनाअपने Firebase प्रोजेक्ट में नया वेब ऐप्लिकेशन जोड़ने के लिए, ये कमांड चलाएं. |
|
7. React क्लाइंट का सैंपल लिखना
ध्यान दें कि ऐप्लिकेशन, जनरेट किए गए SDK टूल के किसी फ़ंक्शन का इस्तेमाल करके, डेटाबेस को ऐक्सेस करने की ज़रूरी कार्रवाई पूरी करता है. React के लिए जनरेट किया गया SDK टूल, स्टेट मैनेजमेंट को हैंडल करने के लिए TanStack Query का इस्तेमाल करता है. |
import { initializeApp } from 'firebase/app'; import firebaseConfig from './firebase-config.json'; import { QueryClient, QueryClientProvider } from '@tanstack/react-query'; import { useListMovies } from '@dataconnect/generated/react'; import './App.css'; const app = initializeApp(firebaseConfig); const queryClient = new QueryClient(); function App() { return ( <QueryClientProvider client={queryClient}> <Movies /> </QueryClientProvider> ); } function Movies() { const { isLoading, data } = useListMovies(); if (isLoading) { return <h1>...</h1> } return ( <> {data?.movies.map( movie => <h1 key={movie.id}>{movie.title}</h1> )} </> ); } export default App; |
8. वेब ऐप्लिकेशन आज़मानासैंपल ऐप्लिकेशन को देखने के लिए, डेवलपमेंट सर्वर शुरू करें. |
|
अगले चरण
SQL Connect VS Code एक्सटेंशन आज़माना
हमारा सुझाव है कि SQL Connect की मदद से डेवलपमेंट करते समय, SQL Connect VS Code एक्सटेंशन का इस्तेमाल करें. अगर Visual Studio Code को अपने मुख्य डेवलपमेंट एनवायरमेंट के तौर पर इस्तेमाल नहीं किया जाता है, तब भी यह एक्सटेंशन कई ऐसी सुविधाएं देता है जिनसे स्कीमा और कार्रवाई का डेवलपमेंट ज़्यादा आसानी से किया जा सकता है:
- GraphQL लैंग्वेज सर्वर. यह सिंटैक्स की जांच करने और ऑटोकंप्लीट के सुझाव देने की सुविधा देता है, जो खास तौर पर SQL Connect के लिए है
- आपके कोड के साथ CodeLens बटन. इनकी मदद से, स्कीमा परिभाषा वाली फ़ाइलों से डेटा पढ़ा और लिखा जा सकता है. साथ ही, कार्रवाई की परिभाषाओं से क्वेरी और म्यूटेशन लागू किए जा सकते हैं.
- जनरेट किए गए SDK टूल को, GraphQL की परिभाषाओं के साथ अपने-आप सिंक रखना.
- स्थानीय एम्युलेटर को आसानी से सेट अप करना.
- प्रोडक्शन में आसानी से डिप्लॉयमेंट करना.
स्थानीय डेवलपमेंट के लिए, SQL Connect एम्युलेटर का इस्तेमाल करना
इस ट्यूटोरियल में, SQL Connect स्कीमा और कार्रवाइयों को सीधे प्रोडक्शन में डिप्लॉय करने का तरीका बताया गया है. हालांकि, ऐसा हो सकता है कि ऐप्लिकेशन को डेवलप करते समय, आपको प्रोडक्शन डेटाबेस में बदलाव न करना हो. इसके बजाय, SQL Connect एम्युलेटर सेट अप करें और प्रोडक्शन के बजाय, इस पर डेवलपमेंट का काम करें. एम्युलेटर स्थानीय PGlite इंस्टेंस सेट अप करता है. यह लाइव PostgreSQL इंस्टेंस की तरह काम करता है Cloud SQL.
अपने ऐप्लिकेशन के लिए स्कीमा और कार्रवाइयां लिखने का तरीका जानना
SQL Connect की मदद से ऐप्लिकेशन डेवलप करते समय, स्कीमा और कार्रवाइयों का डिज़ाइन डेवलपमेंट के सबसे पहले और सबसे अहम टास्क में से एक है.
- कंसोल में मौजूद Firebase Gemini, एक एआई टूल है. यह आपके ऐप्लिकेशन की नैचुरल लैंग्वेज में दी गई जानकारी से, SQL Connect स्कीमा जनरेट कर सकता है. इस टूल की मदद से, बहुत तेज़ी से काम शुरू किया जा सकता है. खास तौर पर, अगर आपने पहले कभी रिलेशनल डेटाबेस के साथ काम नहीं किया है, तो यह टूल आपके लिए बहुत मददगार साबित हो सकता है.
- इसके अलावा, GraphQL का इस्तेमाल करके सीधे डेटाबेस के स्कीमा, क्वेरी, और म्यूटेशन लिखे जा सकते हैं. स्कीमा डिज़ाइन करनेSQL Connect के बारे में जानकारी से शुरुआत करें, इसके बाद, कार्रवाइयां लिखने का तरीका जानने के लिए, अगले पेजों पर जाएं.
SQL Connect से रीयल-टाइम अपडेट पाने का तरीका जानना
SQL Connect का इस्तेमाल करके, क्लाइंट ऐप्लिकेशन लिखे जा सकते हैं. ये ऐप्लिकेशन, रीयल टाइम में डेटा में होने वाले बदलावों के हिसाब से काम करते हैं. से रीयल-टाइम अपडेट पाना लेख पढ़ें.SQL Connect