For AI agents: a documentation index is available at https://www.mongodb.com/docs/llms.txt — markdown versions of all pages are available by appending .md to any URL path.
Docs Menu

Install the MongoDB SQL Interface

The MongoDB SQL Interface lets you query your MongoDB data using standard SQL-based BI tools like Tableau, Power BI, and DBeaver.

To get started, use the following process:

1

Follow the instructions in Server Setup to configure your database to accept SQL connections. The setup process depends on your deployment type:

  • Atlas dedicated cluster: Enable the SQL Interface on the cluster, then generate a schema with the MongoDB SQL Schema Builder CLI. This is the recommended path for most Atlas connections.

  • Atlas federated database instance: Setup your federated database instance and generate schema for collections you wish to query with SQL.

  • Enterprise Advanced (EA): Configure your self-managed database and generate a SQL schema for your collections using the MongoDB SQL Schema Builder CLI. To learn more, see the MongoDB SQL Schema Builder README.

2

Follow the instructions in Driver Setup to install the correct driver (JDBC or ODBC) on your client machine.

3

Follow the instructions in Connect Your BI Tool to configure your specific BI tool to connect to your MongoDB database.

Flow diagram showing MongoDB connecting to a BI tool
through drivers and connectors.