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

Firebase CLI

1. ثبِّت Firebase CLI. في دليل جديد، افتح واجهة سطر الأوامر (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 Console

إنشاء دالة 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. إذا كنت تستخدم بيئة تشغيل لا يتم فيها ضبط GOOGLE_CLOUD_PROJECT تلقائيًا، قد تحتاج أيضًا إلى ضبطه يدويًا أو استبداله برقم تعريف مشروعك في الرمز البرمجي.

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:

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

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