डेटा एक्सपोर्ट शेड्यूल करना

Firebase CLI

1. Firebase CLI इंस्टॉल करें. नई डायरेक्ट्री में, Cloud Functions के लिए सीएलआई को शुरू करें:

   firebase init functions --project PROJECT_ID

   1. JavaScript को भाषा के तौर पर चुनें.
   2. इसके अलावा, ESLint को चालू किया जा सकता है.
   3. डिपेंडेंसी इंस्टॉल करने के लिए, y डालें.

2. functions/index.js फ़ाइल में मौजूद कोड को इस कोड से बदलें:

   const functions = require('firebase-functions');
   const firestore = require('@google-cloud/firestore');
   const client = new firestore.v1.FirestoreAdminClient();
   
   // Replace BUCKET_NAME
   const bucket = 'gs://BUCKET_NAME';
   
   exports.scheduledFirestoreExport = functions.pubsub
                                               .schedule('every 24 hours')
                                               .onRun((context) => {
   
     const projectId = process.env.GCP_PROJECT;
     const databaseName = 
       client.databasePath(projectId, '(default)');
   
     return client.exportDocuments({
       name: databaseName,
       outputUriPrefix: bucket,
       // Leave collectionIds empty to export all collections
       // or set to a list of collection IDs to export,
       // collectionIds: ['users', 'posts']
       collectionIds: []
       })
     .then(responses => {
       const response = responses[0];
       console.log(`Operation Name: ${response['name']}`);
     })
     .catch(err => {
       console.error(err);
       throw new Error('Export operation failed');
     });
   });
   index.js

3. ऊपर दिए गए कोड में, इनमें बदलाव करें:
   • BUCKET_NAME की जगह अपनी बकेट का नाम डालें.
   • YOUR_PROJECT_ID की जगह अपना प्रोजेक्ट आईडी डालें
   • एक्सपोर्ट का शेड्यूल सेट करने के लिए, every 24 hours में बदलाव करें. AppEngine cron.yaml सिंटैक्स या unix-cron फ़ॉर्मैट (* * * * *) का इस्तेमाल करें.

   • सिर्फ़ चुने गए कलेक्शन ग्रुप को एक्सपोर्ट करने के लिए, collectionIds: [] में बदलाव करें. सभी कलेक्शन ग्रुप एक्सपोर्ट करने के लिए, इसे ऐसे ही छोड़ दें.

4. शेड्यूल किए गए फ़ंक्शन को डिप्लॉय करें:

   firebase deploy --only functions

Google Cloud कंसोल

Cloud फ़ंक्शन बनाना

1. Google Cloud Console में Cloud Functions पेज पर जाएं:

   Cloud Functions पर जाएं

2. कोई फ़ंक्शन लिखें पर क्लिक करें
3. फ़ंक्शन का नाम डालें, जैसे कि firestore-export
4. ट्रिगर में जाकर, Cloud Pub/Sub को चुनें
5. विषय में जाकर, नया विषय बनाएं को चुनें. Pub/Sub के विषय के लिए कोई नाम डालें, जैसे कि initiateFirestoreExport. विषय का नाम नोट करें, क्योंकि आपको Cloud Scheduler जॉब बनाने के लिए इसकी ज़रूरत पड़ेगी.
6. सोर्स कोड में जाकर, इन-लाइन एडिटर (वहीं के वहीं ठीक करें) को चुनें. index.js में जाकर, यह कोड डालें:

   const firestore = require('@google-cloud/firestore');
   const client = new firestore.v1.FirestoreAdminClient();
   // Replace BUCKET_NAME
   const bucket = 'gs://BUCKET_NAME'
   
   exports.scheduledFirestoreExport = (event, context) => {
     // Access the GCLOUD_PROJECT environment variable set by the runtime.
     const projectId =
       process.env.GOOGLE_CLOUD_PROJECT || process.env.GCLOUD_PROJECT;
     // Use the DATABASE_ID environment variable if set,
     // otherwise default to '(default)'
     const databaseId = process.env.DATABASE_ID || '(default)';
     const databaseName = client.databasePath(
       projectId,
       databaseId
     );
   
     return client
       .exportDocuments({
         name: databaseName,
         outputUriPrefix: bucket,
         // Leave collectionIds empty to export all collection groups
         // or define a list of collection group IDs:
         // collectionIds: ['users', 'posts']
         collectionIds: [],
       })
       .then(responses => {
         const response = responses[0];
         console.log(`Operation Name: ${response['name']}`);
         return response;
       })
       .catch(err => {
         console.error(err);
       });
   };

   ऊपर दिए गए कोड में, इनमें बदलाव करें:
   • BUCKET_NAME की जगह अपनी बकेट का नाम डालें.

   • सिर्फ़ चुने गए कलेक्शन ग्रुप को एक्सपोर्ट करने के लिए, collectionIds: [] में बदलाव करें. सभी कलेक्शन ग्रुप एक्सपोर्ट करने के लिए, इसे ऐसे ही छोड़ दें.

   • (ज़रूरी नहीं) अगर किसी ऐसे डेटाबेस का इस्तेमाल किया जा रहा है जो डिफ़ॉल्ट नहीं है, तो Cloud फ़ंक्शन बनाते समय DATABASE_ID एनवायरमेंट वैरिएबल सेट करना न भूलें. अगर ऐसे रनटाइम का इस्तेमाल किया जा रहा है जहां GOOGLE_CLOUD_PROJECT अपने-आप सेट नहीं होता है, तो आपको इसे मैन्युअल तरीके से सेट करना पड़ सकता है या कोड में इसे अपने प्रोजेक्ट आईडी से बदलना पड़ सकता है.

7. package.json में, यह डिपेंडेंसी जोड़ें:

   {
     "dependencies": {
       "@google-cloud/firestore": "^1.3.0"
     }
   }

8. एक्ज़ीक्यूट करने के लिए फ़ंक्शन में, scheduledFirestoreExport डालें. यह index.js में मौजूद फ़ंक्शन का नाम है.
9. Cloud फ़ंक्शन को डिप्लॉय करने के लिए, Create पर क्लिक करें.

Cloud Scheduler जॉब बनाएं

इसके बाद, एक Cloud Scheduler जॉब बनाएं, जो आपके Cloud फ़ंक्शन को कॉल करे:

1. Google Cloud Console में Cloud Scheduler पेज पर जाएं:

   Cloud Scheduler पर जाएं

2. जॉब बनाएं पर क्लिक करें.
3. जॉब के लिए कोई नाम डालें, जैसे कि scheduledFirestoreExport.
4. फ़्रीक्वेंसी डालें. उदाहरण के लिए, every 24 hours.
5. कोई टाइमज़ोन चुनें.
6. टारगेट में जाकर, Pub/Sub को चुनें. विषय फ़ील्ड में, उस pub/sub विषय का नाम डालें जिसे आपने पिछले उदाहरण में, Cloud फ़ंक्शन, initiateFirestoreExport के साथ तय किया था.
7. पेलोड फ़ील्ड में, start export डालें. जॉब के लिए पेलोड तय करना ज़रूरी है. हालांकि, इससे पहले वाला Cloud फ़ंक्शन, इस वैल्यू का इस्तेमाल नहीं करता.
8. बनाएं पर क्लिक करें.