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

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

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

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

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. ในช่อง Payload ให้ป้อน start export งานต้องมีการกำหนดเพย์โหลด แต่ Cloud Function ก่อนหน้าไม่ได้ใช้ค่านี้จริงๆ
8. คลิกสร้าง