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

Firebase CLI

1. ติดตั้ง Firebase CLI ในไดเรกทอรีใหม่ ให้เริ่มต้น CLI สำหรับ Cloud Functions:

   firebase init functions --project PROJECT_ID

   1. เลือก JavaScript สำหรับภาษา
   2. เปิดใช้ ESLint (ไม่บังคับ)
   3. ป้อน y เพื่อติดตั้งทรัพยากร Dependency

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 ของ App Engine หรือ รูปแบบ unix-cron (* * * * *)

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

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

   firebase deploy --only functions

คอนโซล Google Cloud

สร้างฟังก์ชันระบบคลาวด์

1. ไปที่หน้า Cloud Functions ใน Google Cloud Console

   ไปที่ Cloud Functions

2. คลิกสร้างฟังก์ชัน
3. ป้อนชื่อฟังก์ชัน เช่น firestoreExport
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(
       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 Function

สร้างงาน Cloud Scheduler

จากนั้นสร้างCloud Scheduler งานที่เรียกใช้ Cloud Function ดังนี้

1. ไปที่หน้า Cloud Scheduler ใน Google Cloud Console โดยทำดังนี้

   ไปที่ Cloud Scheduler

2. คลิกสร้างงาน
3. ป้อนชื่อสำหรับงาน เช่น scheduledFirestoreExport
4. ป้อนความถี่ เช่น every 24 hours
5. เลือกเขตเวลา
6. ในส่วนเป้าหมาย ให้เลือก Pub/Sub ในช่องหัวข้อ ให้ป้อนชื่อหัวข้อ Pub/Sub ที่คุณกำหนดไว้ข้าง Cloud Function initiateFirestoreExport ในตัวอย่าง ด้านบน
7. ในช่อง Payload ให้ป้อน start export งานต้องมีเพย์โหลดที่กำหนดไว้ แต่ Cloud Function ด้านบนไม่ได้ใช้ค่านี้จริงๆ
8. คลิกสร้าง

คอนโซล Firebase

ไปที่หน้า Cloud Functions ในคอนโซล Firebase

ไปที่บันทึกฟังก์ชัน

คอนโซล GCP

ไปที่หน้า Cloud Functions ใน Google Cloud Console

ไปที่ผู้ดูบันทึก