This is an automated email from the ASF dual-hosted git repository.
yuanzhou pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/incubator-gluten.git
The following commit(s) were added to refs/heads/main by this push:
new eaf6d238ce [VL][DOCS] update doc with supported ABFS authentication
mechanisms (#11675)
eaf6d238ce is described below
commit eaf6d238ce17e6bb9f7f9cb76686e84f3dfcc940
Author: Pratham Manja <[email protected]>
AuthorDate: Mon Mar 2 21:56:55 2026 +0530
[VL][DOCS] update doc with supported ABFS authentication mechanisms (#11675)
facebookincubator/velox#11623 and #8403 added support for SharedKey, SAS,
and OAuth ABFS access mechanisms. Updating the doc to reflect this.
---
docs/get-started/VeloxABFS.md | 32 +++++++++++++++++++++++++++++---
1 file changed, 29 insertions(+), 3 deletions(-)
diff --git a/docs/get-started/VeloxABFS.md b/docs/get-started/VeloxABFS.md
index 6e08824237..fd79a6272a 100644
--- a/docs/get-started/VeloxABFS.md
+++ b/docs/get-started/VeloxABFS.md
@@ -8,15 +8,41 @@ ABFS is an important data store for big data users. This doc
discusses config de
# Working with ABFS
-## Configuring ABFS Access Token
+## Configuring ABFS Authentication Type
-To configure access to your storage account, replace <storage-account> with
the name of your account. This property aligns with Spark configurations. By
setting this config multiple times using different storage account names, you
can access multiple ABFS accounts.
+The authentication mechanism for an Azure storage account is controlled by the
following property. Replace `<storage-account>` with the name of your Azure
Storage account. Defaults to `SharedKey` if not set.
+
+```sh
+spark.hadoop.fs.azure.account.auth.type.<storage-account>.dfs.core.windows.net
SharedKey
+```
+
+Allowed values are `SharedKey`, `OAuth`, and `SAS`.
+
+## Configuring ABFS Access Key
+
+To configure access to your storage account using a shared key, replace
`<storage-account>` with the name of your account. This property aligns with
Spark configurations. By setting this config multiple times using different
storage account names, you can access multiple ABFS accounts.
```sh
spark.hadoop.fs.azure.account.key.<storage-account>.dfs.core.windows.net
XXXXXXXXX
```
-### Other authentatication methods are not yet supported.
+## Configuring ABFS SAS Token
+
+To authenticate using a pre-generated SAS (Shared Access Signature) token, set
the following property. This token provides scoped and time-limited access to
specific resources.
+
+```sh
+spark.hadoop.fs.azure.sas.fixed.token.<storage-account>.dfs.core.windows.net
XXXXXXXXX
+```
+
+## Configuring ABFS OAuth
+
+To authenticate using OAuth 2.0, set the following properties. Replace
`<storage-account>` with the name of your Azure Storage account and
`<tenant-id>` with your Azure AD tenant ID.
+
+```sh
+spark.hadoop.fs.azure.account.oauth2.client.id.<storage-account>.dfs.core.windows.net
XXXXXXXXX
+spark.hadoop.fs.azure.account.oauth2.client.secret.<storage-account>.dfs.core.windows.net
XXXXXXXXX
+spark.hadoop.fs.azure.account.oauth2.client.endpoint.<storage-account>.dfs.core.windows.net
https://login.microsoftonline.com/<tenant-id>/oauth2/token
+```
# Local Caching support
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
