Merge pull request #107557 from stevestein/sqldb-connect-ssms

sqldb - update connect ssms article

Author: GitHubber17

articles/sql-database/sql-database-connect-query-ssms.md

@@ -11,73 +11,61 @@ ms.topic: quickstart
 author: stevestein
 ms.author: sstein
 ms.reviewer:
-ms.date: 03/25/2019
+ms.date: 03/10/2020
 ---
 # Quickstart: Use SQL Server Management Studio to connect and query an Azure SQL database
 
-In this quickstart, you'll use [SQL Server Management Studio][ssms-install-latest-84g] (SSMS) to connect to an Azure SQL database. You'll then run Transact-SQL statements to query, insert, update, and delete data. You can use SSMS to manage any SQL infrastructure, from SQL Server to SQL Database for Microsoft Windows.  
+In this quickstart, you'll learn how to use SQL Server Management Studio (SSMS) to connect to an Azure SQL database and run some queries.
 
 ## Prerequisites
 
-An Azure SQL database. You can use one of these quickstarts to create and then configure a database in Azure SQL Database:
+Completing this quickstart requires the following items:
 
-  || Single database | Managed instance |
-  |:--- |:--- |:---|
-  | Create| [Portal](sql-database-single-database-get-started.md) | [Portal](sql-database-managed-instance-get-started.md) |
-  || [CLI](scripts/sql-database-create-and-configure-database-cli.md) | [CLI](https://medium.com/azure-sqldb-managed-instance/working-with-sql-managed-instance-using-azure-cli-611795fe0b44) |
-  || [PowerShell](scripts/sql-database-create-and-configure-database-powershell.md) | [PowerShell](scripts/sql-database-create-configure-managed-instance-powershell.md) |
-  | Configure | [Server-level IP firewall rule](sql-database-server-level-firewall-rule.md)| [Connectivity from a VM](sql-database-managed-instance-configure-vm.md)|
-  |||[Connectivity from on-site](sql-database-managed-instance-configure-p2s.md)
-  |Load data|Adventure Works loaded per quickstart|[Restore Wide World Importers](sql-database-managed-instance-get-started-restore.md)
-  |||Restore or import Adventure Works from [BACPAC](sql-database-import.md) file from [GitHub](https://github.com/Microsoft/sql-server-samples/tree/master/samples/databases/adventure-works)|
+- [SQL Server Management Studio (SSMS)](/sql/ssms/download-sql-server-management-studio-ssms/).
+- The AdventureWorksLT sample database. If you need a working copy of the AdventureWorksLT database, create one by completing the [Create an Azure SQL database](sql-database-single-database-get-started.md) quickstart.
+    - The scripts in this article are written to use the AdventureWorksLT database. If you are using a managed instance, you must either import the AdventureWorks database into an instance database or modify the scripts in this article to use the Wide World Importers database.
 
-  > [!IMPORTANT]
-  > The scripts in this article are written to use the Adventure Works database. With a managed instance, you must either import the Adventure Works database into an instance database or modify the scripts in this article to use the Wide World Importers database.
-
-## Install the latest SSMS
-
-Before you start, make sure you've installed the latest [SSMS][ssms-install-latest-84g].
+If you simply want to run some ad-hoc queries without installing SSMS, see [Quickstart: Use the Azure portal's query editor to query a SQL database](sql-database-connect-query-portal.md).
 
 ## Get SQL server connection information
 
-Get the connection information you need to connect to the Azure SQL database. You'll need the fully qualified server name or host name, database name, and login information for the upcoming procedures.
+Get the connection information you need to connect to your database. You'll need the fully qualified server name or host name, database name, and login information to complete this quickstart.
 
 1. Sign in to the [Azure portal](https://portal.azure.com/).
 
-2. Navigate to the **SQL databases**  or **SQL managed instances** page.
+2. Navigate to the **SQL database** or **SQL managed instance** you want to query.
 
-3. On the **Overview** page, review the fully qualified server name next to **Server name** for a single database or the fully qualified server name next to **Host** for a managed instance. To copy the server name or host name, hover over it and select the **Copy** icon.
+3. On the **Overview** page, copy the fully qualified server name. It's next to **Server name** for a single database, or the fully qualified server name next to **Host** for a managed instance. The fully qualified name looks like: *servername.database.windows.net*, except it has your actual server name.
 
 ## Connect to your database
 
-In SMSS, connect to your Azure SQL Database server.
+In SSMS, connect to your Azure SQL Database server.
 
 > [!IMPORTANT]
 > An Azure SQL Database server listens on port 1433. To connect to a SQL Database server from behind a corporate firewall, the firewall must have this port open.
->
 
-1. Open SSMS. The **Connect to Server** dialog box appears.
+1. Open SSMS.
 
-2. Enter the following information:
+2. The **Connect to Server** dialog box appears. Enter the following information:
 
    | Setting      | Suggested value    | Description |
    | ------------ | ------------------ | ----------- |
    | **Server type** | Database engine | Required value. |
-   | **Server name** | The fully qualified server name | Something like: **mynewserver20170313.database.windows.net**. |
+   | **Server name** | The fully qualified server name | Something like: **servername.database.windows.net**. |
    | **Authentication** | SQL Server Authentication | This tutorial uses SQL Authentication. |
    | **Login** | Server admin account user ID | The user ID from the server admin account used to create the server. |
    | **Password** | Server admin account password | The password from the server admin account used to create the server. |
    ||||
 
    ![connect to server](./media/sql-database-connect-query-ssms/connect.png)  
 
-3. Select **Options** in the **Connect to Server** dialog box. In the **Connect to database** drop-down menu, select **mySampleDatabase**.If you leave the drop down to default, the connection is made to **master** database.
+3. Select **Options** in the **Connect to Server** dialog box. In the **Connect to database** drop-down menu, select **mySampleDatabase**. Completing the quickstart in the [Prerequisites section](#prerequisites) creates an AdventureWorksLT database named mySampleDatabase. If your working copy of the AdventureWorks database has a different name than mySampleDatabase, then select it instead.
 
    ![connect to db on server](./media/sql-database-connect-query-ssms/options-connect-to-db.png)  
 
 4. Select **Connect**. The Object Explorer window opens.
 
-5. To view the database's objects, expand **Databases** and then expand **mySampleDatabase**.
+5. To view the database's objects, expand **Databases** and then expand your database node.
 
    ![mySampleDatabase objects](./media/sql-database-connect-query-ssms/connected.png)  
 
@@ -87,7 +75,7 @@ Run this [SELECT](https://msdn.microsoft.com/library/ms189499.aspx) Transact-SQL
 
 1. In Object Explorer, right-click **mySampleDatabase** and select **New Query**. A new query window connected to your database opens.
 
-2. In the query window, paste this SQL query.
+2. In the query window, paste the following SQL query:
 
    ```sql
    SELECT pc.Name as CategoryName, p.name as ProductName
@@ -96,11 +84,11 @@ Run this [SELECT](https://msdn.microsoft.com/library/ms189499.aspx) Transact-SQL
    ON pc.productcategoryid = p.productcategoryid;
    ```
 
-3. On the toolbar, select **Execute** to retrieve data from the `Product` and `ProductCategory` tables.
+3. On the toolbar, select **Execute** to run the query and retrieve data from the `Product` and `ProductCategory` tables.
 
     ![query to retrieve data from table Product and ProductCategory](./media/sql-database-connect-query-ssms/query2.png)
 
-## Insert data
+### Insert data
 
 Run this [INSERT](https://msdn.microsoft.com/library/ms174335.aspx) Transact-SQL code to create a new product in the `SalesLT.Product` table.
 
@@ -127,7 +115,7 @@ Run this [INSERT](https://msdn.microsoft.com/library/ms174335.aspx) Transact-SQL
 
 2. Select **Execute**  to insert a new row in the `Product` table. The **Messages** pane displays **(1 row affected)**.
 
-## View the result
+#### View the result
 
 1. Replace the previous query with this one.
 
@@ -140,11 +128,11 @@ Run this [INSERT](https://msdn.microsoft.com/library/ms174335.aspx) Transact-SQL
 
    ![result of Product table query](./media/sql-database-connect-query-ssms/result.png)
 
-## Update data
+### Update data
 
 Run this [UPDATE](https://msdn.microsoft.com/library/ms177523.aspx) Transact-SQL code to modify your new product.
 
-1. Replace the previous query with this one.
+1. Replace the previous query with this one that returns the new record created previously:
 
    ```sql
    UPDATE [SalesLT].[Product]
@@ -154,7 +142,7 @@ Run this [UPDATE](https://msdn.microsoft.com/library/ms177523.aspx) Transact-SQL
 
 2. Select **Execute** to update the specified row in the `Product` table. The **Messages** pane displays **(1 row affected)**.
 
-## Delete data
+### Delete data
 
 Run this [DELETE](https://msdn.microsoft.com/library/ms189835.aspx) Transact-SQL code to remove your new product.
 
@@ -178,7 +166,3 @@ Run this [DELETE](https://msdn.microsoft.com/library/ms189835.aspx) Transact-SQL
 - To connect and query using Java, see [Connect and query with Java](sql-database-connect-query-java.md).
 - To connect and query using Python, see [Connect and query with Python](sql-database-connect-query-python.md).
 - To connect and query using Ruby, see [Connect and query with Ruby](sql-database-connect-query-ruby.md).
-
-<!-- Article link references. -->
-
-[ssms-install-latest-84g]: https://docs.microsoft.com/sql/ssms/sql-server-management-studio-ssms