GH-32123: [R] Expose azure blob filesystem by marberts · Pull Request #49553 · apache/arrow

marberts · 2026-03-19T03:08:36Z

Rationale for this change

This PR adds support for Azure. The Arrow R package already has support for AWS and GCS, and the Arrow C++ library has had support for Azure for a couple years now. Support for Azure is already available in pyarrow.

This would close #32123.

What changes are included in this PR?

A new class AzureFileSystem that's analogous to S3FileSystem/GcsFileSystem, along with a helper function az_container() that's analogous to s3_bucket()/gcs_bucket().
Updates to src/filesystem.cpp to interact with the machinery in arrow/filesystem/azurefs.h.
Updates to the configuration and build scripts to support building with support for Azure.
Updates to the vignettes on cloud storage, installation, and developer setup.

Are these changes tested?

Yes. See tests/testthat/test-azure.R.

Are there any user-facing changes?

Yes. There is a new function az_container(), serving the analogous role to s3_bucket()/gcs_bucket(), along with an R6 class AzureFileSystem, again serving the same role as S3FileSystem and GcsFileSystem. There is also a function arrow_with_azure() to indicate if Arrow was built with support for Azure.

GitHub Issue: [R] Expose Azure Blob Storage filesystem #32123

github-actions · 2026-03-19T03:08:59Z

Thanks for opening a pull request!

If this is not a minor PR. Could you open an issue for this pull request on GitHub? https://github.com/apache/arrow/issues/new/choose

Opening GitHub issues ahead of time contributes to the Openness of the Apache Arrow project.

Then could you also rename the pull request title in the following format?

GH-${GITHUB_ISSUE_ID}: [${COMPONENT}] ${SUMMARY}

or

MINOR: [${COMPONENT}] ${SUMMARY}

See also:

github-actions · 2026-03-19T03:09:44Z

⚠️ GitHub issue #32123 has been automatically assigned in GitHub to PR creator.

marberts · 2026-03-20T17:27:57Z

The CI is failing because the Azure C++ SDK depends on libxml2.

Update tools/nixlibs.R to check for libxml2 in with_cloud_support(), turning off the Azure feature flag if libxml2 isn't found.
- What about configure and configure.win?
- Is with_cloud_support() the only function that needs changing in tools/nixlibs.R?
Update the install.Rmd and developers/setup.Rmd vignettes to note that libxml2 is a dependency of Azure (same as with curl and openssl).
Update DESCRIPTION to include libxml2 in SystemRequirements.

marberts · 2026-03-24T02:16:12Z

It looks like the failing CI job is from a warning in R CMD check about a non-API call to a C function, due to all the changes in R-devel. I don't think this is due to our PR.

At this point, I'm fairly confident that we've implemented the Azure features correctly. The only thing I'm not sure about is the setup in configure, configure.win, and tools/nixlibs.R. The Azure C++ SDK used by Arrow requires libxml2, which is a new system dependency for this package. I don't fully understand how these configuration scripts work, so I wouldn't be surprised if they're not updated correctly to reflect the new system dependency.

@jonkeane, @thisisnic, @assignUser Please let me or @Collinbrown95 know if there are any changes needed to this PR.

thisisnic · 2026-03-24T15:43:49Z

Thanks for the PR @marberts - if you rebase from the main branch now, the non-API call stuff should be resolved.

Your best bet for the configure etc stuff is looking at the history of that file or older PRs to see how this kind of thing was handled there.

This PR where the GCS bindings were added might help: #13404, but let us know if you have any questions!

thisisnic · 2026-03-24T15:45:28Z

We'll also need additional CI jobs to test this - the PR I linked to above contains examples of what we added there.

marberts · 2026-03-24T19:52:50Z

Great, thanks @thisisnic!

marberts · 2026-03-24T19:53:37Z

To do list.

Rebase against main to fix failing CI job.
Review configure, configure.win and tools/nixlibs.R against changes in ARROW-16510: [R] Add bindings for GCS filesystem #13404. It's possible this will reveal some other changes that are needed.
Add CI job to test changes. See again ARROW-16510: [R] Add bindings for GCS filesystem #13404.

Collinbrown95 · 2026-03-26T03:55:46Z

@github-actions crossbow submit -g r

github-actions · 2026-03-26T03:56:18Z

Only contributors can submit requests to this bot. Please ask someone from the community for help with getting the first commit in.
The Archery job run can be found at: https://github.com/apache/arrow/actions/runs/23576717645

thisisnic · 2026-03-26T11:13:38Z

@github-actions crossbow submit -g r

github-actions · 2026-03-26T11:16:24Z

Revision: 4da7280

Submitted crossbow builds: ursacomputing/crossbow @ actions-92325d6543

Task	Status
r-binary-packages
r-recheck-most
test-r-alpine-linux-cran
test-r-arrow-backwards-compatibility
test-r-depsource-system
test-r-dev-duckdb
test-r-devdocs
test-r-extra-packages
test-r-fedora-clang
test-r-gcc-11
test-r-gcc-12
test-r-install-local
test-r-install-local-minsizerel
test-r-linux-as-cran
test-r-linux-rchk
test-r-linux-sanitizers
test-r-linux-valgrind
test-r-m1-san
test-r-macos-as-cran
test-r-offline-maximal
test-r-ubuntu-22.04
test-r-versions

marberts · 2026-03-29T01:07:11Z

@github-actions crossbow submit -g r

github-actions · 2026-03-29T01:07:47Z

Only contributors can submit requests to this bot. Please ask someone from the community for help with getting the first commit in.
The Archery job run can be found at: https://github.com/apache/arrow/actions/runs/23698292050

thisisnic · 2026-03-30T12:00:56Z

Some of those CI failures are from things which have been fixed on main - you'll need to rebase your branch.

Note: I think what's happening is that the build of Arrow I install doesn't have the ARROW_AZURE flag enabled. When I "force" the environment variable I get an error like "fs___AzureFileSystem__Make not found".

Note: this was causing a seg fault when anything that inherits from FileSystem ries to access the base_path property. Uncommenting the return line and rebuilding the R package resolved this issue.

At this point, I was able to call write_feather(example_data, fs$path("test/test.feather")) successfully against Azurite. Committing progress before I make any further changes.

…ere skipped because of the URI issue.

Switch over to locally hosted azurite instead of local docker container azurite.

…ript

The hypothesis is that the errors in the build logs are caused by incompatibilities between WIL (Windows Implementation Library) and MinGW GCC, so install them directly instead of trying to build from source.

…re C++ SDK

marberts requested review from assignUser, jonkeane and thisisnic as code owners March 19, 2026 03:08

github-actions Bot added Component: R Component: Documentation awaiting review Awaiting review labels Mar 19, 2026

marberts changed the title ~~32123 expose azure blob filesystem~~ GH-32123 [R]: Expose azure blob filesystem Mar 19, 2026

marberts changed the title ~~GH-32123 [R]: Expose azure blob filesystem~~ GH-32123: [R] Expose azure blob filesystem Mar 19, 2026

github-actions Bot removed the Component: Documentation label Mar 19, 2026

marberts marked this pull request as draft March 25, 2026 23:32

github-actions Bot added Component: Parquet Component: C++ Component: Python Component: FlightRPC Component: Documentation labels Apr 1, 2026

Collinbrown95 and others added 27 commits June 26, 2026 21:42

debug first argument check

a47bb9e

Note: I think what's happening is that the build of Arrow I install doesn't have the ARROW_AZURE flag enabled. When I "force" the environment variable I get an error like "fs___AzureFileSystem__Make not found".

Added endpoint + key, token, and default authentication

add7652

Finished logical for AzureFileSystem to match pyarrow

020fca2

standardize on ARROW_R_WITH_AZURE

156a945

temporary documentation of what I've tried so far

96ac7e9

Add TODO note in configure script to remove hard-coded link flags

ddf80e3

uncomment line 256 of filesystem.cpp

bb5d887

Note: this was causing a seg fault when anything that inherits from FileSystem ries to access the base_path property. Uncommenting the return line and rebuilding the R package resolved this issue.

checkpoint: resolved segfault error

d3d9b9e

At this point, I was able to call write_feather(example_data, fs$path("test/test.feather")) successfully against Azurite. Committing progress before I make any further changes.

Add most test cases from test_filesystem and recreate a couple that w…

9068886

…ere skipped because of the URI issue.

check that azurite is installed as precondition for test-azure.R script.

8a8267d

Switch over to locally hosted azurite instead of local docker container azurite.

Ran pre-commit hooks

93e1cdf

Removed tmp.md

6ef0963

wrap credential configuration methods with StopIfNotOk

f8e787d

move link flags to arrow_built_with ARROW_AZURE block in configure sc…

a1d72ab

…ript

add simple test function to work through codegen.R

82a5d37

cleanup azurefs test function code

246ff27

Trying PKGBUILD and windows build script again

1bdf2ab

Updated PKGBUILD

7148238

debug ci: add azure dependencies that CI tries to build from source.

d1c73bb

The hypothesis is that the errors in the build logs are caused by incompatibilities between WIL (Windows Implementation Library) and MinGW GCC, so install them directly instead of trying to build from source.

Removed tmp.md

8839eb2

Removed windows build and added macos

9639d0f

azure off for windows ci

cb1cb9f

Disable azure in configure.win

b367140

Add placeholder comment to flag present issues with MinGW and the Azu…

c4db209

…re C++ SDK

remove debugging script to install azure sdk from source

ce2e058

Updated vignettes to reflect Azure off on Windows

1279b02

Update github.packages.yml

c728602

marberts force-pushed the 32123-expose-azure-blob-filesystem branch from 46a4770 to c728602 Compare June 27, 2026 02:07

marberts added 2 commits June 26, 2026 22:23

Fixing lint in filesystem.cpp

4c370ca

Fixed warning in cpp code

df23828

Uh oh!

Conversation

marberts commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Rationale for this change

What changes are included in this PR?

Are these changes tested?

Are there any user-facing changes?

Uh oh!

github-actions Bot commented Mar 19, 2026

Uh oh!

github-actions Bot commented Mar 19, 2026

Uh oh!

marberts commented Mar 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

marberts commented Mar 24, 2026

Uh oh!

thisisnic commented Mar 24, 2026

Uh oh!

thisisnic commented Mar 24, 2026

Uh oh!

marberts commented Mar 24, 2026

Uh oh!

marberts commented Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Collinbrown95 commented Mar 26, 2026

Uh oh!

github-actions Bot commented Mar 26, 2026

Uh oh!

thisisnic commented Mar 26, 2026

Uh oh!

github-actions Bot commented Mar 26, 2026

Uh oh!

marberts commented Mar 29, 2026

Uh oh!

github-actions Bot commented Mar 29, 2026

Uh oh!

thisisnic commented Mar 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

marberts commented Mar 19, 2026 •

edited

Loading

marberts commented Mar 20, 2026 •

edited

Loading

marberts commented Mar 24, 2026 •

edited

Loading