Navigation
This documentation refers to the MongoDB Charts service in MongoDB Atlas. Read the on-premises documentation to learn how to use the MongoDB Charts on site.

Manage Existing Data Sources

Users who are Owners of a data source can modify certain properties of that data source. This page outlines the modifications data source Owners can make.

Rename a Data Source

By default, the name of a data source is its corresponding database and collection name. A data source Owner can rename that data source.

To rename a data source:

  1. Navigate to your Data Sources List.
  2. Hover over the desired data source’s Name field.
  3. Click the appearing pencil icon icon.
  4. Click the check mark to save the new name.

Modify Embedding Settings

A data source Owner can allow other people to embed charts which use the data source in external web pages. In order to allow a chart to be embedded in an external web page, you must enable embedding both on the data source and the individual chart.

Embedding is disabled by default for all data sources. To enable embedding for a data source:

  1. Navigate to your Data Sources List.

  2. Click the ellipsis () button on the far right side of the desired data source.

  3. Select Embedding Options from the dropdown menu.

  4. Toggle the switch in the top right corner to On.

  5. Select either:

    1. Verified Signature only. This option requires embedded charts to include a verified signature with each request sent to the data source. Without a verified signature, the chart will not render. This option allows the chart owner to ensure that the chart is used only in its intended context.

      Generating a verified signature for authorized users to include with their embedded charts requires some server-side code. Examples in several languages and platforms are available with the verified signature documentation.

    2. Unauthenticated or Verified Signature. This option allows the chart to be viewed either with or without a verified signature, so that anyone with the link may view the embedded chart. It is simpler to implement than the verified signature only option, but it is less secure. It should only be used for charts which display non-sensitive data.

After enabling embedding for a data source, you can enable embedding for individual charts which use that data source.

Note

If you change the embedding option for a data source from On to Off, all embedded charts which use that data source will stop rendering immediately.

Modify Data Source Permissions

A data source Owner can modify user permissions on that data source. To modify user permissions:

  1. Navigate to your Data Sources List.
  2. Click the Access button in the Permissions column for the data source you want to modify permissions.
  3. Perform the desired permission changes for the data source. Refer to the Data Source Permissions page for details on the permissions available and instructions on setting the permissions.
  4. Click Apply Changes.

Modify Data Source Read Preference

A data source Owner can modify the read preference of a data source. A data source’s read preference determines which replica set member the data source reads data from.

Read preference options are:

If your Atlas cluster includes one or more analytics nodes, they are the best choice for your data source read preference. Analytics nodes provide workload isolation and reduce strain on your cluster’s data-bearing nodes.

Important

Not all Atlas clusters include analytics nodes, and the Analytics Node option appears in the read preference selection UI whether analytics nodes are available or not. Consult your cluster configuration and ensure that your cluster has analytics nodes available before choosing Analytics Node for your data source’s read preference.

If you select Analytics Node for your data source’s read preference when no analytics nodes are available, any charts which use the data source will produce an error the next time they read from the data source.

If your Atlas cluster does not have analytics nodes available, the next best choice is Secondary. Reading from a secondary node reduces strain on your primary node.

To modify the read preference for a data source:

  1. Navigate to your Data Sources List.
  2. Click the ellipsis () button on the right-hand side of the data source you want to modify.
  3. Click Edit Read Preference.
  4. Select your desired setting from the dropdown menu.
  5. Click the Save button.

Note

After changing a data source’s read preference, it takes a few minutes for the change to take effect. All data sources which read from the same Atlas cluster will use the selected read preference setting.

Delete a Data Source

A data source Owner can delete that data source. To delete a data source:

  1. Navigate to your Data Sources List.
  2. Click the ellipsis () button on the right-hand side of the data source you want to delete.
  3. Click Delete Data Source.
  4. Click Delete Data Source again in the dialog to confirm deletion.

Important

Charts displays a warning if the data source you attempt to delete is in use by at least one chart. Any charts using the deleted data source will need to be reconfigured using a different data source or deleted.