# Transfer data with GBQ to Firestore

## :bulb: What is a GBQ to Firestore configuration?

A GBQ to Firestore data pipeline allows you to transform each row of a BigQuery table into Firestore documents.

## ✅ **Overall operations needed**

:warning: GBQ to Firestore is an advanced data pipeline which requires prior knowledge of:

* [Tables to storage configuration](/data-pipeline-operations/export-data-with-tables-to-storage/table-to-storage-configuration-file-1.md)
* [VM-launcher configuration](/data-pipeline-operations/execute-code-processings-with-vm-launcher/process-code-with-vm-launcher/vm-launcher-code-processing-configuration-file.md)
* [Workflow configuration](/data-pipeline-operations/orchestrate-processings-with-workflow/workflow-configuration-file.md)
* Python [(Data structures - Dictionaries)](https://docs.python.org/3/tutorial/datastructures.html?highlight=dictionary#dictionaries)
* [Firestore](https://firebase.google.com/docs/firestore)

## ⚙️ How it works

1. A tables-to-storage data operation is scheduled, or triggered by an event (for example a tables-to-tables successful run)
2. The SQL query you specified in your tables-to-storage data operation is executed to extract the relevant data from BigQuery into a JSON file located in the Google Cloud Storage bucket of your choice
3. Then a vm-launcher data operation is triggered to launch a VM on Google Compute Engine to execute the Python script that loads the JSON file into Firestore
4. Once the execution is complete, the VM is stopped automatically
5. Lastly, you can check the file tree in Firestore and see your data!

## **📋 How to deploy a GBQ to Firestore data pipeline:**

You must follow these steps:

1. [**Deploy a tables to storage data operation**](https://docs.tailer.ai/data-pipeline-operations/export-data-with-tables-to-storage#how-to-deploy-a-table-to-storage-data-operation)
2. [**Deploy a vm-launcher data operation for code processing**](https://docs.tailer.ai/data-pipeline-operations/execute-code-processings-with-vm-launcher/process-code-with-vm-launcher#how-to-deploy-a-vm-launcher-data-operation-for-code-processing)
3. [**Deploy a workflow data operation**](/data-pipeline-operations/orchestrate-processings-with-workflow/workflow-configuration-file.md)

The following pages describe how to deploy a first end-to-end GBQ to Firestore data pipeline.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tailer.ai/data-pipeline-operations/transfer-data-with-gbq-to-firestore.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.