Firebase SQL Connect में, अपने वर्कफ़्लो और एनवायरमेंट के हिसाब से, अलग-अलग तरीकों से डेटा को एक साथ लोड और अपडेट किया जा सकता है:
लोकल प्रोटोटाइपिंग में, वैकल्पिक स्कीमा आज़माते समय, डेटा सीडिंग म्यूटेशन बनाए जा सकते हैं. साथ ही, उन्हें SQL Connect VS Code एक्सटेंशन, SQL Connect एम्युलेटर, और लोकल डेटाबेस इंस्टेंस का इस्तेमाल करके, लोकल डेवलपमेंट एनवायरमेंट में कॉल किया जा सकता है.
प्रोडक्शन डेवलपमेंट में, स्टेबल स्कीमा के साथ, बड़े सीआई/सीडी फ़्लो को मैनेज करते समय और प्रोडक्शन डेटा को मैनेज करते समय, आपके पास दो विकल्प होते हैं:
सबसे सही तरीका यह है कि Firebase Admin SDK का इस्तेमाल किया जाए. यह लाइब्रेरी का एक सेट है, जो खास सुविधाओं वाले एनवायरमेंट में काम करता है.
अपने Cloud SQL इंस्टेंस के साथ एसक्यूएल टूल का इस्तेमाल करके, एक साथ कई डेटा लोड और अपडेट किए जा सकते हैं. हालांकि, इसके लिए ज़रूरी है कि आप डेटा में बदलाव करें, न कि डेटाबेस स्कीमा में. एसक्यूएल टूल की मदद से, डेटाबेस स्कीमा में सीधे तौर पर बदलाव करने से, आपके SQL Connect स्कीमा और कनेक्टर काम करना बंद कर सकते हैं.
लोकल प्रोटोटाइपिंग: लोकल इंस्टेंस में सीड डेटा
शुरू करने के लिए गाइड में, आपने एक ऐप्लिकेशन सेट अप किया है, ताकि ऐड हॉक इंसर्ट म्यूटेशन का इस्तेमाल करके, एक टेबल में एक रिकॉर्ड जोड़ा जा सके.
फ़िल्म की समीक्षा करने वाले ऐप्लिकेशन को इस्तेमाल करने के लिए, फ़िल्मों, समीक्षाओं, और उपयोगकर्ताओं का डेटा चाहिए. इससे क्वेरी और म्यूटेशन के प्रोटोटाइप बनाए जा सकते हैं. ये प्रोटोटाइप, असल डेटा वाली कई टेबल पर जॉइन और अन्य ऑपरेशन का इस्तेमाल करते हैं. अपने स्कीमा को बड़ा किया जा सकता है और डेटाबेस को सीड किया जा सकता है.
डेटा सीडिंग करने के लिए, आपके प्रोटोटाइपिंग एनवायरमेंट में कोड की ज़रूरत होती है. इस गाइड में कुछ सैंपल दिए गए हैं, जिनसे यह जानकारी मिलती है:
- अलग-अलग टेबल पर
_insertManyऔर_upsertManyका इस्तेमाल करना - मिलती-जुलती टेबल पर
_insertManyका इस्तेमाल करना
फ़िल्म की समीक्षा वाले ऐप्लिकेशन के स्कीमा को अपडेट करना
एक बार में एक डेटाबेस टेबल को अपडेट करने के लिए, _insertMany और _upsertMany म्यूटेशन का इस्तेमाल किया जा सकता है. इसके अलावा, जॉइन रिलेशनशिप से जुड़ी कई टेबल को अपडेट किया जा सकता है. फ़िल्म की समीक्षा वाले ऐप्लिकेशन का बड़ा किया गया स्कीमा, इस्तेमाल के इन उदाहरणों को समझाने में मदद करता है. इसे नीचे दिखाया गया है. यह schema.gql को शुरुआती Movie टाइप से आगे बढ़ाकर, Actor और MovieActor टाइप को शामिल करता है. इससे हम ज़्यादा जटिल क्वेरी का प्रोटोटाइप बना सकते हैं.
# Actors
# Suppose an actor can participate in multiple movies and movies can have multiple actors
# Movie - Actors (or vice versa) is a many to many relationship
type Actor @table {
id: UUID!
imageUrl: String!
name: String! @col(name: "name", dataType: "varchar(30)")
}
# Join table for many-to-many relationship for movies and actors
# The 'key' param signifies the primary key(s) of this table
# In this case, the keys are [movieId, actorId], the generated fields of the reference types [movie, actor]
type MovieActor @table(key: ["movie", "actor"]) {
# @ref creates a field in the current table (MovieActor) that holds the primary key of the referenced type
# In this case, @ref(fields: "movieId", references: "id") is implied
movie: Movie!
# movieId: UUID! <- this is created by the implied @ref
actor: Actor!
# actorId: UUID! <- this is created by the implied @ref
role: String! # "main" or "supporting"
}
ज़ीरो स्टेट डेटा को सीड करने के लिए म्यूटेशन लिखना
प्रोटोटाइपिंग के दौरान, जब आपकी क्वेरी और म्यूटेशन को अलग-अलग वैल्यू की रेंज के हिसाब से टेस्ट करना हो, तो डेटा को कई रिकॉर्ड के साथ भरा जा सकता है. उदाहरण के लिए, हो सकता है कि आपको तुलना और फ़िल्टर करने की सुविधा को टेस्ट करने के लिए, अलग-अलग शैलियों और रेटिंग वाली कई फ़िल्मों के रिकॉर्ड जोड़ने हों.
Movie और Actor टेबल में डेटा सीड करें
प्रोटोटाइप बनाने के चरण के आधार पर, शुरुआती निर्देश में बताई गई तकनीक
का इस्तेमाल करके, एक या दो रिकॉर्ड डाले जा सकते हैं: इसका मतलब है कि
SQL Connect VS Code एक्सटेंशन में CodeLenses का इस्तेमाल करके, _insert म्यूटेशन बनाए जा सकते हैं,
डेटा को हार्ड-कोड किया जा सकता है, और VS Code में उन म्यूटेशन को चलाया जा सकता है.
आखिर में, _insertMany ऑपरेशन का इस्तेमाल करके, टेबल में कई रिकॉर्ड जोड़ना ज़्यादा सही रहता है. फ़िल्म की समीक्षा वाले ऐप्लिकेशन के उदाहरण में, यह Movie और Actor में डेटा का शुरुआती सेट डालता है.
SQL Connect VS Code एक्सटेंशन का इस्तेमाल करके, नीचे दिए गए म्यूटेशन को लागू करने के लिए, फ़ाइल एडिटर के सही व्यू में, Run (Production) या Run (Local) CodeLens बटन पर क्लिक करें. यह इस बात पर निर्भर करता है कि प्रोटोटाइप बनाने के लिए, प्रोडक्शन सेवा का इस्तेमाल किया जा रहा है या लोकल डेटाबेस का.
# insertMany for Movie
# 2 records shown
mutation {
movie_insertMany(data: [
{
id: "550e8400-e29b-41d4-a716-446655440000",
title: "Inception",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Finception.jpg?alt=media&token=07b09781-b302-4623-a5c3-1956d0143168",
genre: "sci-fi",
},
{
id: "550e8400-e29b-41d4-a716-446655440001",
title: "The Matrix",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Fthe_matrix.jpg?alt=media&token=4975645d-fef8-409e-84a5-bcc1046e2059",
genre: "action",
}
])
}
# insertMany for Actor
# 2 records shown
mutation {
actor_insertMany(data: [
{
id: "123e4567-e89b-12d3-a456-426614174000",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/actors%2Fdicaprio.jpeg?alt=media&token=452e030a-efa5-4ef4-bb81-502b23241316",
name: "Leonardo DiCaprio"
},
{
id: "123e4567-e89b-12d3-a456-426614174001",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/actors%2Fkeanu.jpg?alt=media&token=6056520c-ef3e-4823-aad0-108aab163115",
name: "Keanu Reeves"
}
])
}
MovieActor की जॉइन टेबल में डेटा डालें
जॉइन और अन्य जटिल कार्रवाइयों का इस्तेमाल करके क्वेरी और म्यूटेशन की जांच करने के लिए, MovieActor टेबल में कई रिकॉर्ड जोड़े जा सकते हैं.
इस तरह के संबंध में कई टेबल अपडेट करते समय, @transaction डायरेक्टिव को जोड़ा जा सकता है. इससे यह पक्का किया जा सकता है कि अपडेट सही तरीके से पूरा हो.
mutation @transaction {
movie_insertMany(data: [
{
id: "550e8400-e29b-41d4-a716-446655440000",
title: "Inception",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Finception.jpg?alt=media&token=07b09781-b302-4623-a5c3-1956d0143168",
genre: "sci-fi",
},
{
id: "550e8400-e29b-41d4-a716-446655440001",
title: "The Matrix",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Fthe_matrix.jpg?alt=media&token=4975645d-fef8-409e-84a5-bcc1046e2059",
genre: "action",
}
])
actor_insertMany(data: [
{
id: "123e4567-e89b-12d3-a456-426614174000",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/actors%2Fdicaprio.jpeg?alt=media&token=452e030a-efa5-4ef4-bb81-502b23241316",
name: "Leonardo DiCaprio"
},
{
id: "123e4567-e89b-12d3-a456-426614174001",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/actors%2Fkeanu.jpg?alt=media&token=6056520c-ef3e-4823-aad0-108aab163115",
name: "Keanu Reeves"
}
])
}
नेस्ट किए गए ऑपरेशन (वन-टू-मेनी और वन-टू-वन) का इस्तेमाल करके, मिलती-जुलती टेबल में डेटा सीड करना
एक साथ कई टेबल में डेटा डालने के लिए, लिटरल पेलोड का इस्तेमाल करके नेस्टेड रिलेशनल इंसर्ट किया जा सकता है इससे पैरंट रिकॉर्ड और उससे जुड़े चाइल्ड रिकॉर्ड, एक ही कार्रवाई में बन जाते हैं. इसके लिए, फ़ॉरेन की को मैन्युअल तरीके से जोड़ने की ज़रूरत नहीं होती.
वन-टू-मेनी रिलेशनशिप के लिए, नेस्ट किए गए चाइल्ड रिकॉर्ड का कलेक्शन उपलब्ध कराया जाता है. वन-टू-वन रिलेशनशिप के लिए, एक नेस्ट किया गया चाइल्ड ऑब्जेक्ट उपलब्ध कराया जाता है.
# Nested insert for Movie and Review (one-to-many)
# 1 movie and 2 reviews shown
mutation {
movie_insert(data: {
id: "550e8400-e29b-41d4-a716-446655440000",
title: "Inception",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Finception.jpg?alt=media&token=07b09781-b302-4623-a5c3-1956d0143168",
genre: "sci-fi",
reviews_on_movie: [
{
id: "123e4567-e89b-12d3-a456-426614174002",
rating: 5,
reviewText: "Amazing concept!",
user: { id: "user-uuid-123" }
},
{
id: "123e4567-e89b-12d3-a456-426614174003",
rating: 4,
reviewText: "A bit confusing, but great.",
user: { id: "user-uuid-456" }
}
]
})
}
# Nested insert for User and Profile (one-to-one)
mutation {
user_insert(data: {
id: "user-uuid-123",
name: "Alice",
profile_on_user: {
bio: "Avid moviegoer and critic."
}
})
}
सीड डेटा को रीसेट करने के लिए म्यूटेशन लिखना
प्रोटोटाइप बनाते समय और सीआई/सीडी की प्रोसेस के दौरान, डेटा को शून्य स्थिति पर रीसेट करना मददगार हो सकता है. इससे डेटा के नए सेट पर, टेस्ट की नई सीरीज़ को चलाया जा सकता है.
अगर आपका प्रोटोटाइप कोड आपकी टेबल में रिकॉर्ड नहीं जोड़ता है, तो ऐसा करने के लिए SQL Connect से मिले _upsertMany म्यूटेशन का इस्तेमाल करें.
इस उदाहरण में, फ़िल्म के रिकॉर्ड को उनकी मूल स्थिति में अपडेट करने के लिए, शुरुआती वैल्यू के साथ movie_upsertMany को कॉल किया गया है.
mutation {
# Execute an upsertMany operation to update the Movie table
movie_upsertMany(data: [
{
id: "550e8400-e29b-41d4-a716-446655440000",
title: "Inception",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Finception.jpg?alt=media&token=07b09781-b302-4623-a5c3-1956d0143168",
genre: "sci-fi",
},
{
id: "550e8400-e29b-41d4-a716-446655440001",
title: "The Matrix",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Fthe_matrix.jpg?alt=media&token=4975645d-fef8-409e-84a5-bcc1046e2059",
genre: "action",
}
…
}
प्रोडक्शन डेवलपमेंट: जानकारी भरने और अपडेट करने के लिए, Admin SDK का इस्तेमाल करें
Firebase Admin SDK का इस्तेमाल तब किया जा सकता है, जब आपको खास ऐक्सेस वाले एनवायरमेंट में काम करना हो. यह एक अहम इस्तेमाल का उदाहरण है. ऐसा तब होता है, जब आपको प्रोडक्शन डेटा पर बल्क डेटा ऑपरेशन की अहमियत को ध्यान में रखते हुए, हज़ारों रिकॉर्ड लोड करने हों.
Firebase Admin SDK को इंस्टॉल करना
भले ही, मुख्य रूप से लोकल एनवायरमेंट में काम किया जा रहा हो, Firebase का सुझाव है कि Admin SDK को सेट अप करें. इससे, Firebase SQL Connect को खास ऐक्सेस वाले एनवायरमेंट से इस्तेमाल किया जा सकता है. इसमें आपका लोकल एनवायरमेंट भी शामिल है. आपको Node.js के लिए, Admin SDK सेट अप करना होगा.
इस्तेमाल के अन्य SQL Connect मामलों में Admin SDK का इस्तेमाल करने के बारे में ज़्यादा जानें.
प्रोडक्शन डेटा को एक साथ लोड और अपडेट करना
बल्क डेटा मैनेजमेंट के लिए एपीआई, आपकी ओर से GraphQL म्यूटेशन बनाता है. यह आपको कुछ पंक्तियों को स्थानीय तौर पर जोड़ने के लिए, पहले बताए गए executeGraphQL एपीआई की मदद से mutation {...} स्ट्रिंग बनाने के लिए नहीं कहता.
एडमिन एपीआई का एक मुख्य फ़ायदा यह है कि सीआई/सीडी फ़्लो के लिए, डेटा के कलेक्शन को अलग से मैनेज और फिर से इस्तेमाल किया जा सकता है. इसके अलावा, प्रोडक्शन डेटा के लिए बड़ी डेटा फ़ाइलें सेट अप की जा सकती हैं.
यहां दिए गए स्निपेट से, बल्क-डेटा स्क्रिप्ट सेट अप करने का तरीका पता चलता है.
import { initializeApp } from 'firebase-admin/app';
import { getDataConnect } from 'firebase-admin/data-connect';
const app = initializeApp();
const dc = getDataConnect({ location: "us-west2", serviceId: "my-service" });
const data = [
{
id: "550e8400-e29b-41d4-a716-446655440000",
title: "Inception",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Finception.jpg?alt=media&token=07b09781-b302-4623-a5c3-1956d0143168",
genre: "sci-fi",
// Nested reviews can be inserted atomically along with the movie
reviews_on_movie: [
{
rating: 5,
reviewText: "Amazing concept!",
user: { id: "user-123" } // Link to existing user
}
]
},
{
id: "550e8400-e29b-41d4-a716-446655440001",
title: "The Matrix",
imageUrl: "https://firebasestorage.googleapis.com/v0/b/fdc-quickstart-web.appspot.com/o/movies%2Fthe_matrix.jpg?alt=media&token=4975645d-fef8-409e-84a5-bcc1046e2059",
genre: "action",
reviews_on_movie: [
{
rating: 5,
reviewText: "A masterpiece of sci-fi action.",
user: { id: "user-456" }
}
]
}
];
// Methods of the bulk operations API
const resp = await dc.insert("movie" /*table name*/, data[0]);
// Or
const resp = await dc.insertMany("movie" /*table name*/, data);
// Or
const resp = await dc.upsert("movie" /*table name*/, data[0]);
// Or
const resp = await dc.upsertMany("movie" /*table name*/, data);
प्रोडक्शन डेवलपमेंट: डेटा को एक साथ अपडेट करने के लिए, एसक्यूएल का इस्तेमाल करना
अगर प्रोडक्शन में स्कीमा में कोई बदलाव नहीं किया जा रहा है, तो डेटा लोड और अपडेट मैनेज करने के लिए, Cloud SQL इंस्टेंस में काम किया जा सकता है.
डेटा इंपोर्ट करने के लिए, Cloud SQL for PostgreSQL की गाइड देखें.
आगे क्या करना है?
- Admin SDK को अपने SQL Connect प्रोजेक्ट में इंटिग्रेट करने के बारे में जानें.