Merge pull request #227721 from linda33wj/purview

Update resource set and PBI/Synapse connector docs

Author: prmerger-automator[bot]

articles/purview/catalog-managed-vnet.md

@@ -6,7 +6,7 @@ ms.author: zeinam
 ms.service: purview
 ms.subservice: purview-data-catalog
 ms.topic: how-to
-ms.date: 01/31/2023
+ms.date: 02/17/2023
 ms.custom: references_regions
 # Customer intent: As a Microsoft Purview admin, I want to set up Managed Virtual Network and managed private endpoints for my Microsoft Purview account.
 ---
@@ -51,12 +51,7 @@ Currently, the following data sources are supported to have a managed private en
 - Azure SQL Managed Instance
 - Azure Synapse Analytics
 
-Additionally, you can deploy managed private endpoints for your Azure Key Vault resources if you need to run scans using any authentication options rather than Managed Identities, such as SQL Authentication or Account Key.  
-
-> [!IMPORTANT]
-> If you are planning to scan Azure Synapse workspaces using Managed Virtual Network, you are also required to [configure Azure Synapse workspace firewall access](register-scan-synapse-workspace.md#set-up-azure-synapse-workspace-firewall-access) to enable **Allow Azure services and resources to access this workspace**. Currently, we do not support setting up scans for an Azure Synapse workspace from the Microsoft Purview governance portal, if you cannot enable **Allow Azure services and resources to access this workspace** on your Azure Synapse workspaces. If you cannot enable the firewall:
->  - You can use [Microsoft Purview REST API - Scans - Create Or Update](/rest/api/purview/scanningdataplane/scans/create-or-update/) to create a new scan for your Synapse workspaces including dedicated and serverless pools.
->  - You must use **SQL Authentication** as authentication mechanism.
+Additionally, you can deploy managed private endpoints for your Azure Key Vault resources if you need to run scans using any authentication options rather than Managed Identities, such as SQL Authentication or Account Key.
 
 ### Managed Virtual Network
 

articles/purview/concept-asset-normalization.md

@@ -6,7 +6,7 @@ ms.author: nayenama
 ms.service: purview
 ms.subservice: purview-data-catalog
 ms.topic: conceptual
-ms.date: 02/24/2022
+ms.date: 02/17/2023
 ms.custom: ignite-fall-2021
 ---
 
@@ -79,13 +79,6 @@ Before: `https://myAccount.file.core.windows.net//myshare/folderA////folderB/`
 
 After: 	`https://myaccount.file.core.windows.net/myshare/folderA/folderB/`
 
-### Lowercase ADF sections
-Applies to: Azure Data Factory
-
-Before: `/subscriptions/01234567-abcd-9876-0000-ba9876543210/resourceGroups/fooBar/providers/Microsoft.DataFactory/factories/fooFactory/pipelines/barPipeline/activities/barFoo`
-
-After: 	`/subscriptions/01234567-abcd-9876-0000-ba9876543210/resourceGroups/foobar/providers/microsoft.datafactory/factories/foofactory/pipelines/barpipeline/activities/barfoo`
-
 ### Convert to ADL scheme
 Applies to: Azure Data Lake Storage Gen1
 

articles/purview/concept-resource-sets.md

@@ -6,7 +6,7 @@ ms.author: nayenama
 ms.service: purview
 ms.subservice: purview-data-catalog
 ms.topic: conceptual
-ms.date: 01/23/2023
+ms.date: 02/17/2023
 ---
 
 # Understanding resource sets
@@ -15,7 +15,7 @@ This article helps you understand how Microsoft Purview uses resource sets to ma
 
 ## Background info
 
-At-scale data processing systems typically store a single table in storage as multiple files. In the Microsoft Purview data catalog, this concept is represented by using resource sets. A resource set is a single object in the catalog that represents a large number of assets in storage.
+At-scale data processing systems typically store a single table in storage as multiple files. In the Microsoft Purview Data Catalog, this concept is represented by using resource sets. A resource set is a single object in the catalog that represents a large number of assets in storage.
 
 For example, suppose your Spark cluster has persisted a DataFrame into an Azure Data Lake Storage (ADLS) Gen2 data source. Although in Spark the table looks like a single logical resource, on the disk there are likely thousands of Parquet files, each of which represents a partition of the total DataFrame's contents. IoT data and web log data have the same challenge. Imagine you have a sensor that outputs log files several times a second. It won't take long until you have hundreds of thousands of log files from that single sensor.
 
@@ -45,9 +45,9 @@ When Microsoft Purview detects resources that it thinks are part of a resource s
 
 ## Advanced resource sets
 
-Microsoft Purview can customize and further enrich your resource set assets through the **Advanced Resource Sets** capability. Advanced resource sets allows Microsoft Purview to understand the underlying partitions of data ingested and enables the creation of [resource set pattern rules](how-to-resource-set-pattern-rules.md) that customize how Microsoft Purview groups resource sets during scanning. 
+Microsoft Purview can customize and further enrich your resource set assets through the **Advanced Resource Sets** capability. Advanced resource sets allow Microsoft Purview to understand the underlying partitions of data ingested and enables the creation of [resource set pattern rules](how-to-resource-set-pattern-rules.md) that customize how Microsoft Purview groups resource sets during scanning. 
 
-When Advanced Resource Sets are enabled, Microsoft Purview run extra aggregations to compute the following information about resource set assets:
+When Advanced Resource Sets are enabled, Microsoft Purview runs extra aggregations to compute the following information about resource set assets:
 
 - A sample path from a file that comprises the resource set.
 - A partition count that shows how many files make up the resource set. 
@@ -59,14 +59,14 @@ These properties can be found on the asset details page of the resource set.
 
 ### Turning on advanced resource sets
 
-Advanced resource sets is off by default in all new Microsoft Purview instances. Advanced resource sets can be enabled from **Account information** in the management hub. Only those users who are added to the Data Curator role at root collection, can manage Advanced Resource Sets settings.
+Advanced resource sets are off by default in all new Microsoft Purview instances. Advanced resource sets can be enabled from **Account information** in the management hub. Only those users who are added to the Data Curator role at root collection, can manage Advanced Resource Sets settings.
 
 :::image type="content" source="media/concept-resource-sets/advanced-resource-set-toggle.png" alt-text="Turn on Advanced resource set." border="true":::
 
 After enabling advanced resource sets, the additional enrichments will occur on all newly ingested assets. The Microsoft Purview team recommends waiting an hour before scanning in new data lake data after toggling on the feature.
 
 > [!IMPORTANT]
-> Enabling advanced resource sets will impact the refresh rate of asset and classification insights. When advanced resource sets is on, asset and classification insights will only update twice a day.
+> Enabling advanced resource sets will impact the refresh rate of asset and classification insights. When advanced resource sets are on, asset and classification insights will only update twice a day.
 
 ## Built-in resource set patterns
 
@@ -89,7 +89,7 @@ Microsoft Purview supports the following resource set patterns. These patterns c
 | Date(yyyy/mm/dd)InPath  | {Year}/{Month}/{Day} | Year/month/day pattern spanning multiple folders |
 
 
-## How resource sets are displayed in the Microsoft Purview data catalog
+## How resource sets are displayed in the Microsoft Purview Data Catalog
 
 When Microsoft Purview matches a group of assets into a resource set, it attempts to extract the most useful information to use as a display name in the catalog. Some examples of the default naming convention applied: 
 
@@ -119,12 +119,11 @@ When scanning a storage account, Microsoft Purview uses a set of defined pattern
 - Putting an asset into the wrong resource set
 - Incorrectly marking an asset as not being a resource set
 
-To customize or override how Microsoft Purview detects which assets are grouped as resource sets and how they are displayed within the catalog, you can define pattern rules in the management center. For step-by-step instructions and syntax, please see [resource set pattern rules](how-to-resource-set-pattern-rules.md).
+To customize or override how Microsoft Purview detects which assets are grouped as resource sets and how they're displayed within the catalog, you can define pattern rules in the management center. For step-by-step instructions and syntax, see [resource set pattern rules](how-to-resource-set-pattern-rules.md).
 
 ## Known limitations with resource sets
 
 - By default, resource set assets will only be deleted by a scan if [Advanced Resource sets](#advanced-resource-sets) are enabled. If this capability is off, resource set assets can only be deleted manually or via API.
-- Currently, resource set assets will apply the first schema and classification discovered by the scan. Subsequent scans won't update the schema. 
 
 ## Next steps
 

articles/purview/register-scan-power-bi-tenant-cross-tenant.md

@@ -160,7 +160,7 @@ Use either of the following deployment checklists during the setup, or for troub
       - `*.analysis.windows.net` 
 
    1. Network connectivity from the self-hosted runtime to Microsoft services is enabled.
-   1. [JDK 8 or later](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html) is installed.
+   1. [JDK 8 or later](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html) is installed. Restart the machine after you newly install the JDK for it to take effect.
 1. In Power BI tenant, In Azure Active Directory create a security group.
 1. In Power BI tenant, from Azure Active Directory tenant, make sure [Service Principal is member of the new security group](#authenticate-to-power-bi-tenant).
 1. On the Power BI Tenant Admin portal, validate if [Allow service principals to use read-only Power BI admin APIs](#associate-the-security-group-with-power-bi-tenant) is enabled for the new security group. 

articles/purview/register-scan-power-bi-tenant.md

@@ -138,7 +138,7 @@ Use any of the following deployment checklists during the setup or for troublesh
       - `*.analysis.windows.net` 
 
    3. Network connectivity from Self-hosted runtime to Microsoft services is enabled.
-   4. [JDK 8 or later](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html) is installed.
+   4. [JDK 8 or later](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html) is installed. Restart the machine after you newly install the JDK for it to take effect.
 
 1. In Azure Active Directory tenant, create a security group.
 
@@ -171,7 +171,7 @@ Use any of the following deployment checklists during the setup or for troublesh
 
 1. Validate Self-hosted runtime settings:
    1. Latest version of [Self-hosted runtime](https://www.microsoft.com/download/details.aspx?id=39717) is installed on the VM.
-   2. [JDK 8 or later](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html) is installed.
+   2. [JDK 8 or later](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html) is installed. Restart the machine after you newly install the JDK for it to take effect.
 
 1. Validate App registration settings to make sure:
    1. App registration exists in your Azure Active Directory tenant.