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

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 ด้วยรหัสโปรเจ็กต์
   • แก้ไข 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. คลิก Write a function
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 ด้วยชื่อ Bucket

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

   • (ไม่บังคับ) หากคุณใช้ฐานข้อมูลที่ไม่ใช่ฐานข้อมูลเริ่มต้น ให้ตรวจสอบว่าได้ตั้งค่า ตัวแปรสภาพแวดล้อม DATABASE_ID เมื่อสร้าง Cloud Function หากคุณใช้รันไทม์ที่ไม่ได้ตั้งค่า GOOGLE_CLOUD_PROJECT โดยอัตโนมัติ คุณ อาจต้องตั้งค่าด้วยตนเองหรือแทนที่ด้วยรหัสโปรเจ็กต์ ในโค้ด

7. เพิ่มทรัพยากร Dependency ต่อไปนี้ในส่วน 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. คลิกสร้าง