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ậ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 đoạn 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 đoạn mã trước, hãy sửa đổi những thông tin sau:
   • Thay thế BUCKET_NAME bằng tên của bộ chứa.
   • Thay thế YOUR_PROJECT_ID bằng mã dự án của bạn
   • 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 tập hợp được chỉ định. Giữ nguyên để xuất tất cả các nhóm bộ sưu tập.

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

   firebase deploy --only functions

Google Cloud Console

Tạo một Cloud Function

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

   Chuyển đến Cloud Functions

2. Nhấp vào Viết hàm
3. Nhập tên hàm, chẳng hạn như firestore-export
4. Trong phần Trigger (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. Hãy 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 mục Mã nguồn, hãy chọn Trình chỉnh sửa nội dòng. Nhập mã sau đâ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) => {
     // 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);
       });
   };

   Trong đoạn mã trước, hãy sửa đổi những thông tin 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 tập hợp được chỉ định. Giữ nguyên để xuất tất cả các nhóm bộ sưu tập.

   • (Không bắt buộc) Nếu bạn đang sử dụng một cơ sở dữ liệu không phải mặc định, hãy đảm bảo bạn đặt biến môi trường DATABASE_ID khi tạo Cloud Function. Nếu đang sử dụng một môi trường thời gian chạy mà trong đó GOOGLE_CLOUD_PROJECT không được đặt tự động, thì bạn cũng có thể cần phải đặt biến này theo cách thủ công hoặc thay thế bằng mã dự án trong mã.

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 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 công việc Cloud Scheduler gọi Cloud Function của bạn:

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 phần Target (Mục tiêu), hãy chọn Pub/Sub. Trong trường Chủ đề, 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ước.
7. Trong trường Payload (Trọng tải), 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 Cloud Function trước đó không thực sự sử dụng giá trị này.
8. Nhấp vào Tạo.