- Connect to a Cluster >
- Connect via BI Connector for Atlas >
- Create a System DSN
Create a System DSN¶
On this page
The following steps describe how to create a system Data Source Name (DSN) for the BI Connector for Atlas. A DSN is a saved configuration which describes a database connection to be used by an ODBC driver. Once the DSN is created, you can configure a wide range of SQL clients and BI tools to use the DSN and import data from MongoDB.
- Windows
- macOS
Prerequisites¶
Before creating a DSN, you should:
- Download and install Visual C++ Redistributable for Visual Studio 2015
- Download and install the MongoDB ODBC Driver for BI Connector for your platform.
Procedure¶
Start the Microsoft ODBC Data Sources program.¶
Choose the program version (64-bit or 32-bit) which is appropriate for your system and ODBC driver version.
Select System DSN, then click Add.¶
Select a MongoDB ODBC driver from the list of available drivers.¶
Select either the MongoDB ODBC 1.1.0 ANSI Driver or the MongoDB ODBC 1.1.0 Unicode Driver, then click OK.
Important
Tableau requires the MongoDB ODBC 1.1.0 ANSI Driver.
Important
Tableau requires the MongoDB ANSI ODBC driver.
Note
ANSI ODBC/Connectors offer better performance but have a limited character set. Unicode ODBC/Connectors support a wider character set but may be less performant.
Fill in the necessary form fields.¶
Click the Details button to expose the lower half of the form.
The following form fields are required:
| Field Name | Description |
|---|---|
| Data Source Name | A name of your choice. |
| TCP/IP Server | The hostname specified in the Atlas connect dialog. |
| Port | The IANA
port number
specified in the Atlas connect dialog. The default is
27015. |
| Database | The name of the database to which you want to connect. |
| User | Enter either the user specified in the Atlas connect dialog or another MongoDB user with access to the database. The user is specified in the following format: where the
|
| Password | The password that corresponds to the specified User. |
Click Test to validate the ODBC connection.¶
If the connection is successful, click OK to add the DSN. If the connection fails, check to make sure your MongoDB user is correctly authenticated for the database named in the connection.
Example
The values you enter will be different.
Launch ODBC Manager.¶
Note
ODBC Manager is included with the MongoDB ODBC driver.
Click System DSN, then click Add.¶
Select a MongoDB ODBC driver from the list of available drivers.¶
Select either the MongoDB ANSI ODBC driver or the MongoDB Unicode ODBC driver, then click OK.
Important
Tableau requires the MongoDB ODBC 1.1.0 ANSI Driver.
Important
Tableau requires the MongoDB ANSI ODBC driver.
Note
ANSI ODBC/Connectors offer better performance but have a limited character set. Unicode ODBC/Connectors support a wider character set but may be less performant.
Enter a Data Source Name (DSN).¶
Optionally enter a Description.
Note
Do not close the setup window. Proceed to the next step.
Add the necessary keywords.¶
- Click Add to add a keyword value pair.
- Modify the Keyword by double-clicking on it, entering the desired keyword, then pressing enter.
- Modify the Value by double-clicking on it, entering the desired keyword, then pressing enter.
Using the procedure above, add the following keywords:
| Keyword | Value |
|---|---|
| SERVER | The hostname specified in the Atlas connect dialog. |
| PORT | The IANA
port number
specified in the Atlas connect dialog. The default is
27015. |
| DATABASE | The database to use after connecting. Note Required when connecting with Microsoft Excel. |
| UID | The username for the user that can access the active Atlas database. Example The user
|
| PWD | The password associated with the UID. |
For the complete list of ODBC parameters, see Connector/ODBC Connection Parameters.
For example, your user DSN configuration should look similar to the following:
Note
Do not close the setup window. Proceed to the next step.