Merge pull request #17571 from MicrosoftDocs/master

10/15 PM Publish

Author: huypub

docs/azure-data-studio/media/quickstart-sql-dw/create-rows.png

@@ -1,24 +1,24 @@
 ---
 title: Connect and query with Azure Synapse Analytics
-description: This quickstart shows how to use Azure Data Studio to connect to using dedicated SQL pool in Azure Synapse Analytics and run a query.
+description: This quickstart shows connecting to a dedicated SQL pool in Azure Synapse Analytics using Azure Data Studio.
 ms.prod: azure-data-studio
 ms.technology: azure-data-studio
-ms.reviewer: "alayu, maghan, sstein"
 ms.topic: quickstart
 author: yualan
 ms.author: alayu
+ms.reviewer: alayu, jrasnick
 ms.custom: seodec18; seo-lt-2019
-ms.date: 09/24/2018
+ms.date: 10/15/2020
 ---
 
 # Quickstart: Use Azure Data Studio to connect and query data using dedicated SQL pool in Azure Synapse Analytics
 
-This quickstart demonstrates how to use Azure Data Studio to connect to using dedicated SQL pool in Azure Synapse Analytics, and then use Transact-SQL statements to create, insert, and select data. 
+This quickstart shows connecting to a dedicated SQL pool in Azure Synapse Analytics using Azure Data Studio.
 
 ## Prerequisites
 To complete this quickstart, you need Azure Data Studio, and a dedicated SQL pool in Azure Synapse Analytics.
 
-- [Install Azure Data Studio](./download-azure-data-studio.md?view=sql-server-ver15).
+- [Install Azure Data Studio](./download-azure-data-studio.md).
 
 If you don't already have a dedicated SQL pool, see [Create a dedicated SQL pool](/azure/sql-data-warehouse/sql-data-warehouse-get-started-provision).
 
@@ -29,34 +29,31 @@ Remember the server name, and login credentials!
 
 Use Azure Data Studio to establish a connection to your Azure Synapse Analytics server.
 
-1. The first time you run Azure Data Studio the **Connection** page should open. If you don't see the **Connection** page, click **Add Connection**, or the **New Connection** icon in the **SERVERS** sidebar:
+1. The first time you run Azure Data Studio the **Connection** page should open. If you don't see the **Connection** page, select **Add Connection**, or the **New Connection** icon in the **SERVERS** sidebar:
 
    ![New Connection Icon](media/quickstart-sql-dw/new-connection-icon.png)
 
 2. This article uses *SQL Login*, but *Windows Authentication* is also supported. Fill in the fields as follows using the server name, user name, and password for *your* Azure SQL server:
 
-   | Setting       | Suggested value | Description |
-   | ------------ | ------------------ | ------------------------------------------------- | 
-   | **Server name** | The fully qualified server name | The name should be something like this: **sqldwsample.database.windows.net** |
+   |   Setting    | Suggested value | Description |
+   |--------------|-----------------|-------------| 
+   | **Server name** | The fully qualified server name | For example the name should look like to this: **sqlpoolservername.database.windows.net**. |
    | **Authentication** | SQL Login| SQL Authentication is used in this tutorial. |
    | **User name** | The server admin account | This is the account that you specified when you created the server. |
    | **Password (SQL Login)** | The password for your server admin account | This is the password that you specified when you created the server. |
-   | **Save Password?** | Yes or No | Select Yes if you do not want to enter the password each time. |
+   | **Save Password?** | Yes or No | Select Yes if you don't want to enter the password each time. |
    | **Database name** | *leave blank* | The name of the database to which to connect. |
    | **Server Group** | Select <Default> | If you created a server group, you can set to a specific server group. | 
 
-   ![New Connection Icon](media/quickstart-sql-dw/new-connection-screen.png) 
-
 3. If your server doesn't have a firewall rule allowing Azure Data Studio to connect, the **Create new firewall rule** form opens. Complete the form to create a new firewall rule. For details, see [Firewall rules](/azure/sql-database/sql-database-firewall-configure).
 
-   ![New firewall rule](media/quickstart-sql-dw/firewall.png)  
-
 4. After successfully connecting your server opens in the *Servers* sidebar.
 
-## Create the tutorial dedicated SQL pool
-1. Right click on your server, in the object explorer and select **New Query.**
+## Create a database in your dedicated SQL pool
+
+1. Right-click on your server, in the object explorer and select **New Query.**
 
-1. Paste the following snippet into the query editor and click **Run**:
+2. Paste the following snippet into the query editor and select **Run**:
 
    ```sql
     IF NOT EXISTS (
@@ -71,20 +68,16 @@ Use Azure Data Studio to establish a connection to your Azure Synapse Analytics
     GO
    ```
 
-
 ## Create a table
 
 The query editor is still connected to the *master* database, but we want to create a table in the *TutorialDB* database. 
 
 1. Change the connection context to **TutorialDB**:
 
-   ![Change context](media/quickstart-sql-database/change-context.png)
-
-
-1. Paste the following snippet into the query editor and click **Run**:
+2. Paste the following snippet into the query editor and select **Run**:
 
    > [!NOTE]
-   > You can append this to, or overwrite the previous query in the editor. Note that clicking **Run** executes only the query that is selected. If nothing is selected, clicking **Run** executes all queries in the editor.
+   > You can append this to, or overwrite the previous query in the editor. Note that selecting **Run** executes only the query that is selected. If nothing is selected, selecting **Run** executes all queries in the editor.
 
    ```sql
    -- Create a new table called 'Customers' in schema 'dbo'
@@ -103,10 +96,12 @@ The query editor is still connected to the *master* database, but we want to cre
    GO
    ```
 
+    :::image type="content" source="media/quickstart-sql-dw/create-table.png" alt-text="Create a table in the TutorialDB database":::
+
 
 ## Insert rows
 
-1. Paste the following snippet into the query editor and click **Run**:
+1. Paste the following snippet into the query editor and select **Run**:
 
    ```sql
    -- Insert rows into table 'Customers'
@@ -118,25 +113,25 @@ The query editor is still connected to the *master* database, but we want to cre
       SELECT 4, N'Janet', N'United States', N'janet1@adventure-works.com'
    ```
 
+    :::image type="content" source="media/quickstart-sql-dw/create-rows.png" alt-text="Create rows in the table":::
 
 ## View the result
-1. Paste the following snippet into the query editor and click **Run**:
+
+1. Paste the following snippet into the query editor and select **Run**:
 
    ```sql
    -- Select rows from table 'Customers'
    SELECT * FROM dbo.Customers;
    ```
 
-1. The results of the query are displayed:
+2. The results of the query are displayed:
 
-   ![Select results](media/quickstart-sql-dw/select-results.png)
+    :::image type="content" source="media/quickstart-sql-dw/view-results.png" alt-text="View the results":::
 
 
 ## Clean up resources
 
-Other articles in this collection build upon this quickstart. If you plan to continue on to work with subsequent quickstarts, do not clean up the resources created in this quickstart. If you do not plan to continue, use the following steps to delete resources created by this quickstart in the Azure portal.
-Clean up resources by deleting the resource groups you no longer need. For details, see [Clean up resources](/azure/sql-database/sql-database-get-started-portal#clean-up-resources).
-
+If you don't plan to continue working with the sample databases created in this article, then [delete the resource group](/azure/azure/synapse-analytics/sql-data-warehouse/create-data-warehouse-portal#clean-up-resources).
 
 ## Next steps
 

docs/azure-data-studio/media/quickstart-sql-dw/create-table.png

@@ -20,7 +20,7 @@ landingContent:
       - text: Introduction to Linux
         url: new-to-linux-resources.md
       - text: "Learn: SQL Server on Linux"
-        url: https://docs.microsoft.com/learn/modules/introduction-sql-server-linux/
+        url: /learn/modules/introduction-sql-server-linux/
       - text: "Channel 9 - How SQL Server runs on Linux (optional)"
         url: https://channel9.msdn.com/Shows/Data-Exposed/SQL-Server-on-Linux-The-HOW?term=sql%20server%20on%20Linux&lang-en=true
       - text: "Channel 9 - SQL Server on Linux (optional)"
@@ -99,4 +99,4 @@ landingContent:
       - text: DMVs
         url: ../relational-databases/system-dynamic-management-views/system-dynamic-management-views.md
       - text: Additional learning - Performance features of SQL Server on Linux
-        url: sql-server-linux-performance-get-started.md
+        url: sql-server-linux-performance-get-started.md

docs/azure-data-studio/media/quickstart-sql-dw/new-connection-icon.png

@@ -13,7 +13,7 @@ ms.assetid:
 # Quickstart: Run SQL Server in the cloud
 [!INCLUDE [SQL Server - Linux](../includes/applies-to-version/sql-linux.md)]
 
-In this quickstart, you will install SQL Server on Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES), or Ubuntu in the cloud of your choice. Go to [Provision a Linux SQL Server virtual machine in the Azure portal](https://docs.microsoft.com/azure/virtual-machines/linux/sql/provision-sql-server-linux-virtual-machine?toc=/sql/toc/toc.json) to run SQL Server on Linux in Azure.
+In this quickstart, you will install SQL Server on Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES), or Ubuntu in the cloud of your choice. Go to [Provision a Linux SQL Server virtual machine in the Azure portal](/azure/virtual-machines/linux/sql/provision-sql-server-linux-virtual-machine?toc=%252fsql%252ftoc%252ftoc.json) to run SQL Server on Linux in Azure.
 
 > [!NOTE]
 > If you choose to run a paid edition of SQL Server, then you need to bring your own license (BYOL).
@@ -56,4 +56,4 @@ In this quickstart, you will install SQL Server on Red Hat Enterprise Linux (RHE
     * [Ubuntu](quickstart-install-connect-ubuntu.md)
 1.	Configure for remote connections: 
     * Go to the [Firewall Rules](https://console.cloud.google.com/networking/firewalls)
-    * Add an inbound rule to allow traffic on the port on which SQL Server listens (default tcp: 1433)
+    * Add an inbound rule to allow traffic on the port on which SQL Server listens (default tcp: 1433)

docs/azure-data-studio/media/quickstart-sql-dw/view-results.png

@@ -127,7 +127,7 @@ Before starting the following steps, make sure that you have selected your prefe
    > [!NOTE]
    > The password should follow the SQL Server default password policy, otherwise the container can not setup SQL server and will stop working. By default, the password must be at least 8 characters long and contain characters from three of the following four sets: Uppercase letters, Lowercase letters, Base 10 digits, and Symbols. You can examine the error log by executing the [docker logs](https://docs.docker.com/engine/reference/commandline/logs/) command.
    >
-   > By default, this creates a container with the Developer edition of SQL Server 2017. The process for running production editions in containers is slightly different. For more information, see [Run production container images](sql-server-linux-configure-docker.md#production).
+   > By default, this creates a container with the Developer edition of SQL Server 2017. The process for running production editions in containers is slightly different. For more information, see [Run production container images](./sql-server-linux-docker-container-deployment.md#production).
 
    The following table provides a description of the parameters in the previous `docker run` example:
 
@@ -166,7 +166,7 @@ Before starting the following steps, make sure that you have selected your prefe
 
    ![Docker ps command output](./media/sql-server-linux-setup-docker/docker-ps-command.png)
 
-4. If the **STATUS** column shows a status of **Up**, then SQL Server is running in the container and listening on the port specified in the **PORTS** column. If the **STATUS** column for your SQL Server container shows **Exited**, see the [Troubleshooting section of the configuration guide](sql-server-linux-configure-docker.md#troubleshooting).
+4. If the **STATUS** column shows a status of **Up**, then SQL Server is running in the container and listening on the port specified in the **PORTS** column. If the **STATUS** column for your SQL Server container shows **Exited**, see the [Troubleshooting section of the configuration guide](./sql-server-linux-docker-container-troubleshooting.md).
 
 The `-h` (host name) parameter as discussed above, changes the internal name of the container to a custom value. This is the name you'll see returned in the following Transact-SQL query:
 
@@ -218,7 +218,7 @@ Before starting the following steps, make sure that you have selected your prefe
    > [!TIP]
    > This quickstart uses the SQL Server 2019 Docker image. If you want to run the SQL Server 2017 image, see the [SQL Server 2017 version of this article](quickstart-install-connect-docker.md?view=sql-server-linux-2017#pullandrun2017).
 
-   The previous command pulls the SQL Server 2019 container image based on Ubuntu. To instead use container images based on RedHat, see [Run RHEL-based container images](sql-server-linux-configure-docker.md#rhel). To see all available images, see [the mssql-server-linux Docker hub page](https://hub.docker.com/_/microsoft-mssql-server).
+   The previous command pulls the SQL Server 2019 container image based on Ubuntu. To instead use container images based on RedHat, see [Run RHEL-based container images](./sql-server-linux-docker-container-deployment.md#rhel). To see all available images, see [the mssql-server-linux Docker hub page](https://hub.docker.com/_/microsoft-mssql-server).
 
    ::: zone pivot="cs1-bash"
    For the bash commands in this article, `sudo` is used. On macOS, `sudo` might not be required. On Linux, if you do not want to use `sudo` to run Docker, you can configure a **docker** group and add users to that group. For more information, see [Post-installation steps for Linux](https://docs.docker.com/install/linux/linux-postinstall/).
@@ -495,7 +495,7 @@ The following steps use **sqlcmd** outside of your container to connect to SQL S
 
 Other common tools to connect to SQL Server include:
 
-- [Visual Studio Code](sql-server-linux-develop-use-vscode.md)
+- [Visual Studio Code](../tools/visual-studio-code/sql-server-develop-use-vscode.md)
 - [SQL Server Management Studio (SSMS) on Windows](sql-server-linux-manage-ssms.md)
 - [Azure Data Studio](../azure-data-studio/what-is.md)
 - [mssql-cli (Preview)](https://github.com/dbcli/mssql-cli/blob/master/doc/usage_guide.md)
@@ -539,4 +539,4 @@ After you have tried using the SQL Server container image for Docker, you might
 
 For a tutorial on how to restore database backup files into a container, see [Restore a SQL Server database in a Linux Docker container](tutorial-restore-backup-in-sql-server-container.md). Explore other scenarios, such as running [multiple containers](sql-server-linux-docker-container-deployment.md#multiple), [data persistence](sql-server-linux-docker-container-configure.md#persist), and [troubleshooting](sql-server-linux-docker-container-troubleshooting.md).
 
-Also, check out the [mssql-docker GitHub repository](https://github.com/Microsoft/mssql-docker) for resources, feedback, and known issues.
+Also, check out the [mssql-docker GitHub repository](https://github.com/Microsoft/mssql-docker) for resources, feedback, and known issues.

docs/azure-data-studio/quickstart-sql-dw.md

@@ -47,7 +47,7 @@ You must have a RHEL 7.3, 7.4, 7.5, 7.6, or 8.0 machine with **at least 2 GB** o
 
 ::: moniker-end
 
-To install Red Hat Enterprise Linux on your own machine, go to [https://access.redhat.com/products/red-hat-enterprise-linux/evaluation](https://access.redhat.com/products/red-hat-enterprise-linux/evaluation). You can also create RHEL virtual machines in Azure. See [Create and Manage Linux VMs with the Azure CLI](https://docs.microsoft.com/azure/virtual-machines/linux/tutorial-manage-vm), and use `--image RHEL` in the call to `az vm create`.
+To install Red Hat Enterprise Linux on your own machine, go to [https://access.redhat.com/products/red-hat-enterprise-linux/evaluation](https://access.redhat.com/products/red-hat-enterprise-linux/evaluation). You can also create RHEL virtual machines in Azure. See [Create and Manage Linux VMs with the Azure CLI](/azure/virtual-machines/linux/tutorial-manage-vm), and use `--image RHEL` in the call to `az vm create`.
 
 If you have previously installed a CTP or RC release of SQL Server, you must first remove the old repository before following these steps. For more information, see [Configure Linux repositories for SQL Server 2017 and 2019](sql-server-linux-change-repo.md).
 
@@ -212,4 +212,4 @@ To create a database, you need to connect with a tool that can run Transact-SQL
    source ~/.bashrc
    ```
 
-[!INCLUDE [Connect, create, and query data](../includes/sql-linux-quickstart-connect-query.md)]
+[!INCLUDE [Connect, create, and query data](../includes/sql-linux-quickstart-connect-query.md)]

docs/linux/new-to-linux-learning-resources.yml

@@ -48,12 +48,12 @@ You must have a SLES v12 SP2, SP3, SP4 or SP5 machine with **at least 2 GB** of
 
 ::: moniker-end
 
-To install SUSE Linux Enterprise Server on your own machine, go to [https://www.suse.com/products/server](https://www.suse.com/products/server). You can also create SLES virtual machines in Azure. See [Create and Manage Linux VMs with the Azure CLI](https://docs.microsoft.com/azure/virtual-machines/linux/tutorial-manage-vm), and use `--image SLES` in the call to `az vm create`.
+To install SUSE Linux Enterprise Server on your own machine, go to [https://www.suse.com/products/server](https://www.suse.com/products/server). You can also create SLES virtual machines in Azure. See [Create and Manage Linux VMs with the Azure CLI](/azure/virtual-machines/linux/tutorial-manage-vm), and use `--image SLES` in the call to `az vm create`.
 
 If you have previously installed a CTP or RC release of SQL Server, you must first remove the old repository before following these steps. For more information, see [Configure Linux repositories for SQL Server 2017 and 2019](sql-server-linux-change-repo.md).
 
 > [!NOTE]
-> At this time, the [Windows Subsystem for Linux](https://msdn.microsoft.com/commandline/wsl/about) for Windows 10 is not supported as an installation target.
+> At this time, the [Windows Subsystem for Linux](/windows/wsl/about) for Windows 10 is not supported as an installation target.
 
 For other system requirements, see [System requirements for SQL Server on Linux](sql-server-linux-setup.md#system).
 
@@ -204,4 +204,4 @@ To create a database, you need to connect with a tool that can run Transact-SQL
    source ~/.bashrc
    ```
 
-[!INCLUDE [Connect, create, and query data](../includes/sql-linux-quickstart-connect-query.md)]
+[!INCLUDE [Connect, create, and query data](../includes/sql-linux-quickstart-connect-query.md)]