Merge branch 'master' of https://github.com/MicrosoftDocs/azure-docs-pr into rolyon-aadroles-custom-roles-assign-powershell-fix

rolyon · rolyon · commit 9b6b6194aefe · 2021-10-06T12:49:21.000-07:00
diff --git a/articles/app-service/configure-authentication-provider-aad.md b/articles/app-service/configure-authentication-provider-aad.md
@@ -21,7 +21,7 @@ The App Service Authentication feature can automatically create an app registrat
 > [!NOTE]
 > The option to create a new registration is not available for government clouds. Instead, [define a registration separately](#advanced).
 
-## <a name="express"> </a>Create a new app registration automatically
+## <a name="express"> </a> Option 1: Create a new app registration automatically
 
 This option is designed to make enabling authentication simple and requires just a few clicks.
 
@@ -42,7 +42,7 @@ You're now ready to use the Microsoft Identity Platform for authentication in yo
 
 For an example of configuring Azure AD login for a web app that accesses Azure Storage and Microsoft Graph, see [this tutorial](scenario-secure-app-authentication-app-service.md).
 
-## <a name="advanced"> </a>Use an existing registration created separately
+## <a name="advanced"> </a>Option 2: Use an existing registration created separately
 
 You can also manually register your application for the Microsoft Identity Platform, customizing the registration and configuring App Service Authentication with the registration details. This is useful, for example, if you want to use an app registration from a different Azure AD tenant than the one your application is in.
 
diff --git a/articles/azure-sql/database/recovery-using-backups.md b/articles/azure-sql/database/recovery-using-backups.md
@@ -64,6 +64,9 @@ When complete, the restore creates a new database on the same server as the orig
 
 You generally restore a database to an earlier point for recovery purposes. You can treat the restored database as a replacement for the original database or use it as a data source to update the original database.
 
+> [!IMPORTANT]
+> You can only run restore on the same server, cross-server restoration is not supported by Point-in-time restore.
+
 - **Database replacement**
 
   If you intend the restored database to be a replacement for the original database, you should specify the original database's compute size and service tier. You can then rename the original database and give the restored database the original name by using the [ALTER DATABASE](/sql/t-sql/statements/alter-database-azure-sql-database) command in T-SQL.
diff --git a/articles/storage/blobs/data-lake-storage-best-practices.md b/articles/storage/blobs/data-lake-storage-best-practices.md
@@ -5,7 +5,7 @@ author: normesta
 ms.subservice: data-lake-storage-gen2
 ms.service: storage
 ms.topic: conceptual
-ms.date: 09/28/2021
+ms.date: 10/06/2021
 ms.author: normesta
 ms.reviewer: sachins
 ---
@@ -146,92 +146,32 @@ Start by reviewing the recommendations in the [Security recommendations for Blob
 
 Then, review the [Access control model in Azure Data Lake Storage Gen2](data-lake-storage-access-control-model.md) article for guidance that is specific to Data Lake Storage Gen2 enabled accounts. This article helps you understand how to use Azure role-based access control (Azure RBAC) roles together with access control lists (ACLs) to enforce security permissions on directories and files in your hierarchical file system. 
 
-## Ingest data
+## Ingest, process, and analyze
 
-This section highlights the different sources of data and the different ways in which that data can be ingested into a Data Lake Storage Gen2 account.
+There are many different sources of data and different ways in which that data can be ingested into a Data Lake Storage Gen2 enabled account. 
 
-#### Ad hoc data
+For example, you can ingest large sets of data from HDInsight and Hadoop clusters or smaller sets of *ad hoc* data for prototyping applications. You can ingest streamed data that is generated by various sources such as applications, devices, and sensors. For this type of data, you can use tools to capture and process the data on an event-by-event basis in real time, and then write the events in batches into your account. You can also ingest web server which contain information such as the history of page requests. For log data, consider writing custom scripts or applications to upload them so that you'll have the flexibility to include your data uploading component as part of your larger big data application. 
 
-Smaller data sets that are used for prototyping a big data application. Consider using any of these tools to ingest data: 
+Once the data is available in your account, you can run analysis on that data, create visualizations, and even download data to your local machine or to other repositories such as an Azure SQL database or SQL Server instance. 
 
-- Azure portal
-- [Azure PowerShell](data-lake-storage-directory-file-acl-powershell.md)
-- [Azure CLI](data-lake-storage-directory-file-acl-cli.md)
-- [REST](/rest/api/storageservices/data-lake-storage-gen2)
-- [Azure Storage Explorer](https://azure.microsoft.com/features/storage-explorer/)
-- [Apache DistCp](data-lake-storage-use-distcp.md)
-- [AzCopy](../common/storage-use-azcopy-v10.md)
+The following table recommends tools that you can use to ingest, analyze, visualize, and download data. Use the links in this table to find guidance about how to configure and use each tool. 
 
-#### Streamed data
+| Purpose | Tools & Tool guidance |
+|---|---|
+| Ingest ad hoc data| Azure portal, [Azure PowerShell](data-lake-storage-directory-file-acl-powershell.md), [Azure CLI](data-lake-storage-directory-file-acl-cli.md), [REST](/rest/api/storageservices/data-lake-storage-gen2), [Azure Storage Explorer](https://azure.microsoft.com/features/storage-explorer/), [Apache DistCp](data-lake-storage-use-distcp.md), [AzCopy](../common/storage-use-azcopy-v10.md)|
+| Ingest streaming data | [HDInsight Storm](../../hdinsight/storm/apache-storm-write-data-lake-store.md), [Azure Stream Analytics](../../stream-analytics/stream-analytics-quick-create-portal.md) |
+| Ingest relational data | [Azure Data Factory](../../data-factory/connector-azure-data-lake-store.md) |
+| Ingest web server logs | [Azure PowerShell](data-lake-storage-directory-file-acl-powershell.md), [Azure CLI](data-lake-storage-directory-file-acl-cli.md), [REST](/rest/api/storageservices/data-lake-storage-gen2), Azure SDKs ([.NET](data-lake-storage-directory-file-acl-dotnet.md), [Java](data-lake-storage-directory-file-acl-java.md), [Python](data-lake-storage-directory-file-acl-python.md), and [Node.js](data-lake-storage-directory-file-acl-javascript.md)), [Azure Data Factory](../../data-factory/connector-azure-data-lake-store.md) |
+| Ingest from HDInsight clusters | [Azure Data Factory](../../data-factory/connector-azure-data-lake-store.md), [Apache DistCp](data-lake-storage-use-distcp.md), [AzCopy](../common/storage-use-azcopy-v10.md) |
+| Ingest from Hadoop clusters | [Azure Data Factory](../../data-factory/connector-azure-data-lake-store.md), [Apache DistCp](data-lake-storage-use-distcp.md), [WANdisco LiveData Migrator for Azure](migrate-gen2-wandisco-live-data-platform.md), [Azure Data Box](data-lake-storage-migrate-on-premises-hdfs-cluster.md) |
+| Ingest large data sets (several terabytes) | [Azure ExpressRoute](../../expressroute/expressroute-introduction.md) |
+| Process & analyze data | [Azure Synapse Analytics](../../synapse-analytics/get-started-analyze-storage.md), [Azure HDInsight](../../hdinsight/hdinsight-hadoop-use-data-lake-storage-gen2.md), [Databricks](/azure/databricks/scenarios/databricks-extract-load-sql-data-warehouse) |
+| Visualize data | [Power BI](/power-query/connectors/datalakestorage), [Azure Data Lake Storage query acceleration](data-lake-storage-query-acceleration.md) |
+| Download data | Azure portal, [PowerShell](data-lake-storage-directory-file-acl-powershell.md), [Azure CLI](data-lake-storage-directory-file-acl-cli.md), [REST](/rest/api/storageservices/data-lake-storage-gen2), Azure SDKs ([.NET](data-lake-storage-directory-file-acl-dotnet.md), [Java](data-lake-storage-directory-file-acl-java.md), [Python](data-lake-storage-directory-file-acl-python.md), and [Node.js](data-lake-storage-directory-file-acl-javascript.md)), [Azure Storage Explorer](data-lake-storage-explorer.md), [AzCopy](../common/storage-use-azcopy-v10.md#transfer-data), [Azure Data Factory](../../data-factory/copy-activity-overview.md), [Apache DistCp](./data-lake-storage-use-distcp.md) |
 
-Generated by various sources such as applications, devices, and sensors. Tools used to ingest this type of data usually capture and process the data on an event-by-event basis in real time, and then write the events in batches into your account. Consider using any of these tools to ingest data:
-
-- [HDInsight Storm](../../hdinsight/storm/apache-storm-write-data-lake-store.md)
-- [Azure Stream Analytics](../../stream-analytics/stream-analytics-quick-create-portal.md)
-
-#### Relational data
-
-Relational databases collect a huge number of records, which can provide key insights if processed through a big data pipeline. We recommend that you use [Azure Data Factory](../../data-factory/connector-azure-data-lake-store.md) to ingest relational data.
-
-#### Web server log data
-
-Log files that contain information such as the history of page requests. Consider writing custom scripts or applications to upload this data so you'll have the flexibility to include your data uploading component as part of your larger big data application. Consider using these tools and SDKs:
-
-- [Azure PowerShell](data-lake-storage-directory-file-acl-powershell.md)
-- [Azure CLI](data-lake-storage-directory-file-acl-cli.md)
-- [REST](/rest/api/storageservices/data-lake-storage-gen2)
-- Azure SDKs ([.NET](data-lake-storage-directory-file-acl-dotnet.md), [Java](data-lake-storage-directory-file-acl-java.md), [Python](data-lake-storage-directory-file-acl-python.md), and [Node.js](data-lake-storage-directory-file-acl-javascript.md))
-- [Azure Data Factory](../../data-factory/connector-azure-data-lake-store.md)
-
-#### HDInsight clusters
-
-Most HDInsight cluster types (Hadoop, HBase, Storm) support Data Lake Storage Gen2 as a data storage repository. Consider using any of these tools to ingest data:
-
-- [Azure Data Factory](../../data-factory/connector-azure-data-lake-store.md)
-- [Apache DistCp](data-lake-storage-use-distcp.md)
-- [AzCopy](../common/storage-use-azcopy-v10.md)
-
-#### Hadoop clusters
-
-These clusters might running on-premise or in the cloud. Consider using any of these tools to ingest data:
-
-- [Azure Data Factory](../../data-factory/connector-azure-data-lake-store.md)
-- [Apache DistCp](data-lake-storage-use-distcp.md)
-- [WANdisco LiveData Migrator for Azure](migrate-gen2-wandisco-live-data-platform.md)
-- [Azure Data Box](data-lake-storage-migrate-on-premises-hdfs-cluster.md)
-
-#### Large data sets
-
-For uploading datasets that range in several terabytes, using the methods described above can sometimes be slow and costly. In such cases, you can use Azure ExpressRoute.  
-
-Azure ExpressRoute lets you create private connections between Azure data centers and infrastructure on your premises. This provides a reliable option for transferring large amounts of data. To learn more, see [Azure ExpressRoute documentation](../../expressroute/expressroute-introduction.md).
-
-## Process and analyze data
-
-Once the data is available in Data Lake Storage Gen2 you can run analysis on that data, create visualizations, and even download data to your local machine or to other repositories such as an Azure SQL database or SQL Server instance. The following sections recommend tools that you can use to analyze, visualize, and download data.
-
-#### Tools for Analyzing data
-
-- [Azure Synapse Analytics](../../synapse-analytics/get-started-analyze-storage.md)
-- [Azure HDInsight](../../hdinsight/hdinsight-hadoop-use-data-lake-storage-gen2.md)
-- [Databricks](/azure/databricks/scenarios/databricks-extract-load-sql-data-warehouse)
-
-#### Tools for visualizing data
-
-- [Power BI](/power-query/connectors/datalakestorage)
-- [Azure Data Lake Storage query acceleration](data-lake-storage-query-acceleration.md)
-
-#### Tools for downloading data
+> [!NOTE]
+> This table doesn't reflect the complete list of Azure services that support Data Lake Storage Gen2. To see a list of supported Azure services, their level of support, see [Azure services that support Azure Data Lake Storage Gen2](data-lake-storage-supported-azure-services.md). 
 
-- Azure portal
-- [PowerShell](data-lake-storage-directory-file-acl-powershell.md)
-- [Azure CLI](data-lake-storage-directory-file-acl-cli.md)
-- [REST](/rest/api/storageservices/data-lake-storage-gen2)
-- Azure SDKs ([.NET](data-lake-storage-directory-file-acl-dotnet.md), [Java](data-lake-storage-directory-file-acl-java.md), [Python](data-lake-storage-directory-file-acl-python.md), and [Node.js](data-lake-storage-directory-file-acl-javascript.md))
-- [Azure Storage Explorer](data-lake-storage-explorer.md)
-- [AzCopy](../common/storage-use-azcopy-v10.md#transfer-data)
-- [Azure Data Factory](../../data-factory/copy-activity-overview.md)
-- [Apache DistCp](./data-lake-storage-use-distcp.md)
 
 ## Monitor telemetry
 
diff --git a/articles/storage/blobs/data-lake-storage-integrate-with-services-tutorials.md b/articles/storage/blobs/data-lake-storage-integrate-with-services-tutorials.md
@@ -4,7 +4,7 @@ description: Find tutorials that help you learn how to use Azure services with A
 author: normesta
 ms.topic: conceptual
 ms.author: normesta
-ms.date: 02/17/2021
+ms.date: 10/06/2021
 ms.service: storage
 ms.subservice: data-lake-storage-gen2
 ---
@@ -32,8 +32,8 @@ This article contains links to tutorials that show you how to use various Azure
 | Azure Cognitive Search | [Index and search Azure Data Lake Storage Gen2 documents (preview)](../../search/search-howto-index-azure-data-lake-storage.md) |
 
 > [!NOTE]
-> This table doesn't reflect the complete list of Azure services that support Data Lake Storage Gen2. To see a list of supported Azure services, their level of support, see [Azure services that support Azure Data Lake Storage Gen2](data-lake-storage-supported-azure-services.md)
+> This table doesn't reflect the complete list of Azure services that support Data Lake Storage Gen2. To see a list of supported Azure services, their level of support, see [Azure services that support Azure Data Lake Storage Gen2](data-lake-storage-supported-azure-services.md). To see how services organized into categories such as ingest, download, process, and visualize, see [Ingest, process, and analyze](data-lake-storage-data-scenarios.md#ingest-process-and-analyze).
 
-## Next steps
+## See also
 
-- Learn how these services can be used together to build workloads that ingest, download, process, and visualize data. See [Using Azure Data Lake Storage Gen2 for big data requirements](data-lake-storage-data-scenarios.md).
+[Best practices for using Azure Data Lake Storage Gen2](data-lake-storage-best-practices.md)
diff --git a/articles/storage/blobs/data-lake-storage-introduction.md b/articles/storage/blobs/data-lake-storage-introduction.md
@@ -79,5 +79,6 @@ Several open source platforms support Data Lake Storage Gen2. For a complete lis
 
 ## See also
 
+- [Best practices for using Azure Data Lake Storage Gen2](data-lake-storage-best-practices.md)
 - [Known issues with Azure Data Lake Storage Gen2](data-lake-storage-known-issues.md)
 - [Multi-protocol access on Azure Data Lake Storage](data-lake-storage-multi-protocol-access.md)
diff --git a/articles/storage/blobs/data-lake-storage-supported-azure-services.md b/articles/storage/blobs/data-lake-storage-supported-azure-services.md
@@ -5,7 +5,7 @@ author: normesta
 ms.subservice: data-lake-storage-gen2
 ms.service: storage
 ms.topic: conceptual
-ms.date: 02/17/2021
+ms.date: 10/06/2021
 ms.author: normesta
 ms.reviewer: stewu
 ---
@@ -41,9 +41,13 @@ This table lists the Azure services that you can use with Azure Data Lake Storag
 |Azure Content Delivery Network|Not yet supported|Not applicable|Not applicable|[Index and search Azure Data Lake Storage Gen2 documents (preview)](../../cdn/cdn-overview.md)|
 |Azure SQL Database|Not yet supported|Not applicable|Not applicable|[What is Azure SQL Database?](../../azure-sql/database/sql-database-paas-overview.md)|
 
+> [!TIP]
+> To see how services organized into categories such as ingest, download, process, and visualize, see [Ingest, process, and analyze](data-lake-storage-data-scenarios.md#ingest-process-and-analyze).
+
 ## See also
 
 - [Known issues with Azure Data Lake Storage Gen2](data-lake-storage-known-issues.md)
 - [Blob Storage feature support in Azure Storage accounts](storage-feature-support-in-storage-accounts.md)
 - [Open source platforms that support Azure Data Lake Storage Gen2](data-lake-storage-supported-open-source-platforms.md)
-- [Multi-protocol access on Azure Data Lake Storage](data-lake-storage-multi-protocol-access.md)
+- [Multi-protocol access on Azure Data Lake Storage](data-lake-storage-multi-protocol-access.md)
+- [Best practices for using Azure Data Lake Storage Gen2](data-lake-storage-best-practices.md)
