sqldb - update query editor page

stevestein · stevestein · commit 312ebf43a43a · 2020-03-05T13:00:45.000-08:00
diff --git a/articles/sql-database/sql-database-connect-query-portal.md b/articles/sql-database/sql-database-connect-query-portal.md
@@ -11,80 +11,76 @@ ms.topic: quickstart
 author: Ninarn
 ms.author: ninarn
 ms.reviewer: carlrab
-ms.date: 10/24/2019
+ms.date: 03/05/2020
 ---
-# Quickstart: Use the Azure portal's SQL query editor to connect and query data
+# Quickstart: Use the Azure portal's SQL Database Query Editor to query a SQL database
 
-The SQL query editor is an Azure portal browser tool providing an easy way to execute SQL queries on your Azure SQL Database or Azure SQL Data Warehouse. In this quickstart, you'll use the query editor to connect to a SQL database and then run Transact-SQL statements to query, insert, update, and delete data.
+The query editor is a tool in the Azure portal for executing SQL queries against your Azure SQL Database or Azure SQL Data Warehouse. In this quickstart, you'll use the query editor to run Transact-SQL (T-SQL) statements to query, insert, update, and delete data.
 
 ## Prerequisites
 
 To complete this tutorial, you need:
 
-- An Azure SQL database. You can use one of these quickstarts to create and then configure a database in Azure SQL Database:
+- The AdventureWorksLT sample SQL Database. If you don't have the AdventureWorksLT SQL Database, use one of the following quickstarts to quickly create it:
 
   || Single database |
   |:--- |:--- |
   | Create| [Portal](sql-database-single-database-get-started.md) |
   || [CLI](scripts/sql-database-create-and-configure-database-cli.md) |
   || [PowerShell](scripts/sql-database-create-and-configure-database-powershell.md) |
-  | Configure | [Server-level IP firewall rule](sql-database-server-level-firewall-rule.md)|
   |||
 
 > [!NOTE]
 > The query editor uses ports 443 and 1443 to communicate.  Please ensure you have enabled outbound HTTPS traffic on these ports. You will also need to add your outbound IP address to the server's allowed firewall rules to access your databases and data warehouses.
 
-## Sign in the Azure portal
+## Open the SQL Database Query Editor
 
-Sign in to the [Azure portal](https://portal.azure.com/).
+1. Sign in to the [Azure portal](https://portal.azure.com/) and select your SQL database.
 
-## Connect using SQL authentication
+2. In the **SQL database** menu, select **Query editor (preview)**.
 
-1. Go to the Azure portal to connect to a SQL database. Search for and select **SQL databases**.
+    ![find query editor](./media/sql-database-connect-query-portal/find-query-editor.PNG)
 
-    ![Navigate to SQL database list, Azure portal](./media/sql-database-connect-query-portal/search-for-sql-databases.png)
 
-2. Select your SQL database.
 
-    ![Select a SQL database, Azure portal](./media/sql-database-connect-query-portal/select-a-sql-database.png)
+## Connect using SQL Authentication
 
-3. In the **SQL database** menu, select **Query editor (preview)**.
+1. In the **Login** page, under the **SQL server authentication** label, enter a **Login** and **Password** for a user that has access to the database. If you're not sure, use the login and password for the Server admin of the database's server.
 
-    ![find query editor](./media/sql-database-connect-query-portal/find-query-editor.PNG)
+    ![sign in](./media/sql-database-connect-query-portal/login-menu.png)
 
-4. In the **Login** page, under the **SQL server authentication** label, enter the **Login** ID and **Password** of the server admin account used to create the database. Then select **OK**.
+2. Select **OK**.
 
-    ![sign in](./media/sql-database-connect-query-portal/login-menu.png)
 
 ## Connect using Azure Active Directory
 
-Configuring an Azure Active Directory (Azure AD) administrator enables you to use a single identity to sign in to the Azure portal and your SQL database. Follow the steps below to configure an Azure AD admin for your SQL server.
+Configuring an Azure Active Directory (Azure AD) administrator enables you to use a single identity to sign in to the Azure portal and your SQL database. To connect to your database using Azure AD, follow the steps below to configure an Azure AD admin for your SQL server.
 
 > [!NOTE]
 > * Email accounts (for example, outlook.com, gmail.com, yahoo.com, and so on) aren't yet supported as Azure AD admins. Make sure to choose a user created either natively in the Azure AD, or federated into the Azure AD.
 > * Azure AD admin sign in doesn't work with accounts that have 2-factor authentication enabled.
 
-1. On the Azure portal menu or from the **Home** page, select **All resources**.
-
-2. Select your SQL server.
+1. In the Azure portal, select your SQL server.
 
-3. From the **SQL server** menu, under **Settings**, select **Active Directory admin**.
+2. On the **SQL server** menu, select **Active Directory admin**.
 
-4. From the SQL server **Active Directory admin** page toolbar, select **Set admin** and choose the user or group as your Azure AD admin.
+3. On the SQL server **Active Directory admin** page toolbar, select **Set admin** and choose the user or group as your Azure AD admin.
 
     ![select active directory](./media/sql-database-connect-query-portal/select-active-directory.png)
 
-5. From the **Add admin** page, in the search box, enter a user or group to find, select it as an admin, and then choose the **Select** button.
+4. On the **Add admin** page, in the search box, enter a user or group to find, select it as an admin, and then choose the **Select** button.
+
+5. Back in the SQL server **Active Directory admin** page toolbar, select **Save**.
 
-6. Back in the SQL server **Active Directory admin** page toolbar, select **Save**.
+### Connect to the database
 
-7. In the **SQL server** menu, select **SQL databases**, and then select your SQL database.
+6. In the **SQL server** menu, select **SQL databases**, and then select your SQL database.
 
-8. In the **SQL database** menu, select **Query editor (preview)**. In the **Login** page, under the **Active Directory authentication** label, a message appears saying you have been signed in if you're an Azure AD admin. Then select the **Continue as** *\<your user or group ID>* button.
+7. In the **SQL database** menu, select **Query editor (preview)**. In the **Login** page, under the **Active Directory authentication** label, a message appears saying you have been signed in if you're an Azure AD admin. Then select the **Continue as** *\<your user or group ID>* button. If the page indicates that you have not successfully logged in, you may need to refresh the page.
 
-## View data
+## Run a query to view data
 
-1. After you're authenticated, paste the following SQL in the query editor to retrieve the top 20 products by category.
+1. Paste the following query into the query editor:
 
    ```sql
     SELECT TOP 20 pc.Name as CategoryName, p.name as ProductName
@@ -93,13 +89,13 @@ Configuring an Azure Active Directory (Azure AD) administrator enables you to us
     ON pc.productcategoryid = p.productcategoryid;
    ```
 
-2. On the toolbar, select **Run** and then review the output in the **Results** pane.
+2. Select **Run** and then review the output in the **Results** pane.
 
    ![query editor results](./media/sql-database-connect-query-portal/query-editor-results.png)
 
-## Insert data
+## Run a query to insert data
 
-Run the following [INSERT](https://msdn.microsoft.com/library/ms174335.aspx) Transact-SQL statement to add a new product in the `SalesLT.Product` table.
+Run the following [INSERT](/sql/t-sql/statements/insert-transact-sql/) Transact-SQL statement to add a new product in the `SalesLT.Product` table.
 
 1. Replace the previous query with this one.
 
@@ -127,9 +123,9 @@ Run the following [INSERT](https://msdn.microsoft.com/library/ms174335.aspx) Tra
 2. Select **Run**  to insert a new row in the `Product` table. The **Messages** pane displays **Query succeeded: Affected rows: 1**.
 
 
-## Update data
+## Run a query to update data
 
-Run the following [UPDATE](https://msdn.microsoft.com/library/ms177523.aspx) Transact-SQL statement to modify your new product.
+Run the following [UPDATE](/sql/t-sql/queries/update-transact-sql/) Transact-SQL statement to modify your new product.
 
 1. Replace the previous query with this one.
 
@@ -141,9 +137,9 @@ Run the following [UPDATE](https://msdn.microsoft.com/library/ms177523.aspx) Tra
 
 2. Select **Run** to update the specified row in the `Product` table. The **Messages** pane displays **Query succeeded: Affected rows: 1**.
 
-## Delete data
+## Run a query to delete data
 
-Run the following [DELETE](https://msdn.microsoft.com/library/ms189835.aspx) Transact-SQL statement to remove your new product.
+Run the following [DELETE](/sql/t-sql/statements/delete-transact-sql/) Transact-SQL statement to remove your new product.
 
 1. Replace the previous query with this one:
 
@@ -159,19 +155,19 @@ Run the following [DELETE](https://msdn.microsoft.com/library/ms189835.aspx) Tra
 
 There are a few things to know when working with the query editor.
 
-* The query editor uses ports 443 and 1443 to communicate.  Please ensure you have enabled outbound HTTPS traffic on these ports. You will also need to add your outbound IP address to the server's allowed firewall rules to access your databases and data warehouses.
+* The query editor uses ports 443 and 1443 to communicate. Ensure you have enabled outbound HTTPS traffic on these ports. You will also need to add your outbound IP address to the server's allowed firewall rules to access your databases and data warehouses.
 
-* Pressing F5 refreshes the query editor page and any query being worked on is lost.
+* Pressing **F5** refreshes the query editor page and any query being worked on is lost.
 
 * Query editor doesn't support connecting to the `master` database.
 
 * There's a 5-minute timeout for query execution.
 
 * The query editor only supports cylindrical projection for geography data types.
 
-* There's no support for IntelliSense for database tables and views. However, the editor does support autocomplete on names that have already been typed.
+* There's no support for IntelliSense for database tables and views, but the editor does support autocomplete on names that have already been typed.
 
 
 ## Next steps
 
-To learn more about the Transact-SQL supported in Azure SQL databases, see [Resolving Transact-SQL differences during migration to SQL Database](sql-database-transact-sql-information.md).
+To learn more about the Transact-SQL (T-SQL) supported in Azure SQL databases, see [Resolving Transact-SQL differences during migration to SQL Database](sql-database-transact-sql-information.md).
