parse_storage_path: Parse an Azure Storage path
In azr: Credential Chain for OAuth 2.0 Authentication to 'Azure'

parse_storage_path

R Documentation

Parse an Azure Storage path

Description

Splits an Azure Storage URL or Hadoop filesystem path into its constituent parts. Supports all common Azure Storage path formats:

⁠abfss://⁠ / ⁠abfs://⁠: Azure Data Lake Storage Gen2 (DFS endpoint), used by Spark / Hadoop.
⁠wasbs://⁠ / ⁠wasb://⁠: Legacy Azure Blob filesystem scheme, used by older Spark / Hadoop integrations.
⁠https://⁠ / ⁠http://⁠: Standard Azure Blob or DFS REST endpoint, optionally with a SAS token query string.
⁠az://⁠ / ⁠azure://⁠: Non-standard aliases used by some Python tools (e.g. adlfs); parsed using the same container@account.host/path shape as ⁠abfs://⁠.

The format field is inferred from the path on a best-effort basis: "delta" when the path contains ⁠_delta_log⁠; a file extension name ("parquet", "csv", "json", "avro", "orc", "text") when the last path segment has a recognised extension; "folder" when there is no extension; and NA for unrecognised extensions.

Usage

parse_storage_path(path)

Arguments

path

A character string containing the Azure Storage path to parse.

Value

An azure_storage_path object (a named list) with the fields:

scheme: URL scheme, e.g. "abfss", "wasbs", "https".
storage_account: Storage account name.
endpoint: Storage endpoint type: "dfs" or "blob".
endpoint_suffix: Host suffix after the endpoint label, e.g. "core.windows.net" (Azure public), "core.usgovcloudapi.net" (US Government), "core.chinacloudapi.cn" (China), or "storage.azure.net" (DNS-zone endpoints). Use this to distinguish sovereign clouds from the public cloud.
container: Container name. Called "filesystem" in ADLS Gen2 / ABFS contexts; both refer to the same underlying object.
path: Path within the container, without a leading /. Empty string if the URL points to the container root.
format: Inferred dataset or file format (see above).
query: Named list of query parameters (e.g. a parsed SAS token), or NULL if none.
original: The original input string.

Examples

parse_storage_path(
  "abfss://mycontainer@myaccount.dfs.core.windows.net/data/sales/2024"
)

parse_storage_path(
  "https://myaccount.blob.core.windows.net/mycontainer/data/events.parquet"
)

parse_storage_path(
  "wasbs://mycontainer@myaccount.blob.core.windows.net/data/delta_table"
)

azr documentation built on Nov. 13, 2026, 5:07 p.m.