AWS DocumentDB is a document database that offers dynamic schema and faster data replication features. However, it does not support complex joins and columnar storage for faster query performance. To eliminate such limitations, you can integrate AWS DocumentDB to BigQuery for advanced querying. BigQuery also offers built-in machine learning capabilities and seamless integration with BI tools to help you derive useful business insights from your data. 

This article explains how to move data from AWS DocumentDB to BigQuery using two methods for efficient data analytics. 

Why Integrate AWS DocumentDB to BigQuery?

You should transfer AWS DocumentDB data to BigQuery for the following reasons:

  • You can use BigQuery to create and deploy machine learning models through its built-in machine learning features. 
  • BigQuery offers better data compression and faster query performance through a columnar storage format, which DocumentDB does not provide.
  • BigQuery is a relational database, while DocumentDB is a document database. Relational databases store data in an organized way, unlike document databases. 
  • BigQuery supports complex joins while querying, which is important for complex and high-volume data analysis. 

AWS DocumentDB Overview

AWS DocumentDB is a managed JSON document database service with MongoDB compatibility. It helps you develop applications faster by providing efficient storage, querying, and indexing features. DocumentDB also enables you to aggregate data, including vectors, in JSON format, which is the data format used by most applications. It provides petabyte-level scalability and separates data storage from computation. Further, DocumentDB provides built-in security features, continuous backups, and native integrations with other AWS services. It enables you to optimize your applications with generative artificial intelligence (AI) using vector search for Amazon DocumentDB and integration with Amazon SageMaker Canvas. 

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

Google BigQuery Overview

BigQuery is a managed data warehouse service by Google for advanced data analytics. It has a serverless architecture allows you to perform SQL queries without infrastructure management. BigQuery provides scalability at the petabyte level with built-in features like machine learning, geospatial analysis, and business intelligence. It consists of compute and storage layers that operate independently of each other, reducing downtime and optimizing the performance of BigQuery. Moreover, it stores data in columnar format, which can then be shared and processed parallelly across multiple nodes in the cloud. 

Methods to Integrate AWS DocumentDB to BigQuery

 Method 1: Using Hevo Data to Integrate AWS DocumentDB to BigQuery

Hevo Data is a no-code ELT platform that provides real-time data integration and offers a cost-effective way to automate your data pipelining workflow. With over 150 source connectors, you can integrate your data into multiple platforms, conduct advanced analysis, and produce useful insights.

Here are some of the most important features provided by Hevo Data:

  • Data Transformation: Hevo Data provides you the ability to transform your data for analysis with a simple Python-based drag-and-drop data transformation technique.
  • Automated Schema Mapping: Hevo Data automatically arranges the destination schema to match the incoming data’s schema. It also lets you choose between Full and Incremental Mapping.
  • Incremental Data Load: It ensures proper bandwidth utilization at both the source and the destination by allowing real-time data transfer of the modified data.

The steps below provide information on how to connect AWS DocumentDB to BigQuery. 

Step 1: Configuration of AWS DocumentDB as Source


Once you have fulfilled all the prerequisites, you can use the following steps to configure AWS DocumentDB as a source: 

  • Click PIPELINES in the Navigation Bar.
  • Click + CREATE in the Pipelines List View.
  • On the Select Source Type page, select Amazon DocumentDB.
  • In the Configure your Amazon DocumentDB Source page, specify the following:
AWS DocumentDB to BigQuery: Source Configuration Settings
AWS DocumentDB to BigQuery: Source Configuration Settings

For more information on the configuration of AWS DocumentDB as a source, refer to the Hevo documentation

Step 2: Configuration of BigQuery as Destination


  • You should ensure that you have access to the GCP project. If you do not have one, refer to the steps in Create a Google Cloud project.
  • Assign the essential roles of the GCP project to the connecting Google account. These roles are in addition to the Owner or Admin roles within the project.
  • You should also ensure an active billing account is linked to your GCP project. Further, ensure you are assigned the Team Collaborator or any administrator role except the Billing Administrator role in Hevo to create the destination.

After fulfilling these prerequisites, follow the below steps to configure BigQuery as a destination in Hevo:

  • Click DESTINATIONS in the Navigation Bar.
  • Click + CREATE from the Destinations List View.
  • In the Add Destination page, select Google BigQuery as the Destination type.
  • In the Configure your Google BigQuery Warehouse page, specify the following details:
AWS DocumentDB to BigQuery: Destination Configuration Settings
AWS DocumentDB to BigQuery: Destination Configuration Settings

For more information on the configuration of BigQuery as a destination, refer to the Hevo documentation

Get Started with Hevo for Free

Method 2: Using CSV file to Integrate AWS DocumentDB to BigQuery

You can export data from AWS DocumentDB to CSV in your local system and then transfer this CSV file to Google Cloud Storage. This CSV file can then be exported from Google Cloud Storage to BigQuery. Here are the steps you need to follow:

Step 1: Export Data from AWS DocumentDB to a CSV file

Amazon DocumentDB uses the monogoexport utility to transfer data to a CSV file as follows:

mongoexport --ssl \

    --host="" \

    --collection=sample-collection \

    --db=sample-database \

    --out=sample-output-file \

    --username=sample-user \

    --password=abc0123 \

    --sslCAFile global-bundle.pem

This data is exported to a CSV file in your native system. 

Step 2: Loading CSV file to Google Cloud Storage

To load a CSV file from your local system to Google Cloud Storage, follow the below steps:

  • Go to your Google Cloud account and then to the Google Console
AWS DocumentDB to BigQuery: CSV to Google Cloud Export
AWS DocumentDB to BigQuery: CSV to Google Cloud Export
  • On the Navigation Menu on the left, click Storage > Browser
AWS DocumentDB to BigQuery: CSV to Google Cloud Export
AWS DocumentDB to BigQuery: CSV to Google Cloud Export
  • You need to create a bucket, which is like a folder in Google Cloud, to store your files. To do this, click on +CREATE BUCKET. 
AWS DocumentDB to BigQuery: CSV to Google Cloud Export
AWS DocumentDB to BigQuery: CSV to Google Cloud Export
  • Enter a name for your bucket and click CREATE at the bottom.
AWS DocumentDB to BigQuery: CSV to Google Cloud Export
AWS DocumentDB to BigQuery: CSV to Google Cloud Export
  • Now click on Upload Files, or you can directly drag and drop your CSV file. 
AWS DocumentDB to BigQuery: CSV to Google Cloud Export
AWS DocumentDB to BigQuery: CSV to Google Cloud Export
  • After uploading, your file appears on the Google Cloud interface as shown below:
AWS DocumentDB to BigQuery: CSV to Google Cloud Export
AWS DocumentDB to BigQuery: CSV to Google Cloud Export

Step 3: Exporting Data from CSV file in GCS to BigQuery

You can use the LOAD DATA SQL statement within the Query Editor of BigQuery to load your data from the CSV file to the BigQuery table. You can follow these steps:

  • Go to the BigQuery page in Google Cloud Console.
  • Enter the following code in Query Editor:
LOAD DATA OVERWRITE mydataset.mytable

(x INT64,y STRING)


  format = 'CSV',

  uris = ['gs://bucket/path/file.csv']);
  • Click Run. You can access your data in BigQuery upon completion of the export. 

Limitations of Using CSV Files to Integrate AWS DocumentDB to BigQuery

There are several limitations to using CSV files to integrate AWS DocumentDB to BigQuery. These are as follows:

  • Limited Data Type: CSV files store data in text format. They support basic data types such as numbers or dates but not complex data types.
  • Scalability Issues: CSV files do not support importing large volumes of data. They lack compression features and take a lot of time to transfer data.  

Use Cases

When you export AWS DocumentDB to BigQuery, you can leverage it in several ways, such as:

  • Big Data Analytics: You can integrate with BigQuery to conduct complex analytics on large enterprise datasets. This aids in customer behavior analysis and predicts market trends leading to innovation and business growth. 
  • Real-time Analytics: You can integrate the data in BigQuery with Google Cloud’s streaming platforms, like Dataflow, and use it for real-time analytics. This helps streamline your product development strategy according to the current trends in your organization’s domain. 
  • Machine Learning: BigQuery provides built-in machine learning capabilities, which you can use to build and execute machine learning models using SQL queries directly. Thus, it simplifies the machine learning deployment process for your data without the need for expertise. 
  • Business Intelligence: You can connect BigQuery with BI tools like Power BI, Looker, or Tableau to create interactive dashboards and reports. Such business reports allow you to gain useful business insights and make better decisions for business growth. 


This blog provides information on how to load AWS DocumentDB file in BigQuery using two methods. One of the methods is CSV files for data migration, but it has some drawbacks, such as scalability issues and a lack of support for complex data types. The other method is using Hevo Data, a zero-code data integration platform.  The robust features of Hevo, such as zero-code data pipelines, automation, security features, and an extensive library of connectors, make it a suitable tool for data integration. You can utilize them to transfer your data from AWS DocumentDB to BigQuery efficiently.

Want to take Hevo for a spin? Sign Up for a 14-day free trial and experience the feature-rich Hevo suite firsthand. Also checkout our unbeatable pricing to choose the best plan for your organization.

Share your experience of AWS DocumentDB to BigQuery integration in the comments section below!


  1. What does MongoDB compatibility mean in DocumentDB?

DocumentDB is said to be compatible with MongoDB because it interacts with 3.6, 4.0, and 5.0 APIs. It enables you to use MongoDB drivers and applications with DocumentDB with some or no changes. However, DocumentDB does not support all MongoDB APIs. 

  1. What are the limitations of BigQuery?

BigQuery usage has certain drawbacks, such as fewer customization features and limited integration with other non-GCP applications. It also appears complex for those new to data warehousing and SQL. 

Customer Experience Engineer, Hevo Data

Skand, with 2.5 years of experience, specializes in MySQL, Postgres, and REST APIs at Hevo. He efficiently troubleshoots customer issues, contributes to knowledge base and SOPs, and assists customers in achieving their use cases through Hevo's platform.

All your customer data in one place.