Data sources in MongoDB Charts reference a collection or view in your MongoDB deployment. The fields in that collection or view can be used to construct a chart. When building a chart, you will need to specify the data source that the chart uses.
To view, add, or remove data sources, click Data Sources in the sidebar.
Data Sources View¶
The Data Sources list displays existing data sources
for which the currently logged-in user has
Owner permissions. The data sources are displayed in a tabular
format with the following columns:
Name of the data source. By default, this is the data source's corresponding database and collection name. To learn how to rename a data source, see Rename a Data Source.
Contains two pieces of information for the data source:
When the data source was created.
You can sort data sources by any of the columns by clicking on the column header.
Filter Data Sources¶
To search for specific data sources, use the search bar at the upper right corner of the Data Sources list. You can search by Deployment, Database, Collection, or Alias.
Additionally, you can use the dropdown to the left of the search bar to
show either all data sources on your MongoDB Charts deployment, or only data
sources for which you have the
Owner permission. For more
information on data source permissions, see
Data Source Permissions.
Add a Data Source¶
- From the Data Sources list, click the Add Data Source button.
Select one of the Atlas clusters or Atlas Data Lakes.
- All clusters in the current project for which the current user has
Project Data Access Read Onlyrole or higher.
- All Data Lakes in the current project.
- All clusters in the current project for which the current user has the
- Click Connect.
Select the collections from which you wish to create data sources. Charts creates a separate data source for each selected collection.
Select or expand a database to display the number of documents in and the size of each collection it contains.
- Click Finish.
You will see your newly added data source listed in the Data Sources list. To learn how to manage existing data sources, see Manage Existing Data Sources.
Sample Data Source¶
The Sample Data: Movies data source is automatically included in all Charts tenants and provides sample movie data to explore MongoDB Charts. The Sample Dashboard uses this data source to show the possible charts you can create. You can access the sample data source from all dashboards. You do not have permissions to the sample data source, meaning you can not add, edit, or delete the data it contains
You cannot remove or edit the sample data source. You also cannot externally share or embed charts that use the sample data.
Data Source Read Preference¶
Each data source has a read preference which determines the replica set member that the data source reads data from.
By default, a newly added Atlas cluster data source has a read preference of Secondary, meaning that it reads from a secondary node within the Atlas cluster. If another data source also reads from the same Atlas cluster as the newly created data source, the newly created data source has the same read preference as the existing data source.
You can change the read preference of a data source in the Data Sources list only if the data source is an Atlas cluster. You cannot change the read preference of a data source if the data source is your Data Lake.