Merge branch 'release-synapse-current' of https://github.com/MicrosoftDocs/azure-docs-pr into 20200513_fixtypos

Author: julieMSFT

articles/synapse-analytics/get-started.md

@@ -403,7 +403,7 @@ ORDER BY
 ```
 
 If you are a user of T-SQL, this syntax will be identical to what you are used to using. This query selects three aggregations from the **Trip** Parquet file and groups them by DateId and PickupGeographyId. After running the query, you should see and output like this;
-![Simple aggregation query](./media/get-started-synapse-analytics/sql-simple-agg-output.PNG)
+![Simple aggregation query](./media/get-started-synapse-analytics/sql-simple-agg-output.png)
 
 You can make the results easier to read, by replacing DateId and PickupGeographyId with the actual date and pickup city. This values can be obtained by joining to the **Date** and **Geography** files. 
 
@@ -440,13 +440,13 @@ ORDER BY
 
 ```
 After running this query, your output should look like this;
-![Aggregation query with joins](./media/get-started-synapse-analytics/sql-joins-agg-output.PNG)
+![Aggregation query with joins](./media/get-started-synapse-analytics/sql-joins-agg-output.png)
 
 As you can see, multiple Parquet files can be joined almost as if they were actual SQL views. If you find the **OPENROWSET** syntax a little harder to user to use than regular SQL views, you can solve this by creating a virtual SQL database with SQL views.
 ## Create a virtual SQL database.
 
 On the **Develop** hub click the **+** to add a new SQL **script**.
-![Create new SQL script](./media/get-started-synapse-analytics/sql-new-script.PNG)
+![Create new SQL script](./media/get-started-synapse-analytics/sql-new-script.png)
 
 To create the database run the following script;
 
@@ -455,13 +455,13 @@ CREATE DATABASE NYCTaxiVirtual;
 ```
 
 Now, if you flip to the data hub, you will see the newly created database.
-![See created database](./media/get-started-synapse-analytics/sql-data-see-db.PNG)
+![See created database](./media/get-started-synapse-analytics/sql-data-see-db.png)
 
 ## Create SQL views
 
 Create a new SQL script which uses the NYCTaxiVirtual database by right clicking on the database name and selecting **New SQL script**. 
 
-![Create new SQL script from database](./media/get-started-synapse-analytics/sql-new-script-from-db.PNG)
+![Create new SQL script from database](./media/get-started-synapse-analytics/sql-new-script-from-db.png)
 
 Run SQL statements like the following for each view that you wish to create.
 
@@ -499,7 +499,7 @@ FROM
 ```
 
 After the views are created, you can expand the NYCTaxiVirtual database in the data hub to see the views and their schema.
-![View database schema](./media/get-started-synapse-analytics/sql-expand-db.PNG)
+![View database schema](./media/get-started-synapse-analytics/sql-expand-db.png)
 
 ## Query the SQL views
 
@@ -529,53 +529,53 @@ ORDER BY
 ```
 
 Ensure that when you run the query, that you are running it using the NYCTaxiVirtual database.
-![Run updated query in correct database](./media/get-started-synapse-analytics/sql-run-query-in-db.PNG)
+![Run updated query in correct database](./media/get-started-synapse-analytics/sql-run-query-in-db.png)
 
 ### Visualize with Power BI
  Your data can now be easily analyzed and visualized in Power BI. Synapse offers a unique integration which allows you to link a Power BI workspace to you Synapse workspace. Before going forward, follow the steps in this [quickstart](quickstart-power-bi.md) to link your Power BI workspace.
 On the **Develop** hub, expand your linked workspace under **Power BI** and click on **Power BI Datasets**.
 
-![View Power BI datasets](./media/get-started-synapse-analytics/pbi-view-datasets.PNG)
+![View Power BI datasets](./media/get-started-synapse-analytics/pbi-view-datasets.png)
 
 Any existing datasets from you linked Power BI workspace will be displayed here. You can create new reports in Synapse Studio using these Power BI datasets. Let’s create a new Power BI dataset for the virtual database which we created in the last section. Click **+ New Power BI dataset**. 
 
-![New Power BI datasets](./media/get-started-synapse-analytics/pbi-new-dataset.PNG)
+![New Power BI datasets](./media/get-started-synapse-analytics/pbi-new-dataset.png)
 
 While Power BI reports can be created in Synapse Studio, Power BI datasets must be created in the Power BI Desktop. Install the Power BI Desktop if you have not already and then click **Start** once the installation is complete.
 
-![Download Power BI Desktop](./media/get-started-synapse-analytics/pbi-download-desktop.PNG)
+![Download Power BI Desktop](./media/get-started-synapse-analytics/pbi-download-desktop.png)
 
 Select **NYCTaxiVirtual** and click continue.
 
-![Select database to use](./media/get-started-synapse-analytics/pbi-select-database.PNG)
+![Select database to use](./media/get-started-synapse-analytics/pbi-select-database.png)
 
 Click **Download** to download the Power BI dataset file (pbids). Open the file when the download is complete to launch the Power BI Desktop. Once the Power BI Desktop has been launched, sign into Synapse by using your Azure Active Directory user account. Then click **Connect**.
 
-![Sign into Synapse](./media/get-started-synapse-analytics/pbi-sign-in.PNG)
+![Sign into Synapse](./media/get-started-synapse-analytics/pbi-sign-in.png)
 
 Select all the views to include in your Power BI dataset and click **Load**.
 
-![Select all views in the navigator](./media/get-started-synapse-analytics/pbi-navigator.PNG)
+![Select all views in the navigator](./media/get-started-synapse-analytics/pbi-navigator.png)
 
 Select **DirectQuery** and click **OK**.
 
-![Select DirectQuery](./media/get-started-synapse-analytics/pbi-directquery.PNG)
+![Select DirectQuery](./media/get-started-synapse-analytics/pbi-directquery.png)
 
 Click on the **Model** view and create relationships between the three tables by dragging **DateID** from **Trips** and dropping it on **DateID** in **dimDate**. 
 
-![Create relationships](./media/get-started-synapse-analytics/pbi-create-relationship.PNG)
+![Create relationships](./media/get-started-synapse-analytics/pbi-create-relationship.png)
 
 Click **Assume referential integrity** and click **OK**.
 
-![Setup relationship](./media/get-started-synapse-analytics/pbi-ref-integrity.PNG)
+![Setup relationship](./media/get-started-synapse-analytics/pbi-ref-integrity.png)
 
 Create another relationship by dragging **PickupGepgraphyID** from **Trips** and dropping it on **GeographyID** on **dimGeography**. Select **Assume referential integrity** like in the last step. Your model diagram should now look something like below.
 
-![Relationship diagram](./media/get-started-synapse-analytics/pbi-diagram.PNG)
+![Relationship diagram](./media/get-started-synapse-analytics/pbi-diagram.png)
 
 Go back to the **Report** view and right-click on the **Trips** table and click on **New Measure**.
 
-![New measure](./media/get-started-synapse-analytics/pbi-new-measure.PNG)
+![New measure](./media/get-started-synapse-analytics/pbi-new-measure.png)
 
 Enter the following DAX formula into the formula bar and press enter.
 ```dax
@@ -585,35 +585,31 @@ Average fair per trip = DIVIDE(
                             )
 ```
 
-![Formula bar](./media/get-started-synapse-analytics/pbi-formula.PNG)
+![Formula bar](./media/get-started-synapse-analytics/pbi-formula.png)
 
 Save the Power BI File and publish it to the Power BI workspace that you linked to Synapse.
 
-![Publish to workspace](./media/get-started-synapse-analytics/pbi-publish.PNG)
+![Publish to workspace](./media/get-started-synapse-analytics/pbi-publish.png)
 
 After publishing, go to the **Settings** page for your Power BI dataset inside of your Power BI workspace.
 
-![Dataset settings](./media/get-started-synapse-analytics/pbi-find-dataset-settings.PNG)
+![Dataset settings](./media/get-started-synapse-analytics/pbi-find-dataset-settings.png)
 
 Under **Data source credentials** hit **Edit credentials**.
 
-![Edit credentials](./media/get-started-synapse-analytics/pbi-edit-credentials.PNG)
+![Edit credentials](./media/get-started-synapse-analytics/pbi-edit-credentials.png)
 
 Change the **Authentication method** to **OAuth2** and click **Sign in**. Sign in with your Azure Active Directory Account.
 
-![Sign into Synapse](./media/get-started-synapse-analytics/pbi-web-sign-in.PNG)
+![Sign into Synapse](./media/get-started-synapse-analytics/pbi-web-sign-in.png)
 
 After publishing, switch back to Synapse Studio and click **Close and refresh**.
 
-![Close and refresh](./media/get-started-synapse-analytics/pbi-close-refresh.PNG)
+![Close and refresh](./media/get-started-synapse-analytics/pbi-close-refresh.png)
 
 Click **New Power BI report** next to the name of the Power BI dataset that you just published. Now you can build out your Power BI report direction in Synapse Studio. Don’t forget to save the report when you are finished creating it.
 
-![Save report](./media/get-started-synapse-analytics/pbi-save-report.PNG)
-
-<!--## Serve via SQL pool--->
-<!--- Matthew
---->
+![Save report](./media/get-started-synapse-analytics/pbi-save-report.png)
 
 
 ## Orchestrate using a pipeline

articles/synapse-analytics/overview-faq.md

@@ -30,8 +30,7 @@ A: Azure Synapse is an integrated data platform for BI, AI, and continuous intel
 
 ### Q: How do I get started with Azure Synapse Analytics
 
-A: To start using Azure Synapse Analytics, create a [Synapse workspace](https://portal.azure.com) (it's free!) and create the resources that you want under that workspace. You can follow one of our quickstart tutorials, such as [Create a Synapse SQL pool](quickstart-create-sql-pool-portal.md) or [Create a workspace](quickstart-create-workspace.md), that will walk you through simple use case. 
-
+A: To start using Azure Synapse Analytics, [register Azure Synapse resource provider](https://docs.microsoft.com/azure/azure-resource-manager/management/resource-providers-and-types) by selecting *Microsoft.Synapse* from the list of resource providers. Then create a [Synapse workspace](https://portal.azure.com) (it's free!) and create the resources that you want under that workspace. You can follow one of our quickstart tutorials, such as [Create a Synapse SQL pool](quickstart-create-sql-pool.md) or [Create a workspace](quickstart-create-workspace.md), that will walk you through simple use case. 
 You can also find sample notebooks and SQL scripts in our [repository](https://github.com/Azure/azure-synapse-analytics/tree/master/samples). If you need to connect to a public dataset, create a new linked service with the following attributes:
 
 - azure_storage_account_name = "azureopendatastorage"

articles/synapse-analytics/quickstart-create-workspace.md

@@ -21,6 +21,9 @@ If you don't have an Azure subscription, [create a free account before you begin
 
 - [Azure Data Lake Storage Gen2 storage account](../storage/common/storage-account-create.md?toc=/azure/synapse-analytics/toc.json&bc=/azure/synapse-analytics/breadcrumb/toc.json)
 
+## Register Azure Synapse resource provider
+If you have not already done so, register Azure Synapse resource provider. Registering a resource provider configures your subscription to work with the resource provider. For registering Azure Synapse resource provider, see [Azure resource providers and types](https://docs.microsoft.com/azure/azure-resource-manager/management/resource-providers-and-types). Choose *Microsoft.Synapse* from the list of resource providers when you register.
+
 ## Sign in to the Azure portal
 
 Sign in to the [Azure portal](https://portal.azure.com/)

articles/synapse-analytics/security/how-to-connect-to-workspace-with-private-links.md

@@ -13,19 +13,24 @@ ms.reviewer: jrasnick
 
 This article will teach you how to create private endpoint to your Azure Synapse workspace. See [private links and private endpoints](https://docs.microsoft.com/azure/private-link/) to learn more.
 
-## Step 1: Open your Azure Synapse workspace in Azure portal
+## Step 1: Register Network resource provider
+
+If you have not already done so, register the Network resource provider. Registering a resource provider configures your subscription to work with the resource provider. Choose *Microsoft.Network* from the list of resource providers when you [register](https://docs.microsoft.com/azure/azure-resource-manager/management/resource-providers-and-types). If the Network resource provider is already registered, then proceed to Step 2.
+
+
+## Step 2: Open your Azure Synapse workspace in Azure portal
 
 Select **Private endpoint connection** under **Security** and then select **+ Private endpoint**.
 ![Open Azure Synapse workspace in Azure portal](./media/how-to-connect-to-workspace-with-private-links/private-endpoint-1.png)
 
-## Step 2: Select your subscription and region details
+## Step 3: Select your subscription and region details
 
 Under the **Basics** tab in the **Create a private endpoint** window, choose your **Subscription** and **Resource Group**. Give a **Name** to the private endpoint that you want to create. Select the **Region** where you want the private endpoint created.
 
 Private endpoints are created in a subnet. The subscription, resource group, and region selected filter the private endpoint subnets. Select **Next: Resource >** when done.
 ![Select subscription and region details](./media/how-to-connect-to-workspace-with-private-links/private-endpoint-2.png)
 
-## Step 3: Select your Azure Synapse workspace details
+## Step 4: Select your Azure Synapse workspace details
 
 Select **Connect to an Azure resource in my directory** in the **Resource** tab. Select the **Subscription** that contains your Azure Synapse workspace. The **Resource type** for creating private endpoints to an Azure Synapse workspace is *Microsoft.Synapse/workspaces*.
 

articles/synapse-analytics/security/synapse-workspace-managed-private-endpoints.md

@@ -27,8 +27,9 @@ Private endpoint uses a private IP address from your VNet to effectively bring t
 
 >[!IMPORTANT]
 >Managed private endpoints are only supported in Azure Synapse workspaces with a Managed workspace VNet.
+
 >[!NOTE]
->It's recommended that you create Managed private endpoints to connect to all your Azure data sources. All outbound traffic from the >Managed workspace VNet will be blocked in the future.
+>All outbound traffic from the Managed workspace VNet except through Managed private endpoints will be blocked in the future. It's recommended that you create Managed private endpoints to connect to all your Azure data sources external to the workspace. 
 
 A private endpoint connection is created in a "Pending" state when you create a Managed private endpoint in Azure Synapse. An approval workflow is initiated. The private link resource owner is responsible to approve or reject the connection.
 

articles/synapse-analytics/security/synapse-workspace-managed-vnet.md

@@ -37,6 +37,8 @@ SQL pool and SQL on-demand are multi-tenant capabilities and therefore reside ou
 
 ## Create an Azure Synapse workspace with a Managed workspace VNet
 
+If you have not already done so, register the Network resource provider. Registering a resource provider configures your subscription to work with the resource provider. Choose *Microsoft.Network* from the list of resource providers when you [register](https://docs.microsoft.com/azure/azure-resource-manager/management/resource-providers-and-types).
+
 To create an Azure Synapse workspace that has a Managed workspace VNet associated with it, select the **Security + networking** tab in Azure portal and check the **Enable managed virtual network** checkbox.
 
 If you leave the checkbox unchecked, then your workspace won't have a VNet associated with it.
@@ -47,7 +49,7 @@ If you leave the checkbox unchecked, then your workspace won't have a VNet assoc
 ![Enable Managed workspace VNet](./media/synapse-workspace-managed-vnet/enable-managed-vnet-1.png)
 
 >[!NOTE]
->All outbound traffic from the Managed workspace VNet will be blocked in the future. It's recommended that you connect to all your data sources using Managed private endpoints.
+>All outbound traffic from the Managed workspace VNet except through Managed private endpoints will be blocked in the future. It's recommended that you create Managed private endpoints to connect to all your Azure data sources external to the workspace. 
 
 You can check whether your Azure Synapse workspace is associated to a Managed workspace VNet by selecting **Overview** from Azure portal.