Skip to content

Update Azure Data Lake Storage access information #10246

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
WilliamDAssafMSFT merged 2 commits into from
Dec 12, 2025
Merged

Update Azure Data Lake Storage access information #10246

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
bd843ea
Update Azure Data Lake Storage access information
jasonhorner Dec 9, 2025
1147855
20251212 minor edits
WilliamDAssafMSFT Dec 12, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion docs/t-sql/functions/openrowset-bulk-transact-sql.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: "OPENROWSET BULK function reads data from an external data source."
author: MikeRayMSFT
ms.author: mikeray
ms.reviewer: randolphwest, hudequei, wiassaf, jovanpop, fresantos
ms.date: 12/01/2025
ms.date: 12/12/2025
ms.service: sql
ms.subservice: t-sql
ms.topic: reference
Expand Down Expand Up @@ -165,6 +165,10 @@ Beginning with [!INCLUDE [sssql17-md](../../includes/sssql17-md.md)], the *data_
- `abfss://<container>@<storage>.dfs.core.windows.net/<file path>` to access Azure Data Lake Storage
- `https://onelake.dfs.fabric.microsoft.com/<workspaceId>/<lakehouseId>/Files/<file path>` - to access OneLake in Microsoft Fabric

When accessing data stored in Azure Data Lake Storage Gen2, use the `abfss://<container>@<storage>.dfs.core.windows.net/<file path>` or `https://<storage>.dfs.core.windows.net/<container>/<file path>` URI formats instead of the blob endpoint. Both 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 hierarchical namespace features and treats all paths as flat object keys. This can lead to reduced performance, limited directory behavior, and incompatibility with engines that expect Azure Data Lake Storage 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).

Expand Down