Install BI Connector on Windows


The MongoDB Connector for BI and associated utilities are compatible only with MongoDB server version 3.2 or greater.

To set up MongoDB Connector for BI with a business intelligence tool such as Tableau, follow the steps on this page.


MongoDB User Permissions

If your MongoDB instance uses authentication, your BI Connector instance must also use authentication. The user that connects to MongoDB via the mongosqld program must have permission to read from all the namespaces you wish to sample data from.

For more details about MongoDB user permissions in BI Connector, see User Permissions for Cached Sampling.

Install the BI Connector


Download the MongoDB Connector for BI.

Download the BI Connector from the MongoDB Download Center.


Install the MongoDB Connector for BI.

  1. Run the downloaded .msi file.
  2. Follow the wizard instructions to install the files. The binaries install into a bin directory inside the installation directory.

New in version 2.9.

To help you get started, a sample mongosqld configuration file named example-mongosqld-config.yml is included with the installation package. To learn how to start BI Connector with a configuration file, refer to the mongosqld documentation section on the Configuration File.

Launch the BI Connector

You are now ready to launch the BI Connector. The following guide contains detailed information on BI Connector configuration, schema generation, and launch options: