From bd843ead0f5e6bdb93f260639e3d33bd6b4a6066 Mon Sep 17 00:00:00 2001 From: Jason Horner Date: Tue, 9 Dec 2025 12:12:03 -0700 Subject: [PATCH] Update Azure Data Lake Storage access information Clarified URI formats for accessing Azure Data Lake Storage from Fabric and highlighted differences between DFS/ABFS and Blob endpoints. --- docs/t-sql/functions/openrowset-bulk-transact-sql.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/t-sql/functions/openrowset-bulk-transact-sql.md b/docs/t-sql/functions/openrowset-bulk-transact-sql.md index cd3b01b71d4..b6950c7f584 100644 --- a/docs/t-sql/functions/openrowset-bulk-transact-sql.md +++ b/docs/t-sql/functions/openrowset-bulk-transact-sql.md @@ -165,6 +165,12 @@ Beginning with [!INCLUDE [sssql17-md](../../includes/sssql17-md.md)], the *data_ - `abfss://@.dfs.core.windows.net/` to access Azure Data Lake Storage - `https://onelake.dfs.fabric.microsoft.com///Files/` - to access OneLake in Microsoft Fabric +When accessing data stored in Azure Data Lake Storage Gen2, use the `abfss://@.dfs.core.windows.net/` or `https://.dfs.core.windows.net//` URI formats instead of the Blob endpoint. + +The DFS and ABFS schemes provide full support for the hierarchical namespace (HNS), which enables directory semantics, optimized file operations, and POSIX-style access control lists (ACLs). + +In contrast, the Blob endpoint does not expose HNS features and treats all paths as flat object keys. This can lead to reduced performance, limited directory behavior, and incompatibility with engines that expect ADLS Gen2 filesystem semantics. + > [!NOTE] > This article and the supported URI patterns differ on different platforms. For the URI patterns that are available in SQL Server, Azure SQL Database, and Azure SQL Managed Instance, [select the product in the version dropdown list](openrowset-bulk-transact-sql.md?view=sql-server-ver17&preserve-view=true#bulk-data_file_path).