زمان‌بندی صادر کردن داده‌ها

واسط خط فرمان Firebase

1. واسط خط فرمان Firebase را نصب کنید. در دایرکتوری جدید، CLI را برای Cloud Functions مقداردهی اولیه کنید:

   firebase init functions --project PROJECT_ID

   1. جاوا اسکریپت را به‌عنوان زبان انتخاب کنید.
   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

ایجاد کردن تابع ابری

1. به صفحه Cloud Functions در کنسول Google Cloud بروید:

   رفتن به 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: [] را اصلاح کنید تا فقط گروه‌های مجموعه مشخص‌شده صادر شود. برای صادر کردن همه گروه‌های مجموعه، آن را همان‌طور که هست رها کنید.

   • (اختیاری) اگر از پایگاه داده غیرپیش‌فرض استفاده می‌کنید، مطمئن شوید که متغیر محیطی DATABASE_ID را هنگام ایجاد Cloud Function تنظیم کرده‌اید. اگر از زمان اجرایی استفاده می‌کنید که GOOGLE_CLOUD_PROJECT به‌طور خودکار تنظیم نشده است، ممکن است لازم باشد آن را به‌صورت دستی تنظیم کنید یا آن را با شناسه پروژه خود در کد جایگزین کنید.

7. در بخش package.json، وابستگی زیر را اضافه کنید:

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

8. در بخش تابع برای اجرا، scheduledFirestoreExport، نام تابع در index.js را وارد کنید.
9. برای استقرار Cloud Function، روی ایجاد کلیک کنید.

ایجاد شغل Cloud Scheduler

سپس، کار Cloud Scheduler ایجاد کنید که Cloud Function شما را فراخوانی کند:

1. به صفحه Cloud Scheduler در کنسول Google Cloud بروید:

   رفتن به Cloud Scheduler

2. روی ایجاد شغل کلیک کنید.
3. نامی برای کار وارد کنید، مثلاً scheduledFirestoreExport.
4. بسامد را وارد کنید، برای مثال every 24 hours.
5. منطقه زمانی را انتخاب کنید.
6. در بخش هدف، Pub/Sub را انتخاب کنید. در فیلد موضوع، نام موضوع pub/sub را که در کنار «تابع ابری» خود تعریف کرده‌اید وارد کنید، initiateFirestoreExport در مثال قبلی.
7. در فیلد بار داده، start export را وارد کنید. این کار به محموله تعریف‌شده نیاز دارد، اما Cloud Function قبلی درواقع از این مقدار استفاده نمی‌کند.
8. روی ایجاد کردن کلیک کنید.