To view, add, or remove data sources, click Data Sources on the top navigation bar.
Data Sources List¶
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.
Collection & Deployment
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¶
MongoDB Charts requires that MongoDB deployments run version 3.4 or later.
If your MongoDB deployment is running with authentication enabled, include a database user's credentials in the connection string URI. Anonymous, SCRAM, and LDAP authentication mechanisms are supported. The database user must have read permissions on the collections selected in the following step.
If the authenticated user does not have the listDatabases privilege on the deployment specified in the URI, they can still add the data source by specifying the desired database as part of the URI. In this case, the URI takes the following form:
If your deployment is running with TLS/SSL enabled, add the
ssl=true option to the URI:
For more information, see Connect to a TLS/SSL-Enabled Data Source.
- From the Data Sources list, click the New Data Source button.
- Enter the Connection String URI of the MongoDB deployment to which you want to connect.
- Click Connect.
- Select the collections from which you wish to create data sources. Charts creates a separate data source for each selected collection.
- Click Set Permissions.
- Set the permissions for the data source. You can search for specific users by name or email address using the search bar.
Click Publish Data Source.Note
If you selected multiple collections for your data source in step 4, the data source permissions you select are applied to all of the selected collections when you publish your data source. If you wish to apply different permissions to individual collections that you have selected, you will need to edit those data sources after publishing.
You will see your newly added data source in the Data Sources list. To learn how to manage existing data sources, see Manage Existing Data Sources.