Estimated Time to Complete: ~15 minutes
This guide provides step-by-step instructions to quickly set up the required components for the BI Connector on your local system using a ODBC driver.
This guide is recommended for users who would like to experiment with the BI Connector or create a local environment for development or testing on Microsoft Windows.
In this tutorial you will:
Start a local MongoDB mongod process
Start a local BI Connector mongosqld process
Install the ODBC driver and create a data source name (DSN)
Connect with a BI tool of your choice
MongoDB Connector for BI installed on your local system. Download the latest production release of BI Connector from the MongoDB Download Center and install it. For detailed installation instructions, see Install BI Connector On Premises.
The MongoDB BI Connector ODBC Driver installed on your local system.
If mongod is not already
running on your local system, start it from the command line in
the MongoDB program directory. You can create the default data
C:\data\db or specify a different directory
Make sure your MongoDB instance has at least one collection with some data for testing purposes. A sample dataset with United States ZIP code information (3.2 MB) is available at media.mongodb.org/zips.json.
To save the ZIP code dataset directly to disk, right click on
the link and select
"Save Link As..." This tutorial assumes
that the saved file is in the directory
Import the dataset into MongoDB. The following command imports
zips.json file into a collection named
zips in a
"C:\Program Files\MongoDB\Server\3.6\bin\mongoimport.exe" --db test --collection zips --file "C:\data\zips.json"
mongosqld process from the command line in the
BI Connector program directory.
"C:\Program Files\MongoDB\Connector for BI\2.3\bin\mongosqld.exe"
With no command line options,
mongosqld generates a schema from
all the user-accessible collections in your MongoDB instance. For
more information about specifying database namespaces for BI Connector
to work with, see the
mongosqld reference page.
mongosqld starts correctly, the last line of on-screen output
declares the namespaces it has found for its schema. For example, the
following output indicates that
mongosqld started correctly and
[schemaDiscovery] mapped schema for 1 namespaces: "test" (1): ["zips"]
Create a System DSN by following instructions in the tutorial. For the
purposes of this local test installation you can leave the
User, Password and Authentication
fields blank, because
mongosqld is running without the
When you press the Test button you should see the Connection Successful result.
To learn how to connect from your BI Tool, see several applications.