תזמון של ייצוא נתונים

Firebase CLI

1. מתקינים את ה-CLI של 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 בשם הקטגוריה.
   • משנים את every 24 hours כדי להגדיר את לוח הזמנים לייצוא. אפשר להשתמש ב תחביר cron.yaml של AppEngine או ב פורמט unix-cron (* * * * *).

   • משנים את collectionIds: [] כדי לייצא רק את קבוצות האוספים שצוינו. משאירים את השדה כפי שהוא כדי לייצא את כל האוספים.

4. פורסים את הפונקציה המתוזמנת:

   firebase deploy --only functions

מסוף Google Cloud

יצירת פונקציה של Cloud Functions

1. נכנסים לדף Cloud Functions במסוף Google Cloud:

   כניסה לדף Cloud Functions

2. לוחצים על Create Function (יצירת פונקציה).
3. מזינים שם פונקציה, למשל firestoreExport
4. בקטע Trigger בוחרים באפשרות 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) => {
     const databaseName = client.databasePath(
       process.env.GCP_PROJECT,
       '(default)'
     );
   
     return client
       .exportDocuments({
         name: databaseName,
         outputUriPrefix: bucket,
         // Leave collectionIds empty to export all collections
         // or define a list of collection 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: [] כדי לייצא רק את קבוצות האוספים שצוינו. משאירים את השדה כפי שהוא כדי לייצא את כל האוספים.

7. בקטע package.json, מוסיפים את התלות הבאה:

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

8. בקטע Function to execute, מזינים את הערך scheduledFirestoreExport, שהוא שם הפונקציה ב-index.js.
9. לוחצים על Create כדי לפרוס את הפונקציה של Cloud Functions.

יצירת משימה מסוג Cloud Scheduler

בשלב הבא יוצרים משימה Cloud Scheduler שמפעילה את פונקציית Cloud:

1. נכנסים לדף Cloud Scheduler במסוף Google Cloud:

   כניסה אל Cloud Scheduler

2. לוחצים על Create Job.
3. נותנים שם Name למשימה, למשל scheduledFirestoreExport.
4. מזינים תדירות, למשל every 24 hours.
5. בוחרים אזור זמן.
6. בקטע Target בוחרים באפשרות Pub/Sub. בשדה Topic, מזינים את שם נושא ה-pub/sub שהגדרתם לצד Cloud Function, initiateFirestoreExport בדוגמה שלמעלה.
7. בשדה Payload, מזינים start export. המשימה מחייבת הגדרה של מטען ייעודי, אבל בפועל הפונקציה של Cloud Functions שלמעלה לא משתמשת בערך הזה.
8. לוחצים על יצירה.

מסוף Firebase

עוברים לדף Cloud Functions במסוף Firebase.

כניסה לדף Function Logs

קונסולת GCP

נכנסים לדף Cloud Functions במסוף Google Cloud.

כניסה לדף Logs Viewer