Data Sources

A data source in Atlas Charts references one of the following:

A collection or database view in your MongoDB deployment.
A charts view that you create using a collection.

You can use the fields in the data source to construct a chart. When you build a chart, you must specify the data source that the chart uses.

Deployments in Atlas Charts reference Atlas deployments that contain valid Charts data sources, including:

All clusters and serverless instances in your Atlas project for which you have the Project Data Access Read Only role or higher.
All federated database instances in your project, including Online Archives.

Connect or Disconnect Data Sources and Deployments

An Atlas Project Owner can connect or disconnect data sources and deployments. To learn more, see Manage Data Sources.

Note

Charts connects to all deployments and data sources in your project by default.

Manage Data Sources

To manage settings for a data source, see Manage Data Sources. To manage pipelines, see Create and Manage Charts Views.

Note

To apply a pipeline, use a charts view. You can't apply pipelines to an entire collection.

Manage Deployments

To manage settings for the Atlas deployments that contain your data sources, see Manage Deployments.

Edit a Chart's Data Source

To edit the data source for an existing chart:

Select your dashboard.

From the Dashboards page, select the dashboard that contains the chart.

Click Edit on the chart you want to edit.

Click the button under Data Source on the top left of the chart builder.

The button says Select if you have not selected a data source, or it says the name of the currently selected data source.

Click the Project tab.

All of your connected deployments appear.

Note

A deployment and its data sources won't display on the Select Data Source modal unless they are connected to Charts. Only a Project Owner can connect or disconnect deployments and data sources. All deployments and data sources in the project connect to Charts by default.

Click the name of the deployment that contains the data source.

Click the name of the database that contains the data source.

The database's data sources appear. You can click on a data source's name to view a preview of its data.

Click Select on the data source.

To learn how to set the data source for a new chart, see Build Charts.

Try Out Charts with the Sample Data Source

Charts automatically includes the Sample Data: Movies data source in all Charts tenants. The Sample Dashboard uses this data source to show the charts you can create. You can access the sample data source from all dashboards.