| title | description | author | ms.author | ms.reviewer | ms.date | ms.service | ms.topic | ms.collection | ms.custom | f1_keywords | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Connect and Query SQL Server Using SSMS |
Connect to a SQL Server instance in SSMS. Create and query a SQL Server database in SSMS running basic Transact-SQL (T-SQL) queries. |
erinstellato-ms |
erinstellato |
mikeray, randolphwest, mbarickman |
04/16/2025 |
sql-server-management-studio |
quickstart |
|
|
|
[!INCLUDE sqlserver]
Get started using SQL Server Management Studio (SSMS) to connect to your SQL Server instance and run some Transact-SQL (T-SQL) commands.
[!INCLUDE entra-id]
The article demonstrates how to follow the below steps:
[!div class="checklist"]
- Connect to a SQL Server instance
- Create a database
- Create a table in your new database
- Insert rows into your new table
- Query the new table and view the results
- Use the query window table to verify your connection properties
This article covers connecting and querying an instance of SQL Server. For Azure SQL, see Connect and query Azure SQL Database & SQL Managed Instance.
To use Azure Data Studio, see connect and query SQL Server, Azure SQL Database, and Azure Synapse Analytics.
To learn more about SQL Server Management Studio, see Tips and tricks for using SQL Server Management Studio (SSMS).
To complete this quickstart, you need the following prerequisites:
- Install SQL Server Management Studio (SSMS).
- Install SQL Server from the Installation Wizard (Setup) and configure a SQL Server instance.
To connect to your SQL Server instance, follow these steps:
-
Start SQL Server Management Studio. The first time you run SSMS, the Connect to Server window opens. If it doesn't open, you can open it manually by selecting Object Explorer > Connect > Database Engine.
:::image type="content" source="media/ssms-connect-query-sql-server/connect-object-explorer.png" alt-text="Screenshot of the connect link in Object Explorer.":::
-
The Connect to Server dialog box appears. In SSMS 21 Preview, you can customize your connection dialog experience in Tools > Options > Environment > Connection Dialog. Use the Modern connection dialog for a modern format when connecting to the Database Engine. Use the Classic connection dialog experience when connecting to the Database Engine, and SQL Server Analysis Services (SSAS), SQL Server Reporting Services (SSRS), and SQL Server Integration Services (SSIS).
Modern connection dialog:
:::image type="content" source="media/ssms-connect-query-sql-server/ssms-21-modern-connection-dialog-preview.png" alt-text="Screenshot of modern connection dialog for SQL Server.":::
Setting Suggested values Description Server Name The fully qualified server name For Server name, enter the name of your SQL Server (you can also use localhost as the server name if you're connecting locally). If you're NOT using the default instance - MSSQLSERVER - you must enter in the server name and the instance name.
If you're unsure how to determine your SQL Server instance name, see Additional tips and tricks for using SSMS.Authentication Windows Authentication
SQL Server Authentication
Microsoft Entra authenticationWindows Authentication is set as default.
You can also use SQL Server Authentication to connect. However, if you select SQL Server Authentication, a username and password are required.
Microsoft Entra authentication is available for [!INCLUDE sssql22-md] and later versions. For step-by-step configuration instructions, see Tutorial: Set up Microsoft Entra authentication for SQL Server
For more information about authentication types, see Connect to the server (database engine).User Name Server account user ID The user ID from the server account used to sign in to the server. A login is required when using SQL Server Authentication. Password Server account password The password from the server account used to sign in to the server. A password is required when using SQL Server Authentication. Database Name (optional) Name of the database For Database name, enter the name of the database you want to connect to. The default value <default> is typically set to master.Encrypt 1 Encryption method Select the encryption level for the connection. The default value is Mandatory. Trust Server Certificate Trust Server Certificate Check this option to bypass server certificate validation. The default value is False (unchecked), which promotes better security using trusted certificates. Color (optional) <default> Selecting a color changes the status bar color to help organize and identify your connections. The default value for Color is the default color for the status bar, but you can also choose from the following values: Red, Green, Blue, Yellow, and Orange. You can define a custom color using the Custom... button. 1 [!INCLUDE ssms-encryption]
You can modify extra connection options by selecting Advanced.... Examples of connection options include the connection timeout value, application intent, and the network protocol. This article uses default values for these fields.
Classic connection dialog:
:::image type="content" source="media/ssms-connect-query-sql-server/connect-to-sql-server-object-explorer-ssms20.png" alt-text="Screenshot of classic connection dialog for SQL Server.":::
Setting Suggested values Description Server type Database Engine For Server type, select Database Engine (usually the default option). Server name The fully qualified server name For Server name, enter the name of your SQL Server (you can also use localhost as the server name if you're connecting locally). If you're NOT using the default instance - MSSQLSERVER - you must enter in the server name and the instance name.
If you're unsure how to determine your SQL Server instance name, see Additional tips and tricks for using SSMS.Authentication Windows Authentication
SQL Server Authentication
Microsoft Entra authenticationWindows Authentication is set as default.
You can also use SQL Server Authentication to connect. However, if you select SQL Server Authentication, a username and password are required.
Microsoft Entra authentication is available for [!INCLUDE sssql22-md] and later versions. For step-by-step configuration instructions, see Tutorial: Set up Microsoft Entra authentication for SQL Server
For more information about authentication types, see Connect to the server (database engine).Login Server account user ID The user ID from the server account used to sign in to the server. A login is required when using SQL Server Authentication. Password Server account password The password from the server account used to sign in to the server. A password is required when using SQL Server Authentication. Encryption 1 Encryption method Select the encryption level for the connection. The default value is Mandatory. Trust server certificate Trust Server Certificate Check this option to bypass server certificate validation. The default value is False (unchecked), which promotes better security using trusted certificates. Host Name in Certificate Host name of the server The value provided in this option is used to specify a different, but expected, CN or SAN in the server certificate. 1 [!INCLUDE ssms-encryption]
You can modify extra connection options by selecting Options. Examples of connection options include the connection timeout value, application intent, and the network protocol. This article uses default values for these fields.
-
After you complete all the fields, select Connect.
-
To verify that your SQL Server connection succeeded, expand and explore the objects within Object Explorer where the server name, the SQL Server version, and the username are displayed. These objects are different depending on the server type.
:::image type="content" source="media/ssms-connect-query-sql-server/connect-on-prem.png" alt-text="Screenshot of connecting to an on-premises server.":::
Now let's create a database named TutorialDB by following the below steps:
-
Right-click your server instance in Object Explorer, and then select New Query:
:::image type="content" source="media/ssms-connect-query-sql-server/new-query.png" alt-text="Screenshot of the new query link.":::
-
Paste the following T-SQL code snippet into the query window:
USE master GO IF NOT EXISTS ( SELECT name FROM sys.databases WHERE name = N'TutorialDB' ) CREATE DATABASE [TutorialDB] GO
-
Execute the query by selecting Execute or selecting F5 on your keyboard.
:::image type="content" source="media/ssms-connect-query-sql-server/execute.png" alt-text="Screenshot of the Execute command.":::
After the query is complete, the new TutorialDB database appears in the list of databases in Object Explorer. If it isn't displayed, right-click the Databases node, and then select Refresh.
In this section, you create a table in the newly created TutorialDB database. Because the query editor is still in the context of the master database, switch the connection context to the TutorialDB database by doing the following steps:
-
In the database dropdown list, select the database that you want, as shown here:
:::image type="content" source="media/ssms-connect-query-sql-server/change-db.png" alt-text="Screenshot of change database.":::
-
Paste the following T-SQL code snippet into the query window:
USE [TutorialDB] -- Create a new table called 'Customers' in schema 'dbo' -- Drop the table if it already exists IF OBJECT_ID('dbo.Customers', 'U') IS NOT NULL DROP TABLE dbo.Customers GO -- Create the table in the specified schema CREATE TABLE dbo.Customers ( CustomerId INT NOT NULL PRIMARY KEY, -- primary key column Name NVARCHAR(50) NOT NULL, Location NVARCHAR(50) NOT NULL, Email NVARCHAR(50) NOT NULL ); GO
-
Execute the query by selecting Execute or selecting F5 on your keyboard.
After the query is complete, the new Customers table is displayed in the list of tables in Object Explorer. If the table isn't displayed, right-click the TutorialDB > Tables node in Object Explorer, and then select Refresh.
:::image type="content" source="media/ssms-connect-query-sql-server/new-table.png" alt-text="Screenshot of new table.":::
Now let's insert some rows into the Customers table that you created. Paste the following T-SQL code snippet into the query window, and then select Execute:
-- Insert rows into table 'Customers'
INSERT INTO dbo.Customers
([CustomerId],[Name],[Location],[Email])
VALUES
( 1, N'Orlando', N'Australia', N''),
( 2, N'Keith', N'India', N'[email protected]'),
( 3, N'Donna', N'Germany', N'[email protected]'),
( 4, N'Janet', N'United States', N'[email protected]')
GOThe results of a query are visible below the query text window. To query the Customers table and view the rows that were inserted, paste the following T-SQL code snippet into the query window, and then select Execute:
-- Select rows from table 'Customers'
SELECT * FROM dbo.Customers;The query results are displayed under the area where the text was entered.
:::image type="content" source="media/ssms-connect-query-sql-server/query-results.png" alt-text="Screenshot of the results list.":::
You can also modify the way results are presented by selecting one of the following options:
:::image type="content" source="media/ssms-connect-query-sql-server/results.png" alt-text="Screenshot of three options for displaying query results.":::
- The first button displays the results in Text View, as shown in the image in the next section.
- The middle button displays the results in Grid View, which is the default option.
- The third button lets you save the results to a file whose extension is .rpt by default.
To review troubleshooting techniques to use when you can't connect to an instance of your SQL Server Database Engine on a single server, visit Troubleshoot connecting to the SQL Server Database Engine.