جدولة عمليات تصدير البيانات

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 باسم الحزمة.
   • عدِّل every 24 hours لتحديد جدول التصدير. استخدِم إما بنية cron.yaml في AppEngine أو تنسيق unix-cron (* * * * *).

   • عدِّل collectionIds: [] لتصدير مجموعات المجموعات المحدّدة فقط. اترك الخيار كما هو لتصدير جميع المجموعات.

4. يمكنك نشر الدالة المُجدوَلة باتّباع الخطوات التالية:

   firebase deploy --only functions

Google Cloud Console

إنشاء دالة Cloud

1. انتقِل إلى صفحة Cloud Functions في وحدة تحكّم Google Cloud:

   الانتقال إلى Cloud Functions

2. انقر على إنشاء دالة.
3. أدخِل اسم دالة مثل firestoreExport.
4. ضمن العامل المشغِّل، اختَر Cloud Pub/Sub.
5. ضمن الموضوع، اختَر إنشاء موضوع جديد. أدخِل اسمًا لموضوع الناشر/الفرعي، مثل 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. ضمن الدالة المطلوب تنفيذها، أدخِل scheduledFirestoreExport، وهو اسم الدالة في index.js.
9. انقر على إنشاء لنشر دالة Cloud.

إنشاء وظيفة Cloud Scheduler

بعد ذلك، أنشئ وظيفة Cloud Scheduler تستدعي دالة Cloud:

1. انتقِل إلى صفحة Cloud Scheduler في Google Cloud Console:

   الانتقال إلى Cloud Scheduler

2. انقر على إنشاء وظيفة.
3. أدخِل اسمًا للوظيفة، مثل scheduledFirestoreExport.
4. أدخِل معدّل التكرار، على سبيل المثال، every 24 hours.
5. اختَر منطقة زمنية.
6. ضمن الاستهداف، اختَر Pub/Sub. في الحقل الموضوع، أدخِل اسم الموضوع الفرعي الذي حددته إلى جانب دالّة السحابة الإلكترونية، initiateFirestoreExport في المثال أعلاه.
7. في حقل Payload (الحمولة)، أدخِل start export. تتطلّب الوظيفة تحديد حمولة، ولكن دالة Cloud Function أعلاه لا تستخدم هذه القيمة في الواقع.
8. انقر على إنشاء.

وحدة تحكُّم Firebase

انتقِل إلى صفحة Cloud Functions في وحدة تحكُّم Firebase.

الانتقال إلى "سجلّات الدوال"

وحدة تحكُّم Google Cloud Platform

انتقِل إلى صفحة Cloud Functions في وحدة تحكّم Google Cloud.

الانتقال إلى "عارض السجلّات"