Quick Start
This page guides you through enabling the Atlas SQL Interface quickly. If you follow the Quick Start steps, it results in an Atlas SQL-specific federated database instance that maps to data on the cluster that you used to enable Atlas SQL. You cannot modify this federated database instance, but you can delete it.
Prerequisites
Any Atlas cluster running MongoDB version 5.0 or higher and containing data. You can use your own data or import MongoDB sample data.
A MongoDB database user with which to connect.
Enable Atlas SQL for Your Cluster Data
To enable the Atlas SQL Interface with an Atlas-managed federated database instance:
Navigate to your Database Deployments in Atlas.
Select Database from the left navigation panel.
On the deployment you want to query with SQL, connect with Atlas SQL.
Click the Connect link at the bottom of your deployment card, under Atlas SQL.
A connection dialog box opens.
Select Quick Start.
Click Create to create an Atlas SQL connection for your cluster.
Note
Atlas creates and manages a federated database instance in the background to support the SQL connection.
To view or delete the federated database instance created with Quick Start, select Data Federation from the left navigation panel. Your federated database instance appears under Quick Start Atlas SQL federated database instance. You cannot modify this federated database instance.
From the Select your driver dropdown, select a driver.
Select a database and copy your connection settings.
Select a database from the Database dropdown.
Save your connection information. You'll need this in a later step.
Next Steps
You have now successfully enabled Atlas SQL on a federated database instance that maps data on the database in the Atlas cluster that you specified.
To connect to this federated database instance and query your data with Atlas SQL, see Connect.