Docs Menu

Docs Home → Launch & Manage MongoDB → MongoDB Atlas

Deploy a Federated Database Instance

On this page

  • Required Access
  • Prerequisites
  • Procedure

This page describes how to deploy a federated database instance for accessing data in an HTTP data store.

Note

Preview

The support for HTTP data stores is available as a Preview feature. The feature and the corresponding documentation may change at any time during the Preview stage.

Required Access

To deploy a federated database instance, you must have Project Owner access to the project. Users with Organization Owner access must add themselves as a Project Owner to the project before deploying a federated database instance.

Prerequisites

Before you begin, you will need to:

  • Create a MongoDB Atlas account, if you do not have one already.

  • Format your data store using one of the supported data formats.

    Note

    If your file format is CSV or TSV, you must include a header row in your data. See CSV and TSV for more information.

  • Make your data store accessible over the public internet.

Important

  • If your HTTP data store is not accessible over HTTPS, you must use the JSON Editor to configure your data store. In your JSON configuration, you must set the stores.[n].allowInsecure setting to true.

  • Atlas Data Federation does not support HTTP data store URLs that require authentication.

Procedure

1

Log in to MongoDB Atlas.

2

Select the Data Federation option on the left-hand navigation.

3

Create a federated database instance.

  1. Click the Create New Federated Database dropdown.

  2. Select Manual Setup.

4

Select the cloud provider where Atlas Data Federation will process your queries against your federated database instance.

You can select AWS or Azure. Once your federated database instance is created, you can't change the cloud provider where Atlas Data Federation processes your queries.

5

Type a name for your federated database instance in the Federated Database Instance Name field and click Continue.

Defaults to FederatedDatabaseInstance[n]. Once your federated database instance is created, you can't change its name.

6

Select the configuration method.

  • For a guided experience, click Visual Editor.

  • To edit the raw JSON, click JSON Editor.

7

Specify your data store.

8

Optional: Repeat steps in the Visual Editor or JSON Editor tab above to define additional HTTP URLs.

To add other data stores for federated queries, see:

9

Click Save to create the federated database instance.

← HTTP URL
Atlas Data Lake Dataset or Online Archive →

On this page