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

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

1. Cài đặt Giao diện dòng lệnh (CLI) của 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 cho ngôn ngữ.
   2. Bạn có thể bật ESLint (không bắt buộc).
   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 nội dung sau:
   • Thay thế BUCKET_NAME bằng tên của bộ chứa.
   • Sửa đổi every 24 hours để đặt lịch xuất. Sử dụng cú pháp cron.yaml của AppEngine hoặc định dạng unix-cron (* * * * *).

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

4. Triển khai hàm theo lịch:

   firebase deploy --only functions

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

Tạo một Hàm trên đám mây

1. Chuyển đến trang Cloud Functions (Hàm trên đám mây) trong Google Cloud Console:

   Chuyển đến Cloud Functions

2. Nhấp vào Tạo hàm
3. Nhập tên hàm, chẳng hạn như firestoreExport
4. Trong mục Điều kiện kích hoạt, hãy chọn Cloud Pub/Sub
5. Trong mục Chủ đề, hãy chọn 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 sẽ cần tên này để tạo công việc Cloud Scheduler.
6. Trong phần Mã nguồn, hãy chọn Trình chỉnh sửa cùng dòng. 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(
       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);
       });
   };

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

   • Sửa đổi collectionIds: [] để chỉ xuất các nhóm bộ sưu tập đã chỉ định. Để nguyên để xuất tất cả 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 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 Tạo để triển khai Hàm trên đám mây.

Tạo công việc Cloud Scheduler

Tiếp theo, hãy tạo một công việc Cloud Scheduler gọi Chức năng trên đám mây:

1. Chuyển đến trang Cloud Scheduler trong Google Cloud Console:

   Chuyển đến Cloud Scheduler

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

Bảng điều khiển 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 Google Cloud Console.

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