Create From the UI
On this page
This page describes how to deploy a federated database instance for accessing data in an HTTP data store.
Note
Beta
The support for HTTP data stores is available as a Beta feature. The feature and the corresponding documentation may change at any time during the Beta stage.
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
CSVorTSV, 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].allowInsecuresetting totrue.Atlas Data Federation does not support HTTP data store URLs that require authentication.
Procedure
Log in to MongoDB Atlas.
Select the Data Federation option on the left-hand navigation.
Create a federated database instance.
For your first federated database instance, click Create a Federated Database.
For subsequent federated database instances, click Create Federated Database.
Select the configuration method.
For a guided experience, click Visual Editor.
To edit the raw JSON, click JSON Editor.
Specify your data store.
Create the virtual databases, collections, and views and map the databases, collections, and views to your data store.
(Optional) Click the for the:
Data Lake to specify a name for your federated database instance. Defaults to
Data Lake[n].Database to edit the database name. Defaults to
Database[n].Corresponds to
databases.[n].nameJSON configuration setting.Collection to edit the collection name. Defaults to
Collection[n].Corresponds to
databases.[n].collections.[n].nameJSON configuration setting.View to edit the view name.
You can click:
Create Database to add databases and collections.
associated with the database to add collections to the database.
associated with the collection to add views on the collection. To create a view, you must specify:
The name of the view.
The pipeline to apply to the view.
Note
The view definition pipeline cannot include the
$outor the$mergestage. If the view definition includes nested pipeline stages such as$lookupor$facet, this restriction applies to those nested pipelines as well.
To learn more about views, see:
associated with the database, collection, or view to remove it.
Select External from the dropdown in the Datasets section.
Drag and drop the data store to map with the collection.
Corresponds to
databases.[n].collections.[n].dataSourcesJSON configuration setting.