Lên lịch xuất dữ liệu

Giao diện dòng lệnh (CLI) của Firebase

1. Cài đặt CLI Firebase. Trong một thư mục mới, hãy khởi chạy CLI cho Cloud Functions:

   firebase init functions --project PROJECT_ID

   1. Chọn JavaScript làm ngôn ngữ.
   2. Bạn có thể bật ESLint.
   3. Nhập y để cài đặt các phần phụ thuộc.

2. Thay thế mã trong tệp functions/index.js bằng mã sau:

   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. Trong mã ở trên, hãy sửa đổi những nội dung sau:
   • Thay thế BUCKET_NAME bằng tên bộ chứa của bạn.
   • Thay thế YOUR_PROJECT_ID bằng mã dự án của bạn Id
   • Sửa đổi every 24 hours để đặt lịch xuất. Sử dụng cú pháp AppEngine cron.yaml hoặc định dạng unix-cron (* * * * *).

   • Sửa đổi collectionIds: [] để chỉ xuất các nhóm bộ sưu tập được chỉ định. Để nguyên như vậy để xuất tất cả các nhóm bộ sưu tập.

4. Triển khai hàm đã lên lịch:

   firebase deploy --only functions

Bảng điều khiển Google Cloud

Tạo một Cloud Function

1. Chuyển đến trang Cloud Functions trong bảng điều khiển Google Cloud:

   Chuyển đến Cloud Functions

2. Nhấp vào Write a function (Viết hàm)
3. Nhập tên hàm, chẳng hạn như firestore-export
4. Trong phần Trigger (Điều kiện kích hoạt), hãy chọn Cloud Pub/Sub
5. Trong phần Topic (Chủ đề), hãy chọn Create new Topic (Tạo chủ đề mới). Nhập tên cho chủ đề pub/sub, chẳng hạn như initiateFirestoreExport. Ghi lại tên chủ đề vì bạn cần tên này để tạo công việc Cloud Scheduler.
6. Trong phần Source code (Mã nguồn), hãy chọn Inline editor (Trình chỉnh sửa nội tuyến). Nhập mã sau trong 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);
       });
   };

   Trong mã ở trên, hãy sửa đổi những nội dung sau:
   • Thay thế BUCKET_NAME bằng tên bộ chứa của bạn.

   • Sửa đổi collectionIds: [] để chỉ xuất các nhóm bộ sưu tập được chỉ định. Để nguyên như vậy để xuất tất cả các nhóm bộ sưu tập.

7. Trong package.json, hãy thêm phần phụ thuộc sau:

   {
     "dependencies": {
       "@google-cloud/firestore": "^1.3.0"
     }
   }

8. Trong phần Function to execute (Hàm cần thực thi), hãy nhập scheduledFirestoreExport, tên của hàm trong index.js.
9. Nhấp vào Create (Tạo) để triển khai Cloud Function.

Tạo một công việc Cloud Scheduler

Tiếp theo, hãy tạo một Cloud Scheduler công việc gọi Cloud Function:

1. Chuyển đến trang Cloud Scheduler trong bảng điều khiển Cloud Google:

   Chuyển đến Cloud Scheduler

2. Nhấp vào Create Job (Tạo công việc).
3. Nhập Name (Tên) cho công việc, chẳng hạn như scheduledFirestoreExport.
4. Nhập Frequency (Tần suất), ví dụ: every 24 hours.
5. Chọn Timezone (Múi giờ).
6. Trong phần Target (Đích), hãy chọn Pub/Sub. Trong trường Topic, hãy nhập tên của chủ đề pub/sub mà bạn đã xác định cùng với Cloud Function, initiateFirestoreExport trong ví dụ ở trên.
7. Trong trường Payload (Tải trọng), hãy nhập start export. Công việc này yêu cầu một tải trọng được xác định, nhưng Cloud Function ở trên không thực sự sử dụng giá trị này.
8. Nhấp vào Create (Tạo).

Bảng điều khiển của Firebase

Chuyển đến trang Cloud Functions trong bảng điều khiển của Firebase.

Chuyển đến Nhật ký hàm

Bảng điều khiển Google Cloud Platform

Chuyển đến trang Cloud Functions trong bảng điều khiển Cloud.

Chuyển đến Trình xem nhật ký