Datenexport planen

Firebase CLI

1. Installieren Sie die Firebase CLI. Initialisieren Sie in einem neuen Verzeichnis die CLI für Cloud Functions:

   firebase init functions --project PROJECT_ID

   1. Wählen Sie JavaScript als Sprache aus.
   2. Aktivieren Sie optional ESLint.
   3. Geben Sie y ein, um Abhängigkeiten zu installieren.

2. Ersetzen Sie den Code in der Datei functions/index.js durch Folgendes:

   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. Ändern Sie im obigen Code Folgendes:
   • Ersetzen Sie BUCKET_NAME durch den Namen Ihres Buckets:
   • Ändern Sie every 24 hours, um Ihren Exportplan festzulegen. Verwenden Sie entweder AppEngine cron.yaml-Syntax oder das Unix-Cron-Format (* * * * *).

   • Ändern Sie collectionIds: [], um nur die angegebenen Sammlungsgruppen zu exportieren. Lassen Sie dies unverändert, um alle Sammlungen zu exportieren.

4. Stellen Sie die geplante Funktion bereit:

   firebase deploy --only functions

Google Cloud Console

Cloud Functions-Funktion erstellen

1. Rufen Sie in der Google Cloud Console die Seite Cloud Functions auf:

   Zu Cloud Functions

2. Klicken Sie auf Funktion erstellen.
3. Geben Sie einen Funktionsnamen wie firestoreExport ein.
4. Wählen Sie unter Trigger die Option Cloud Pub/Sub aus.
5. Wählen Sie unter Thema Neues Thema erstellen aus. Geben Sie einen Namen für das Pub/Sub-Thema ein, z. B. initiateFirestoreExport. Notieren Sie sich den Namen des Themas, da Sie ihn zum Erstellen Ihres Cloud Scheduler-Jobs benötigen.
6. Wählen Sie unter Quellcode Inline-Editor aus. Geben Sie den folgenden Code unter index.js ein:

   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);
       });
   };

   Ändern Sie im obigen Code Folgendes:
   • Ersetzen Sie BUCKET_NAME durch den Namen Ihres Buckets:

   • Ändern Sie collectionIds: [], um nur die angegebenen Sammlungsgruppen zu exportieren. Lassen Sie dies unverändert, um alle Sammlungen zu exportieren.

7. Fügen Sie unter package.json die folgende Abhängigkeit hinzu:

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

8. Geben Sie unter Auszuführende Funktion scheduledFirestoreExport ein, den Namen der Funktion in index.js.
9. Klicken Sie auf Erstellen, um die Cloud Functions-Funktion bereitzustellen.

Cloud Scheduler-Aufgabe erstellen

Erstellen Sie als Nächstes einen Cloud Scheduler-Job, der Ihre Cloud Functions-Funktion aufruft:

1. Rufen Sie in der Google Cloud Console die Seite Cloud Scheduler auf:

   Zu Cloud Scheduler

2. Klicken Sie auf Job erstellen.
3. Geben Sie einen Namen für den Job ein, z. B. scheduledFirestoreExport.
4. Geben Sie eine Häufigkeit ein, z. B. every 24 hours.
5. Wählen Sie eine Zeitzone aus.
6. Wählen Sie unter Ziel Pub/Sub aus. Geben Sie im Feld Thema den Namen des Pub/Sub-Themas ein, das Sie zusammen mit Ihrer Cloud Functions-Funktion definiert haben (initiateFirestoreExport im obigen Beispiel).
7. Geben Sie im Feld Nutzlast start export ein. Für den Job muss eine Nutzlast definiert sein, aber die Cloud Functions-Funktion oben verwendet diesen Wert nicht.
8. Klicken Sie auf Erstellen.

Firebase Console

Rufen Sie in der Firebase Console die Seite Cloud Functions auf.

Zu Funktionslogs

GCP Console

Rufen Sie in der Google Cloud Console die Seite Cloud Functions auf.

Loganzeige aufrufen