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

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

   {
     "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. คลิกสร้าง