กำหนดเวลาการส่งออกข้อมูล

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 ด้วยชื่อ Bucket
   • แทนที่ YOUR_PROJECT_ID ด้วยรหัสโปรเจ็กต์ Id
   • แก้ไข every 24 hours เพื่อตั้งเวลาการส่งออก ใช้ไวยากรณ์ AppEngine cron.yaml หรือรูปแบบ unix-cron (* * * * *)

   • แก้ไข collectionIds: [] เพื่อส่งออกเฉพาะกลุ่มคอลเล็กชันที่ระบุ ปล่อยไว้ตามเดิมเพื่อส่งออกกลุ่มคอลเล็กชันทั้งหมด

4. ทำให้ฟังก์ชันที่กำหนดเวลาใช้งานได้โดยทำดังนี้

   firebase deploy --only functions

คอนโซล Google Cloud

สร้าง Cloud Function

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) => {
     const databaseName = client.databasePath(
       YOUR_PROJECT_ID,
       '(default)'
     );
   
     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 ด้วยชื่อ Bucket

   • แก้ไข collectionIds: [] เพื่อส่งออกเฉพาะกลุ่มคอลเล็กชันที่ระบุ ปล่อยไว้ตามเดิมเพื่อส่งออกกลุ่มคอลเล็กชันทั้งหมด

7. ในส่วน package.json ให้เพิ่มทรัพยากร Dependency ต่อไปนี้

   {
     "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 ที่คุณกำหนดไว้ข้าง Cloud Function ซึ่งในตัวอย่างด้านบนคือ initiateFirestoreExport
7. ในช่องเพย์โหลด ให้ป้อน start export งานต้องมีเพย์โหลดที่กำหนดไว้ แต่ Cloud Function ด้านบนไม่ได้ใช้ค่านี้จริงๆ
8. คลิกสร้าง