برنامه ریزی صادرات داده ها

رابط خط فرمان فایربیس

1. رابط خط فرمان فایربیس (Firebase CLI) را نصب کنید . در یک دایرکتوری جدید، رابط خط فرمان (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

کنسول گوگل کلود

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

1. به صفحه توابع ابری در کنسول گوگل کلود بروید:

   به توابع ابری بروید

2. روی نوشتن یک تابع کلیک کنید
3. نام تابعی مانند firestore-export را وارد کنید.
4. در قسمت Trigger ، گزینه Cloud Pub/Sub را انتخاب کنید.
5. در قسمت موضوع ، گزینه ایجاد موضوع جدید (Create new Topic) را انتخاب کنید. نامی برای موضوع اصلی/فرعی، مانند initiateFirestoreExport ، وارد کنید. نام موضوع را یادداشت کنید زیرا برای ایجاد کار Cloud Scheduler خود به آن نیاز دارید.
6. در قسمت کد منبع ، ویرایشگر درون‌خطی (Inline editor) را انتخاب کنید. کد زیر را در قسمت 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(
       YOUR_PROJECT_ID,
       '(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. برای استقرار عملکرد ابری، روی ایجاد کلیک کنید.

ایجاد یک کار Cloud Scheduler

در مرحله بعد، یک کار Cloud Scheduler ایجاد کنید که تابع ابری شما را فراخوانی کند:

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

   به Cloud Scheduler بروید

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

کنسول فایربیس

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

به گزارش‌های عملکرد بروید

کنسول GCP

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

به نمایشگر گزارش‌ها بروید