Firestore is a flexible and scalable database that helps import or export application data from multiple data sources into Data Warehouses or other BI (Business Intelligence) tools.

Google BigQuery or BigQuery is one of the most popular Data Warehouses developed by Google. Loading data from Firestore to BigQuery plays a pivotal role when applications are developed using other Google technologies and there needs to be communication between them to cater to business requirements.

This article provides a comprehensive guide on integrating Firestore and BigQuery. It also provides a general overview of both Firestore and BigQuery to better understand these technologies individually.


  • Working knowledge of Google BigQuery and Firestore.
  • Have access to the “ bigquery.tables.create ”, “ bigquery.tables. updateData “, and the “ bigquery. jobs. create” permissions in Google BigQuery.
  • Have access to the “ storage.objects.get ”permissions in Firestore.
  • Working knowledge of Databases and Data Warehouses.

Introduction to Firestore

Firestore to BigQuery: Firestore Logo
Image Source

Firestore, a subset of Google Cloud, is a flexible, scalable NoSQL Cloud Database for mobile, web, and application development. Its main role is to keep your data in sync across client apps through real-time listeners. It also offers offline support for both mobile and web applications so that you can build responsive apps regardless of any Internet issues. 

Firestore also supports easy integration with Firebase and other Google Cloud products, including Cloud Functions. 

Key Features of Firestore

Firestore houses a wide range of features which makes it a better choice as compared to other web and mobile application development databases. Some of these features are:

  • Firestore is highly flexible and supports hierarchical data structures and collections. The documents can contain complex nested objects and subcollections and still be maintained properly.
  • It allows you to perform simultaneous querying. Your queries can include multiple, chained filters, combine filtering, and sorting. In addition to this, queries are also indexed by default so that your query performance is proportional to the resulting data set.
  • Firestore allows you to perform real-time updates on your data by leveraging data synchronization. It is also designed to fetch one-time queries efficiently.
  • It offers offline support as it caches data every time it is being used. So, the application can write, read, listen to, and query data even if the device is offline. Once the device is back online, all local changes are synchronized back to the Cloud.
  • Firestore brings you the best of Google’s Cloud Platform and is highly scalable to handle the workload of the biggest applications.

By loading data from Firestore to BigQuery, you will be able to transfer your application data into the Data Warehouse by using the powerful Google Cloud Platform every step of the way.

To learn more about Firestore, click this link

Introduction to Google BigQuery

Firestore to BigQuery: Google BigQuery Logo
Image Source

Google BigQuery is a Data Warehousing platform that is serverless, cost-effective, highly scalable, and has Machine Learning built into it.

It uses the Business Intelligence Engine for its operations. It enables quick SQL queries to be combined with the processing power of Google’s infrastructure to manage business transactions, manage the data across different databases, and also allow access control policies for users to view and query data. 

BigQuery has a BI engine which is a fast memory analysis service that enables users to analyze large and complex datasets with high concurrency. It works very well with tools such as Google Data Studio and Looker for analysis.

It also uses Machine Learning that helps data scientists and data analysts to build and operate various models using simple SQL commands. The models tested could also be exported for prediction in a Cloud AI Platform or a separate service layer.

BigQuery is used by many companies such as UPS, Twitter, and Dow Jones. UPS uses BigQuery to predict the precise package volume for its products. Twitter helps to modernize advertisements and aggregates millions of data per second using BigQuery.

Dow Jones uses BigQuery to unlock the business value of more than 1.3 million users to uncover the hidden relationships between various attributes.

Key Features of Google BigQuery

Google BigQuery houses many features to help all types of users store their data from multiple data sources and gain valuable and actionable insights from its customers. Some of these features include:

  • It requires minimal configuration and so anyone can use it without being a Database Administrator.
  • It is fully manageable and does not require any resources to be deployed.
  • It encrypts your data by default.
  • It supports a variety of languages including Java, .NET, and Python.
  • It supports a wide variety of 3rd party applications to visualize and analyze data.

By loading data from Firestore to BigQuery, you can regularly monitor your application data throughout the loading process.

To learn more about Google BigQuery, click this link.

Solve your data replication problems with Hevo’s reliable, no-code, automated pipelines with 150+ connectors.
Get your free trial right away!

Methods to Load Data from Firestore to BigQuery

Regardless of the method, you choose to load data from Firestore to BigQuery you need certain permissions. When you load data from Firestore to BigQuery, you need permissions to run a load job and permissions that let you load data into new or existing BigQuery tables and partitions.

Similarly, if you want to load data from a Cloud Storage bucket, you must be granted all the export permissions.

There are 2 main methods you can use to set up Firestore export to BigQuery. They are given below:

Download the Cheatsheet on How to Set Up High-performance ETL to BigQuery
Download the Cheatsheet on How to Set Up High-performance ETL to BigQuery
Download the Cheatsheet on How to Set Up High-performance ETL to BigQuery
Learn the best practices and considerations for setting up high-performance ETL to BigQuery

Method 1: Using the Firestore Cloud Console to Load Data from Firestore to BigQuery

In this method, you can load data from Firestore to BigQuery by using the Firestore Cloud Console. This method can be used by following the below steps:

Step 1: Open the BigQuery Page in the Cloud Console

The first step to load data from Firestore to BigQuery is to access the Cloud Console and open the BigQuery page. The home page looks like the figure shown below.

Firestore to BigQuery: Google BigQuery Home Page
Image Source: Self

Step 2: Select the Dataset

The next step is to go to the Explorer Panel and expand your project to select a dataset.

Step 3: Create the Table

Once this is done, you need to go to the Details Panel and click on Create Table.

Step 4: Enter the Cloud Storage URI

The next step to load data from Firestore to BigQuery is to set up the Cloud Storage URI.

To do this, go to the Create Table page, go to the Source Section, and select Cloud Storage. Once you do that, in the Source field, enter the Cloud Storage URI.

An important point to note is that the Cloud Storage Bucket must be in the same location as your dataset. The URI for your Firestore export file should end with KIND_COLLECTION_ID.export_metadata.

Once that is done, you need to choose the File Format. Select DataStore Backup as it is the correct option for Firestore. Firestore and Datastore share an export format.

Step 5: Configure the Destination

Once the formats are selected, you need to configure the Destination to load data from Firestore to BigQuery. For the Dataset name, choose the appropriate dataset as shown in the figure below.

Firestore to BigQuery: Loading data from Firestore to BigQuery dataset
Image Source

In the Table Name field, enter the name of the table you’re creating in BigQuery and also verify that the Table type is set to Native Table.

Step 6: Overviewing the Schema

In the Schema section, no action is necessary. The schema is inferred for a Firestore export.

Step 7: Configure any Advanced Settings

In case you have any other advanced settings to add to your table, go to the Advanced Options section and set Write preference to Overwrite table. This is shown below.

Firestore to BigQuery: Advance Options
Image Source

Finally, click on Create table

That’s it! You have successfully loaded data from Firestore to BigQuery using the Firestore Cloud Console.

Method 2: Using the BigQuery Command Line Interface to Load Data from Firestore to BigQuery

To use this method you need to use the bq load command with source_format set to DATASTORE_BACKUP on the Command Line Interface. The code for implementing the bq load command on the command-line interface is shown below:

bq --location=LOCATION load 

You need to replace the following attributes according to your requirements:

  • LOCATION: Replace it with your current location. The –location flag is optional.
  • FORMAT: Replace it with DATASTORE_BACKUP. This is because Datastore Backup is the correct option for Firestore. Firestore and Datastore share the same export format.
  • DATASET: Replace it with the dataset that contains the table into which you are loading the data.
  • TABLE: This is the table into which you are loading the data. If you do not have a table, it will be created automatically.
  • PATH_TO_SOURCE: Replace it with the Cloud Storage URI.

A sample code example with all these parameters set is shown below.

bq --location=US load 

In this example, you are loading the 

gs://mybucket/20180228T1256/default_namespace/kind_Book/default_namespace_kind_Book.export_metadata Firestore export file into a table named book_data. mybucket and mydataset were created in the US multi-region location.

That’s it! You have successfully loaded data from Firestore to BigQuery using the BigQuery Command Line Interface.

Connect Firebase to Bigquery Using Hevo’s No-code Data Pipeline

Hevo Data, an Automated No Code Data Pipeline, helps you transfer data from Firebase (a free Data Source for Hevo) to Google BigQuery within minutes in a completely hassle-free manner. Hevo is fully managed and completely automates the process of not only loading your data into BigQuery but also enriching the data and transforming it into an analysis-ready form without having to write a single line of code. With Hevo, you can load data from a multitude of sources into BigQuery seamlessly and make it your single source of truth. You can also leverage Hevo’s Data Mapping feature to ensure that your Google BigQuery data is up-to-date.

Hevo’s fault-tolerant Data Pipeline offers you a secure option to unify data from Firebase and 50+ other free sources and store it in a BigQuery or any other Data Warehouse of your choice. This way you can focus more on your key business activities and let Hevo take full charge of the Data Transfer process.

Check out how Hevo can make your life easier:

  • Highly Interactive UI and Easy Setup: With its simple and interactive UI, Hevo can be set up within minutes. Hevo has a simple 3 step process to connect your Firebase source to the Google BigQuery Data Warehouse.
  • Schema Management: Hevo takes away the tedious task of schema management & automatically detects the schema of incoming data and maps it to the Bigquery destination table schema.
  • Data Transformations: Using Transformations in Hevo, you can perform multiple operations like data cleansing, data enrichment, and data normalization before loading the data to the destination. You can perform these transformations using 2 methods – Writing a Python-based transformation script or Using Hevo’s drag-and-drop transformation blocks.
  • Unlimited connector availability: Hevo has native integration with Firebase and 150+ data sources (including 50+ free sources) across Databases, SaaS Applications, Cloud Storage, SDKs, etc., to analyze real-time customer data 
  • Hevo Is Built To Scale: As the number of sources and the volume of your data grows, Hevo scales horizontally, handling millions of records per minute with very little latency.
  • Live Support: The Hevo team is available round the clock to extend exceptional support to its customers through chat, email, and support calls.
  • Live Monitoring: Hevo allows you to monitor the data flow and check where your data is at a particular point in time

Leverage Hevo’s blazing-fast Data Pipelines to help you seamlessly extract, transform, and load your Firebase data to your BigQuery Data Warehouse in a matter of minutes! All this without writing any code. Try our 14-day full-access free trial !!

Load Data to BigQuery with Hevo for Free

Limitations of Loading Data from Firestore to BigQuery

Although both methods for loading Firestore data to BigQuery are easy to understand, users that have a non-technical background might find it difficult to load their data in the first go.

This is because even if the transfer process is successfully deployed, there are a lot of resources you must have before initiating the process. 

Some of the limitations of Loading data from Firestore to BigQuery are:

  • Your dataset must be in the same regional location as the Cloud Storage Bucket containing your export files.
  • You can specify only 1 Cloud Storage URI, and cannot use a URI wildcard.
  • You can only create a new table or overwrite an existing table to store the data. You cannot append Firestore export data to an existing table.
  • For a Firestore export to load correctly, documents in the export data must share a consistent schema with fewer than 10,000 unique field names.
  • The export command must specify a “collection-ids” filter. Without this filter, data cannot be exported into BigQuery.


This article gave you a step-by-step guide on loading data from Firestore to BigQuery. It also gave you an overview of both Firestore and BigQuery and also highlighted some of the limitations of this process. Overall, loading data from Firestore to BigQuery can be done using any method and plays an important role in extracting valuable insights from customers that use your applications.

Companies store valuable data from multiple data sources in Google BigQuery. However, when it comes to loading with BigQuery, you need to be an expert to set up ETL pipelines from scratch and manually configure several details.

Moreover, most of the time, the data is not available in the right format and you will need data engineering and BigQuery administration skills to transform the data.

Hevo Data provides an Automated No-code Data Pipeline that empowers you to overcome the above-mentioned limitations. Hevo caters to 150+ data sources (including 50+ free sources) like Firebase and can seamlessly load data to BigQuery in real-time.

Furthermore, Hevo’s fault-tolerant architecture ensures a consistent and secure transfer of your data to BigQuery. It will help simplify the ETL and management process of both the data sources and destinations

Visit our Website to Explore Hevo

Share your experience of Loading Data from Firestore to BigQuery in the comments section below!

No-code Data Pipeline For Google BigQuery