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

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 Functions बनाते समय आपने DATABASE_ID एनवायरमेंट वैरिएबल सेट किया हो. अगर ऐसे रनटाइम का इस्तेमाल किया जा रहा है जहां GOOGLE_CLOUD_PROJECT अपने-आप सेट नहीं होता है, तो आपको इसे मैन्युअल तरीके से सेट करना पड़ सकता है. इसके अलावा, कोड में इसे अपने प्रोजेक्ट आईडी से बदलना भी पड़ सकता है.

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

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

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

Cloud Scheduler जॉब बनाना

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

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

   Cloud Scheduler पर जाएं

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