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

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

1. Cài đặt Firebase CLI. Trong thư mục mới, hãy khởi chạy CLI cho Chức năng đám mây:

   firebase init functions --project PROJECT_ID

   1. Chọn JavaScript cho ngôn ngữ đó.
   2. 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 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 của bộ chứa.
   • Hãy sửa đổi every 24 hours để đặt lịch xuất. Sử dụng một trong hai Cú pháp AppEngine cron.yaml hoặc định dạng unix-cron (* * * * *).

   • Sửa đổi collectionIds: [] để chỉ xuất dữ liệu được chỉ định bộ sưu tập. Giữ nguyên để xuất tất cả các bộ sưu tập.

4. Triển khai hàm được lên lịch:

   firebase deploy --only functions

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

Tạo một hàm đám mây

1. Truy cập trang Cloud Functions trong Bảng điều khiển GCP:

   Chuyển đến Cloud Functions

2. Nhấp vào Create Function (Tạo hàm)
3. Nhập tên hàm, chẳng hạn như firestoreExport
4. Trong mục Trình 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ủ đề là bạn cần nó để tạo công việc Trình lên lịch biểu trên đám mây của mình.
6. Trong Mã nguồn, chọn Trình chỉnh sửa cùng dòng. Nhập dưới đây 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ững nội dung sau:
   • Thay thế BUCKET_NAME bằng tên của bộ chứa.

   • Sửa đổi collectionIds: [] để chỉ xuất dữ liệu được chỉ định bộ sưu tập. Giữ nguyên để xuất tất cả các bộ sưu tập.

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

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

8. Trong phần Hàm để thực thi, hãy nhập scheduledFirestoreExport, phương thức tên của hàm trong index.js.
9. Nhấp vào Tạo để triển khai Hàm đám mây.

Tạo công việc của Cloud Scheduler

Tiếp theo, hãy tạo một công việc Trình lập lịch biểu đám mây để gọi Hàm đám mây của bạn:

1. Truy cập trang Cloud Scheduler (Trình lập lịch biểu đám mây) trong Bảng điều khiển của GCP:

   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ột Múi giờ.
6. Trong phần Target (Mục tiêu), hãy chọn Pub/Sub. Trong trường Chủ đề, nhập tên của chủ đề xuất bản/phụ đề mà bạn đã xác định cùng với Hàm đám mây, 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 đòi hỏi một tải trọng được xác định, nhưng Hàm đám mây ở trên thì cần không thực sự sử dụng tính năng này giá trị.
8. Nhấp vào Tạo.

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

Truy cập vào 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 (GCP)

Truy cập vào trang Cloud Functions (Chức năng đám mây) trong Bảng điều khiển của GCP.

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