Programar exportações de dados

CLI do Firebase

1. Instale a CLI do Firebase. Em um novo diretório, inicialize a CLI para o Cloud Functions:

   firebase init functions --project PROJECT_ID

   1. Selecione JavaScript como a linguagem.
   2. Opcionalmente, ative o ESLint.
   3. Digite y para instalar dependências.

2. Substitua o código no arquivo functions/index.js pelo seguinte:

   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. No código acima, modifique o seguinte:
   • Substitua BUCKET_NAME pelo nome do bucket.
   • Modifique every 24 hours para definir a programação de exportação. Use a sintaxe cron.yaml do AppEngine ou o formato unix-cron (* * * * *).

   • Modifique collectionIds: [] para exportar somente os grupos de coleções especificados. Deixe como está para exportar todas as coleções.

4. Implante a função programada:

   firebase deploy --only functions

Console do Google Cloud

Criar uma função do Cloud

1. Acesse a página do Cloud Functions no console do Google Cloud.

   Acesse o Cloud Functions

2. Clique em Criar função.
3. Insira um nome de função como firestoreExport
4. Em Gatilho, selecione Cloud Pub/Sub
5. Em Tópico, selecione Criar novo tópico. Digite um nome para o tópico pub/sub, por exemplo, initiateFirestoreExport. Anote o nome do tópico, conforme necessário para criar o job do Cloud Scheduler.
6. Em Código-fonte, selecione Editor in-line. Insira o seguinte código em 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);
       });
   };

   No código acima, modifique o seguinte:
   • Substitua BUCKET_NAME pelo nome do bucket.

   • Modifique collectionIds: [] para exportar somente os grupos de coleções especificados. Deixe como está para exportar todas as coleções.

7. Em package.json, adicione a seguinte dependência:

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

8. Em Função a ser executada, insira scheduledFirestoreExport, o nome da função em index.js.
9. Clique em Criar para implantar a função do Cloud.

Criar um job do Cloud Scheduler

Em seguida, crie um job do Cloud Scheduler que chame a função do Cloud:

1. Acesse a página do Cloud Scheduler no console do Google Cloud:

   Acessar Cloud Scheduler

2. Clique em Criar job.
3. Insira um Nome para o job, como scheduledFirestoreExport.
4. Insira uma Frequência, por exemplo, every 24 hours.
5. Selecione um fuso horário.
6. Em Destino, selecione Pub/Sub. No campo Tópico, insira o nome do tópico pub/sub que você definiu com a função do Cloud, initiateFirestoreExport no exemplo acima.
7. No campo Payload, insira start export. O job requer a definição do payload, mas a função do Cloud acima não usa esse valor.
8. Clique em Criar.

Console do Firebase

Acesse a página do Cloud Functions no console do Firebase.

Acessar :"Registros de funções"

Console do GCP

Acesse a página do Cloud Functions no console do Google Cloud.

Acessar o visualizador de registros