| title | Connect to Synapse SQL with SQL Server Management Studio |
|---|---|
| description | Use SQL Server Management Studio (SSMS) to connect to and query Synapse SQL in Azure Synapse Analytics. |
| author | azaricstefan |
| ms.service | azure-synapse-analytics |
| ms.topic | overview |
| ms.subservice | sql |
| ms.date | 02/04/2026 |
| ms.author | stefanazaric |
| ms.custom | sfi-image-nochange |
[!div class="op_single_selector"]
You can use SQL Server Management Studio (SSMS) to connect to and query Synapse SQL in Azure Synapse Analytics through either serverless SQL pool or dedicated SQL pool resources.
Note
Supported tools for serverless SQL pool:
- The mssql extension for Visual Studio Code.
- SSMS is partially supported starting from version 18.5. You can use it to connect and query only.
- SQL Server Management Studio (SSMS).
- A data warehouse. To create a data warehouse for dedicated SQL pool, see Create a dedicated SQL pool. For serverless SQL pool, a data warehouse named Built-in is already provisioned in your workspace at creation time.
- The fully qualified SQL Server name. To find this name, see Connect to Synapse SQL.
To connect to Synapse SQL using dedicated SQL pool, follow these steps:
-
Open SQL Server Management Studio (SSMS).
-
In the Connect to Server dialog box, fill in the fields, and then select Connect:
:::image type="content" source="../sql-data-warehouse/media/sql-data-warehouse-query-ssms/connect-object-explorer1.png" alt-text="Screenshot that shows the Connect to Server dialog box.":::
- Server name: Enter the server name previously identified.
- Authentication: Choose an authentication type, such as SQL Server Authentication or Active Directory Integrated Authentication.
- Login and Password: Enter your user name and password if SQL Server Authentication was selected.
-
Expand your Azure SQL Server in Object Explorer. You can view the databases associated with the server, such as the sample
AdventureWorksDWdatabase. You can expand the database to see the tables::::image type="content" source="../sql-data-warehouse/media/sql-data-warehouse-query-ssms/explore-tables.png" alt-text="Screenshot that shows the Object Explorer window.":::
To connect to Synapse SQL using serverless SQL pool, follow these steps:
-
Open SQL Server Management Studio (SSMS).
-
In the Connect to Server dialog box, fill in the fields, and then select Connect:
:::image type="content" source="media/get-started-ssms/connect-object-explorer1.png" alt-text="Screenshot that shows the Connect to Server dialog box for serverless SQL pool.":::
- Server name: Enter the server name previously identified.
- Authentication: Choose an authentication type, such as SQL Server Authentication or Microsoft Entra Authentication.
- Login and Password: Enter your user name and password if SQL Server Authentication was selected.
-
To explore, expand your Azure SQL server. You can view the databases associated with the server. Expand demo to see the content in your sample database.
:::image type="content" source="media/get-started-ssms/explore-tables.png" alt-text="Screenshot that shows the Object Explorer window for serverless SQL pool.":::
After you establish a database connection, you can query the data.
-
Right-click your database in SQL Server Object Explorer.
-
Select New Query. A new query window opens.
:::image type="content" source="../sql-data-warehouse/media/sql-data-warehouse-query-ssms/new-query.png" alt-text="Screenshot of the New Query window.":::
-
Copy the following Transact-SQL (T-SQL) query into the query window:
SELECT COUNT(*) FROM dbo.FactInternetSales;
-
Run the query by selecting
Executeor use the following shortcut:F5.:::image type="content" source="../sql-data-warehouse/media/sql-data-warehouse-query-ssms/execute-query.png" alt-text="Screenshot of the Execute button to run the query.":::
-
Look at the query results. In the following example, the
FactInternetSalestable has 60,398 rows.:::image type="content" source="../sql-data-warehouse/media/sql-data-warehouse-query-ssms/results.png" alt-text="Screenshot of the query results.":::
After you establish a database connection, you can query the data.
-
Right-click your database in SQL Server Object Explorer.
-
Select New Query. A new query window opens.
:::image type="content" source="media/get-started-ssms/new-query.png" alt-text="Screenshot of the New Query window for serverless SQL pool.":::
-
Copy the following Transact-SQL (T-SQL) query into the query window:
SELECT COUNT(*) FROM demo.dbo.usPopulationView;
-
Run the query by selecting
Executeor use the following shortcut:F5.:::image type="content" source="media/get-started-ssms/execute-query.png" alt-text="Screenshot of the Execute button to run the query for serverless SQL pool.":::
-
Look at the query results. In this example, the
usPopulationViewview has 3,664,512 rows.:::image type="content" source="media/get-started-ssms/results.png" alt-text="Screenshot of the query results for serverless SQL pool.":::