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

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

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

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

   firebase deploy --only functions

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

   ไปที่ 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

   ไปที่ Cloud Scheduler

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

คอนโซล Firebase

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

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

คอนโซล GCP

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

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