{"id":21184,"library":"dvc-azure","title":"dvc-azure","description":"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.","status":"active","version":"3.1.0","language":"python","source_language":"en","source_url":"https://github.com/iterative/dvc-azure","tags":["dvc","azure","blob-storage","data-version-control","plugin"],"install":[{"cmd":"pip install dvc-azure","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core DVC required; dvc-azure is a plugin","package":"dvc","optional":false},{"reason":"Azure Data Lake Storage and Blob Storage filesystem abstraction","package":"adlfs","optional":false}],"imports":[{"note":"dvc-azure is a plugin; the filesystem class is re-exported via DVC's fs module.","wrong":"from dvc_azure import AzureFileSystem","symbol":"AzureFileSystem","correct":"from dvc.fs import AzureFileSystem"}],"quickstart":{"code":"import os\nfrom dvc.fs import AzureFileSystem\n\nfs = AzureFileSystem(\n    account_name=os.environ.get('AZURE_STORAGE_ACCOUNT', ''),\n    account_key=os.environ.get('AZURE_STORAGE_KEY', ''),\n    container_name='mycontainer',\n)\nprint(fs.ls('/'))","lang":"python","description":"Initialize an Azure filesystem and list root contents."},"warnings":[{"fix":"Replace fs.path operations with direct fs methods (e.g., fs.isdir instead of fs.path.isdir).","message":"In v3.0.0, 'fs.path' methods were replaced with plain fs methods. Code relying on fs.path will break.","severity":"breaking","affected_versions":"<3.0.0"},{"fix":"Remove 'version_aware' from credential preparation logic.","message":"The 'version_aware' parameter in '_prepare_credentials' is deprecated and ignored as of v2.22.1.","severity":"deprecated","affected_versions":">=2.22.1,<3.0.0"},{"fix":"Ensure `pip install dvc-azure` is run in the same virtualenv as DVC.","message":"dvc-azure must be installed in the same environment as DVC; otherwise, Azure remotes won't be recognized.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use `from dvc.fs import AzureFileSystem` instead.","cause":"Direct import of dvc_azure as a standalone package is incorrect; it's a DVC plugin.","error":"ModuleNotFoundError: No module named 'dvc_azure'"},{"fix":"Run `pip install dvc-azure` and configure remote with `dvc remote add myremote azure://mycontainer`.","cause":"dvc-azure not installed or not configured in DVC.","error":"dvc.exceptions.NotRemoteRepositoryError: Azure Blob Storage remote is not supported"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}