dvc-azure

3.1.0 verified Mon Apr 27 auth: no python

Azure Blob Storage and Azure Data Lake Storage plugin for DVC (Data Version Control). Version 3.1.0 is the latest, requires Python >=3.9. Released as part of DVC's remote storage integration suite.

pip install dvc-azure

Common errors

error ModuleNotFoundError: No module named 'dvc_azure' ↓

cause Direct import of dvc_azure as a standalone package is incorrect; it's a DVC plugin.

fix

Use from dvc.fs import AzureFileSystem instead.

error dvc.exceptions.NotRemoteRepositoryError: Azure Blob Storage remote is not supported ↓

cause dvc-azure not installed or not configured in DVC.

fix

Run pip install dvc-azure and configure remote with dvc remote add myremote azure://mycontainer.

Warnings

breaking In v3.0.0, 'fs.path' methods were replaced with plain fs methods. Code relying on fs.path will break. ↓

fix Replace fs.path operations with direct fs methods (e.g., fs.isdir instead of fs.path.isdir).

deprecated The 'version_aware' parameter in '_prepare_credentials' is deprecated and ignored as of v2.22.1. ↓

fix Remove 'version_aware' from credential preparation logic.

gotcha dvc-azure must be installed in the same environment as DVC; otherwise, Azure remotes won't be recognized. ↓

fix Ensure `pip install dvc-azure` is run in the same virtualenv as DVC.

Imports

AzureFileSystem
wrong
```
from dvc_azure import AzureFileSystem
```
correct
```
from dvc.fs import AzureFileSystem
```
dvc-azure is a plugin; the filesystem class is re-exported via DVC's fs module.

Quickstart

Initialize an Azure filesystem and list root contents.

import os
from dvc.fs import AzureFileSystem

fs = AzureFileSystem(
    account_name=os.environ.get('AZURE_STORAGE_ACCOUNT', ''),
    account_key=os.environ.get('AZURE_STORAGE_KEY', ''),
    container_name='mycontainer',
)
print(fs.ls('/'))