Skip to content

Commit fb650c5

Browse files
Merge pull request #36234 from HugoMSFT/docs-editor/managed-identity-1768329756
Update managed-identity.md
2 parents 3195888 + 254a17b commit fb650c5

1 file changed

Lines changed: 31 additions & 8 deletions

File tree

docs/relational-databases/polybase/managed-identity.md

Lines changed: 31 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn to configure PolyBase to query Azure resources by using manag
44
author: MikeRayMSFT
55
ms.author: mikeray
66
ms.reviewer: randolphwest
7-
ms.date: 11/18/2025
7+
ms.date: 02/03/2026
88
ms.service: sql
99
ms.topic: concept-article
1010
ms.custom:
@@ -23,10 +23,29 @@ Starting with [!INCLUDE [sssql25-md](../../includes/sssql25-md.md)], you can use
2323
## Prerequisites
2424

2525
- [!INCLUDE [sssql25-md](../../includes/sssql25-md.md)]
26-
- [SQL Server enabled by Azure Arc](../../sql-server/azure-arc/managed-identity.md)
27-
- Enable the `allow server scoped db credentials` server configuration option
26+
27+
- [SQL Server enabled by Azure Arc](../../sql-server/azure-arc/managed-identity.md) **or** [Enable Microsoft Entra authentication for SQL Server on Azure VMs](/azure/azure-sql/virtual-machines/windows/configure-azure-ad-authentication-for-sql-vm)
28+
29+
- Enable the `allow server scoped db credentials` server configuration option.
30+
2831
- Give the managed identity access to the Azure Blob Storage resource.
2932

33+
## For SQL Server on Azure VMs
34+
35+
After you complete the [required steps](/azure/azure-sql/virtual-machines/windows/configure-azure-ad-authentication-for-sql-vm), add two new registry entries. You need these registry entries only for SQL Server on Azure Virtual Machines. For SQL Server instances enabled by Azure Arc, these entries are created automatically.
36+
37+
In the registry, update the `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\MSSQL17.MSSQLSERVER\MSSQLServer\FederatedAuthentication` subkey.
38+
39+
> [!CAUTION]
40+
> [!INCLUDE [ssnoteregistry-md](../../includes/ssnoteregistry-md.md)]
41+
42+
Create the following entries:
43+
44+
| Entry | Value |
45+
| --- | --- |
46+
| `AADAzureStorageEndPoint` | `storage.azure.com` |
47+
| `AADDataLakeEndPoint` | `datalake.azure.net` |
48+
3049
## Create database scoped credentials
3150

3251
Add a database scoped credential for managed identity.
@@ -59,7 +78,7 @@ Create the external data source with the following settings.
5978
- `abs://<container_name>@<storage_account_name>.blob.core.windows.net/`, or
6079
- `abs://<storage_account_name>.blob.core.windows.net/<container_name>`
6180

62-
- **Supported locations by product / service**
81+
- **Supported locations by product or service**
6382
- [!INCLUDE [sssql25-md](../../includes/sssql25-md.md)] enabled by Azure Arc
6483
- [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)]: Hierarchical namespace supported
6584

@@ -76,8 +95,10 @@ Create the external data source with the following settings.
7695
- `adls://<container_name>@<storage_account_name>.dfs.core.windows.net/`, or
7796
- `adls://<storage_account_name>.dfs.core.windows.net/<container_name>`
7897

79-
- **Supported locations by product / service**
98+
- **Supported locations by product or service**
99+
80100
- [!INCLUDE [sssql25-md](../../includes/sssql25-md.md)] enabled by Azure Arc
101+
- [!INCLUDE [sssql25-md](../../includes/sssql25-md.md)] on Azure VMs
81102
- [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)]
82103

83104
- **Authentication**
@@ -88,7 +109,7 @@ Create the external data source with the following settings.
88109

89110
## Query a Parquet file in Azure Blob Storage
90111

91-
[!INCLUDE [sssql25-md](../../includes/sssql25-md.md)] supports for managed identity through Azure Arc. For instructions, see [Managed identity for SQL Server enabled by Azure Arc](../../sql-server/azure-arc/managed-identity.md).
112+
[!INCLUDE [sssql25-md](../../includes/sssql25-md.md)] supports managed identity through Azure Arc. For instructions, see [Managed identity for SQL Server enabled by Azure Arc](../../sql-server/azure-arc/managed-identity.md).
92113

93114
The following example queries a Parquet file in Azure Blob Storage:
94115

@@ -124,11 +145,11 @@ Check the following items:
124145

125146
- The required registry entries exist.
126147

127-
- Verify that the `allow server scoped db credentials` server configuration option is enabled.
148+
- The `allow server scoped db credentials` server configuration option is enabled.
128149

129150
### File can't be opened (Error 13822)
130151

131-
You might encounter error 13822 when you access Azure Blob Storage or Azure Data Lake if the managed identity lacks permissions on the storage account, or network access to storage is blocked.
152+
You might encounter error 13822 when you access Azure Blob Storage or Azure Data Lake, if the managed identity lacks permissions on the storage account, or network access to storage is blocked:
132153

133154
```output
134155
Msg 13822, Level 16, State 1, Line 9
@@ -144,3 +165,5 @@ Check the following items:
144165
## Related content
145166

146167
- [Managed identity for SQL Server enabled by Azure Arc](../../sql-server/azure-arc/managed-identity.md)
168+
- [Enable Microsoft Entra authentication for SQL Server on Azure VMs](/azure/azure-sql/virtual-machines/windows/configure-azure-ad-authentication-for-sql-vm)
169+
- [Configure managed identities on Azure virtual machines (VMs)](/entra/identity/managed-identities-azure-resources/how-to-configure-managed-identities)

0 commit comments

Comments
 (0)