Merge pull request #36917 from MicrosoftDocs/main

Auto Publish – main to live - 2026-03-19 22:30 UTC

Author: learn-build-service-prod[bot]

.openpublishing.redirection.json

@@ -50337,7 +50337,7 @@
     },
     {
       "source_path": "docs/relational-databases/polybase/get-started-with-polybase.md",
-      "redirect_url": "/sql/relational-databases/polybase/polybase-guide",
+      "redirect_url": "/sql/relational-databases/polybase/overview",
       "redirect_document_id": false
     },
     {
@@ -66372,7 +66372,7 @@
     },
     {
       "source_path": "docs/relational-databases/polybase/index.md",
-      "redirect_url": "/sql/relational-databases/polybase/polybase-guide",
+      "redirect_url": "/sql/relational-databases/polybase/overview",
       "redirect_document_id": false
     },
     {
@@ -68233,6 +68233,16 @@
       "source_path": "docs/azdata/reference/reference-azdata.md",
       "redirect_url": "/previous-versions/sql/big-data-cluster/reference-azdata",
       "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/relational-databases/polybase/polybase-guide.md",
+      "redirect_url": "/sql/relational-databases/polybase/overview",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/relational-databases/polybase/data-virtualization-comprehensive-guide.md",
+      "redirect_url": "/sql/relational-databases/polybase/data-virtualization-guide",
+      "redirect_document_id": false
     }
   ]
 }

azure-sql/database/authentication-aad-service-principal-tutorial.md

@@ -4,7 +4,7 @@ description: This tutorial walks you through creating Microsoft Entra users with
 author: VanMSFT
 ms.author: vanto
 ms.reviewer: wiassaf, mathoma
-ms.date: 09/18/2025
+ms.date: 03/18/2026
 ms.service: azure-sql-database
 ms.subservice: security
 ms.topic: tutorial
@@ -19,11 +19,11 @@ ms.custom:
 
 [!INCLUDE [appliesto-sqldb](../includes/appliesto-sqldb.md)]
 
-This article explains how to configure a service principal so it can create Microsoft Entra users in Azure SQL Database. This capability enables programmatic configuration of access management to Azure SQL resources for users and applications in your Microsoft Entra tenant.
+This article explains how to configure a service principal so it can create Microsoft Entra users in Azure SQL Database. This capability lets you programmatically manage access to Azure SQL resources for users and applications in your Microsoft Entra tenant.
 
 [!INCLUDE [entra-id](../includes/entra-id.md)]
 
-For more information on Microsoft Entra authentication for Azure SQL, see the article [Use Microsoft Entra authentication](authentication-aad-overview.md).
+For more information on Microsoft Entra authentication for Azure SQL, see [Use Microsoft Entra authentication](authentication-aad-overview.md).
 
 In this tutorial, you learn how to:
 
@@ -36,7 +36,7 @@ In this tutorial, you learn how to:
 
 ## Prerequisites
 
-- An existing [Azure SQL Database](single-database-create-quickstart.md) deployment. We assume you have a working SQL Database for this tutorial.
+- An existing [Azure SQL Database](single-database-create-quickstart.md) deployment. This tutorial assumes you have a working SQL Database.
 - Microsoft Entra `Privileged Role Administrator` permissions in the tenant where your SQL database resides.
 - The latest version of the [Az.Sql](https://www.powershellgallery.com/packages/Az.Sql/) PowerShell module.
 - The latest version of the [Microsoft.Graph](https://www.powershellgallery.com/packages/Microsoft.Graph) PowerShell module.
@@ -70,7 +70,7 @@ In this tutorial, you learn how to:
    $xyz.identity
    ```
 
-   Your output should show you `PrincipalId`, `Type`, and `TenantId`. The identity assigned is the `PrincipalId`.
+   Your output shows `PrincipalId`, `Type`, and `TenantId`. The identity assigned is the `PrincipalId`.
 
 1. You can also check the identity by going to the [Azure portal](https://portal.azure.com).
 
@@ -190,7 +190,7 @@ Connect to your SQL Database using a Microsoft Entra identity that has permissio
    GO
    ```
 
-1. In order to create other Microsoft Entra users, at minimum, the `ALTER ANY USER` SQL permission is required. This permission is also inherited through membership in `db_owner`, and through assignment as the Microsoft Entra admin. The following examples demonstrate three different options to assign permissions to *DBOwnerApp* that allow it to create other Microsoft Entra users in the database.
+1. To create other Microsoft Entra users, at minimum, the `ALTER ANY USER` SQL permission is required. This permission is also inherited through membership in `db_owner`, and through assignment as the Microsoft Entra admin. The following examples demonstrate three different options to assign permissions to *DBOwnerApp* that allow it to create other Microsoft Entra users in the database.
 
    You can add *DBOwnerApp* to the `db_owner` role with [sp_addrolemember](/sql/relational-databases/system-stored-procedures/sp-addrolemember-transact-sql):
 
@@ -206,7 +206,7 @@ Connect to your SQL Database using a Microsoft Entra identity that has permissio
    GO
    ```
 
-   You can set the *DBOwnerApp* as the Microsoft Entra admin. This can be done using the Azure portal, PowerShell, or Azure CLI commands. For more information, see [Set Microsoft Entra admin](authentication-aad-configure.md#azure-sql-database-and-azure-synapse-analytics).
+   You can set the *DBOwnerApp* as the Microsoft Entra admin. Use the Azure portal, PowerShell, or Azure CLI commands. For more information, see [Set Microsoft Entra admin](authentication-aad-configure.md#azure-sql-database-and-azure-synapse-analytics).
 
 <a id="create-an-azure-ad-user-in-sql-database-using-an-azure-ad-service-principal"></a>
 
@@ -220,6 +220,9 @@ Connect to your SQL Database using a Microsoft Entra identity that has permissio
    - Replace `<ServerName>` with your logical server name. If your server name is `myserver.database.windows.net`, replace `<ServerName>` with `myserver`.
    - Replace `<database name>` with your SQL Database name.
 
+   > [!NOTE]
+   > The following script requires the **Microsoft.Data.SqlClient** assembly. Install it from the [NuGet package](https://www.nuget.org/packages/Microsoft.Data.SqlClient) and load the DLL with `Add-Type -Path "path\to\Microsoft.Data.SqlClient.dll"` before running the script.
+
    ```powershell
    # PowerShell script for creating a new SQL user called myapp using application DBOwnerApp with secret
    # DBOwnerApp is an admin for the server
@@ -242,7 +245,7 @@ Connect to your SQL Database using a Microsoft Entra identity that has permissio
    $DatabaseName = "<database name>"   # Azure SQL database name
 
    Write-Host "Create SQL connection string"
-   $conn = New-Object System.Data.SqlClient.SQLConnection
+   $conn = New-Object Microsoft.Data.SqlClient.SqlConnection
    $conn.ConnectionString = "Data Source=$SQLServerName.database.windows.net;Initial Catalog=$DatabaseName;Connect Timeout=30"
    $conn.AccessToken = $Tok
 
@@ -252,14 +255,14 @@ Connect to your SQL Database using a Microsoft Entra identity that has permissio
    Write-host " "
    Write-host "SQL DDL command"
    $ddlstmt
-   $command = New-Object -TypeName System.Data.SqlClient.SqlCommand($ddlstmt, $conn)
+   $command = New-Object -TypeName Microsoft.Data.SqlClient.SqlCommand($ddlstmt, $conn)
 
    Write-host "results"
    $command.ExecuteNonQuery()
    $conn.Close()
    ```
 
-   Alternatively, you can use the following code: [Microsoft Entra service principal authentication to Azure SQL Database](https://techcommunity.microsoft.com/t5/azure-sql-database/azure-ad-service-principal-authentication-to-sql-db-code-sample/ba-p/481467). Modify the script to execute the DDL statement `CREATE USER [myapp] FROM EXTERNAL PROVIDER`. The same script can be used to create a Microsoft Entra user or group in your database.
+   Alternatively, you can use the following code: [Microsoft Entra service principal authentication to Azure SQL Database](https://techcommunity.microsoft.com/t5/azure-sql-database/azure-ad-service-principal-authentication-to-sql-db-code-sample/ba-p/481467). Modify the script to execute the DDL statement `CREATE USER [myapp] FROM EXTERNAL PROVIDER`. Use the same script to create a Microsoft Entra user or group in your database.
 
 1. Check if the user *myapp* exists in the database by executing the following command:
 

docs/analytics-platform-system/configure-polybase-connectivity-to-external-data.md

@@ -15,7 +15,7 @@ PolyBase enables your Analytics Platform System (APS) to process Transact-SQL qu
 
 ![PolyBase logical](media/polybase/polybase-logical.png)
 
-PolyBase on APS supports reading and writing to Hadoop (HDFS) file system and Azure Blob Storage. PolyBase also has the ability to push some computation to Hadoop nodes as mapreduce jobs to optimize the overall query performance. PolyBase on APS can operate on delimited text, ORC and Parquet files. See [What is PolyBase](../relational-databases/polybase/polybase-guide.md) for a full description and its capabilities.
+PolyBase on APS supports reading and writing to Hadoop (HDFS) file system and Azure Blob Storage. PolyBase also has the ability to push some computation to Hadoop nodes as mapreduce jobs to optimize the overall query performance. PolyBase on APS can operate on delimited text, ORC and Parquet files. See [What is PolyBase](../relational-databases/polybase/overview.md) for a full description and its capabilities.
 
 > [!NOTE]
 > APS currently only supports standard general purpose v1 locally redundant (LRS) Azure Blob Storage.

docs/analytics-platform-system/polybase-configure-azure-blob-storage.md

@@ -173,4 +173,4 @@ In SQL Server Data Tools (SSDT), external tables are displayed in a separate fol
 ## Next step
 
 > [!div class="nextstepaction"]
-> [Introducing data virtualization with PolyBase](../relational-databases/polybase/polybase-guide.md)
+> [Introducing data virtualization with PolyBase](../relational-databases/polybase/overview.md)

docs/analytics-platform-system/polybase-configure-hadoop.md

@@ -332,4 +332,4 @@ In SQL Server Data Tools, external tables are displayed in a separate folder **E
 ## Related content
 
 - For Hadoop security settings see [configure Hadoop security](polybase-configure-hadoop-security.md).
-- For more information about PolyBase, see the [What is PolyBase?](../relational-databases/polybase/polybase-guide.md).
+- For more information about PolyBase, see the [What is PolyBase?](../relational-databases/polybase/overview.md).

docs/database-engine/configure-windows/allow-polybase-export.md

@@ -18,7 +18,7 @@ The `allow polybase export` server configuration option allows the export of dat
 
 - In [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)] and later versions, the [CREATE EXTERNAL TABLE AS SELECT](../../t-sql/statements/create-external-table-as-select-transact-sql.md) (CETAS) statement requires that you enable `allow polybase export` using `sp_configure`. This setting allows for data to be exported to a CSV or Parquet file. For examples, see [Use CREATE EXTERNAL TABLE AS SELECT exporting data as parquet](../../t-sql/statements/create-external-table-as-select-transact-sql.md#d-use-create-external-table-as-select-exporting-data-as-parquet).
 
-- In [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] and earlier versions, enabling `allow polybase export` allows Hadoop to export data out of [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] to an external table. For more information, see [PolyBase connectors](../../relational-databases/polybase/polybase-guide.md#polybase-connectors) and [Export data](../../relational-databases/polybase/polybase-queries.md#export-data).
+- In [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)] and earlier versions, enabling `allow polybase export` allows Hadoop to export data out of [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] to an external table. For more information, see [PolyBase connectors](../../relational-databases/polybase/overview.md#polybase-connectors) and [Export data](../../relational-databases/polybase/polybase-queries.md#export-data).
 
 The possible values are described in the following table:
 
@@ -50,5 +50,5 @@ GO
 ## Related content
 
 - [Exporting data](../../relational-databases/polybase/polybase-configure-hadoop.md#exporting-data)
-- [Data virtualization with PolyBase in SQL Server](../../relational-databases/polybase/polybase-guide.md)
+- [Data virtualization with PolyBase in SQL Server](../../relational-databases/polybase/overview.md)
 - [CREATE EXTERNAL TABLE AS SELECT (CETAS) (Transact-SQL)](../../t-sql/statements/create-external-table-as-select-transact-sql.md)

docs/database-engine/configure-windows/polybase-connectivity-configuration-transact-sql.md

@@ -167,7 +167,7 @@ GO
 
 ## Related content
 
-- [Data virtualization with PolyBase in SQL Server](../../relational-databases/polybase/polybase-guide.md)
+- [Data virtualization with PolyBase in SQL Server](../../relational-databases/polybase/overview.md)
 - [sp_configure (Transact-SQL)](../../relational-databases/system-stored-procedures/sp-configure-transact-sql.md)
 - [CREATE EXTERNAL TABLE (Transact-SQL)](../../t-sql/statements/create-external-table-transact-sql.md)
 - [CREATE EXTERNAL FILE FORMAT (Transact-SQL)](../../t-sql/statements/create-external-file-format-transact-sql.md)

docs/database-engine/configure-windows/polybase-network-encryption-server-configuration-option.md

@@ -81,6 +81,6 @@ Requires `ALTER SETTINGS` server-level permission or membership in the **sysadmi
 ## Related content
 
 - [Exporting data](../../relational-databases/polybase/polybase-configure-hadoop.md#exporting-data)
-- [Data virtualization with PolyBase in SQL Server](../../relational-databases/polybase/polybase-guide.md)
+- [Data virtualization with PolyBase in SQL Server](../../relational-databases/polybase/overview.md)
 - [CREATE EXTERNAL TABLE AS SELECT (CETAS) (Transact-SQL)](../../t-sql/statements/create-external-table-as-select-transact-sql.md)
 - [PolyBase errors and possible solutions](../../relational-databases/polybase/polybase-errors-and-possible-solutions.md)

docs/database-engine/install-windows/install-sql-server-database-engine.md

@@ -56,7 +56,7 @@ The following features are installed when you select **SQL Server Database Engin
     > [!NOTE]  
     > In this release, selecting the **Data Quality Services** check box in setup doesn't install the Data Quality Services (DQS) server. You'll have to perform additional steps post installation to install DQS server. For more information, see [Install Data Quality Services](../../data-quality-services/install-windows/install-data-quality-services.md).
 
-- [Data virtualization with PolyBase in SQL Server](../../relational-databases/polybase/polybase-guide.md) is an optional component. In [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)], a Java connector for HDFS data sources is also available.
+- [Data virtualization with PolyBase in SQL Server](../../relational-databases/polybase/overview.md) is an optional component. In [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)], a Java connector for HDFS data sources is also available.
 
 The following additional features are options for many typical user scenarios:
 

docs/master-data-services/develop/create-a-custom-workflow-example.md

@@ -4,7 +4,7 @@ description: Create a Custom Workflow - Example
 author: meetdeepak
 ms.author: dkhare
 ms.reviewer: mikeray
-ms.date: 03/05/2026
+ms.date: 03/18/2026
 ms.service: sql
 ms.subservice: master-data-services
 ms.topic: reference
@@ -19,16 +19,16 @@ ms.custom:
 
   In [!INCLUDE[ssMDSshort](../../includes/ssmdsshort-md.md)], when you create a custom workflow class library, you create a class that implements the Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender interface. This interface includes one method, [Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender.StartWorkflow*](/previous-versions/sql/sql-server-2016/hh759009(v=sql.130)) , that is called by SQL Server MDS Workflow Integration Service when a workflow starts. The [Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender.StartWorkflow*](/previous-versions/sql/sql-server-2016/hh759009(v=sql.130))  method contains two parameters: *workflowType* contains the text you entered in the **Workflow type** text box in [!INCLUDE[ssMDSmdm](../../includes/ssmdsmdm-md.md)], and *dataElement* contains metadata and item data for the item that triggered the workflow business rule.  
 
-## Custom Workflow Example  
- The following code example shows how you how to implement the [Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender.StartWorkflow*](/previous-versions/sql/sql-server-2016/hh759009(v=sql.130))  method to extract the Name, Code, and LastChgUserName attributes from the XML data for the element that triggered the workflow business rule, and how to call a stored procedure to insert them into another database. For an example of the item data XML and an explanation of the tags it contains, see [Custom Workflow XML Description (Master Data Services)](../../master-data-services/develop/create-a-custom-workflow-xml-description.md).  
+## Custom workflow example  
+ The following code example shows how to implement the [Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender.StartWorkflow*](/previous-versions/sql/sql-server-2016/hh759009(v=sql.130))  method to extract the Name, Code, and LastChgUserName attributes from the XML data for the element that triggered the workflow business rule, and how to call a stored procedure to insert them into another database. For an example of the item data XML and an explanation of the tags it contains, see [Custom Workflow XML Description (Master Data Services)](../../master-data-services/develop/create-a-custom-workflow-xml-description.md).  
 
 ```csharp  
 using System;  
 using System.Collections.Generic;  
 using System.Linq;  
 using System.Text;  
 using System.IO;  
-using System.Data.SqlClient;  
+using Microsoft.Data.SqlClient;  
 using System.Xml;  
 
 using Microsoft.MasterDataServices.Core.Workflow;  
@@ -67,5 +67,6 @@ namespace MDSWorkflowTestLib
 }  
 ```  
 
-## See Also  
- [Create a Custom Workflow (Master Data Services)](../../master-data-services/develop/create-a-custom-workflow-master-data-services.md)
+## Related content
+
+- [Create a Custom Workflow (Master Data Services)](../../master-data-services/develop/create-a-custom-workflow-master-data-services.md)