Planowanie eksportu danych

wiersz poleceń Firebase

1. Zainstaluj wiersz poleceń Firebase. W nowym katalogu zainicjuj interfejs wiersza poleceń dla Cloud Functions:

   firebase init functions --project PROJECT_ID

   1. Jako język wybierz JavaScript.
   2. Opcjonalnie włącz ESLint.
   3. Wpisz y, aby zainstalować zależności.

2. Zastąp kod w pliku functions/index.js tym kodem:

   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. W powyższym kodzie zmień te elementy:
   • Zastąp BUCKET_NAME nazwą swojego zasobnika.
   • Zastąp YOUR_PROJECT_ID identyfikatorem projektu .
   • Zmień every 24 hours, aby ustawić harmonogram eksportu. Użyj składni App Engine cron.yaml lub formatu unix-cron (* * * * *).

   • Zmień collectionIds: [], aby eksportować tylko określone grupy kolekcji. Aby wyeksportować wszystkie grupy kolekcji, pozostaw tę wartość bez zmian.

4. Wdróż zaplanowaną funkcję:

   firebase deploy --only functions

Konsola Google Cloud

Tworzenie funkcji w Cloud Functions

1. W konsoli Google Cloud otwórz stronę Cloud Functions:

   Otwórz Cloud Functions

2. Kliknij Napisz funkcję.
3. Wpisz nazwę funkcji, np. firestore-export.
4. W sekcji Aktywator wybierz Cloud Pub/Sub.
5. W sekcji Temat wybierz Utwórz nowy temat. Wpisz nazwę tematu Pub/Sub, np. initiateFirestoreExport. Zanotuj nazwę tematu, ponieważ będzie Ci ona potrzebna do utworzenia zadania Cloud Scheduler.
6. W sekcji Kod źródłowy wybierz Edytor wbudowany. Wpisz ten kod w sekcji 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);
       });
   };

   W powyższym kodzie zmień te elementy:
   • Zastąp BUCKET_NAME nazwą swojego zasobnika.

   • Zmień collectionIds: [], aby eksportować tylko określone grupy kolekcji. Aby wyeksportować wszystkie grupy kolekcji, pozostaw tę wartość bez zmian.

   • (Opcjonalnie) Jeśli używasz bazy danych innej niż domyślna, podczas tworzenia funkcji w Cloud Functions ustaw zmienną środowiskową DATABASE_ID. Jeśli używasz środowiska wykonawczego, w którym GOOGLE_CLOUD_PROJECT nie jest ustawiana automatycznie, może być konieczne ręczne ustawienie tej zmiennej lub zastąpienie jej identyfikatorem projektu w kodzie.

7. W sekcji package.json dodaj tę zależność:

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

8. W sekcji Funkcja do wykonania wpisz scheduledFirestoreExport – nazwę funkcji w index.js.
9. Aby wdrożyć funkcję w Cloud Functions, kliknij Utwórz.

Tworzenie zadania Cloud Scheduler

Następnie utwórz zadanie Cloud Scheduler, które wywołuje Twoją funkcję w Cloud Functions:

1. W konsoli Google Cloud otwórz stronę Cloud Scheduler:

   Otwórz Cloud Scheduler

2. Kliknij Utwórz zadanie.
3. Wpisz Nazwę zadania, np. scheduledFirestoreExport.
4. Wpisz Częstotliwość, np. every 24 hours.
5. Wybierz Strefę czasową.
6. W sekcji Miejsce docelowe wybierz Pub/Sub. W polu Temat wpisz nazwę tematu Pub/Sub, który został zdefiniowany razem z funkcją w Cloud Functions, czyli w poprzednim przykładzie initiateFirestoreExport.
7. W polu Payload wpisz start export. Zadanie wymaga zdefiniowania payloadu, ale poprzednia funkcja w Cloud Functions nie używa tej wartości.
8. Kliknij Utwórz.