适用于 Python 的 Microsoft Azure 存储 SDK(已弃用)
该项目将在 [社区支持](https://azure.github.io/azure-sdk/policies_support.html#package-lifecycle) 中持续到 2024 年 9 月 13 日。在此日期之后,该项目和关联的客户端库将永久停用。有关停用和使用此项目的替代方案的更多详细信息,请访问[停用通知:旧版 Azure 存储 Python 客户端库将于 2024 年 9 月 13 日停用](https://azure.microsoft.com/updates/retirement-notice- the-legacy-azure-storage-python-client-libraries-will-be-retired-on-13-september-2024/)。
消息!! azure-storage-blob v12 现已正式发布!
请访问 https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage 了解更多信息。
注意:当前存储库适用于 azure-storage-blob<=2.1.0,升级到 v12.0.0 可能会破坏当前代码。
该项目提供了一个 Python 客户端库,可以轻松使用 Microsoft Azure 存储服务。有关文档,请参阅 Microsoft Azure Python 开发人员中心和我们的 API 参考(也可在 readthedocs 上找到)。
如果您正在寻找服务总线或 Azure 管理库,请访问 https://github.com/Azure/azure-sdk-for-python。
重要提示:如果您有早期版本的 azure 软件包(版本 < 1.0),则应在安装此软件包之前将其卸载。
您可以使用 pip 检查版本:
pip freeze
如果您看到 azure==0.11.0(或任何低于 1.0 的版本),请先卸载它,然后再次安装:
pip uninstall azure
pip install azure
如果您要从 0.30.0 之前的版本升级,请参阅升级文档、示例目录中的使用示例以及 ChangeLog 和 BreakingChanges。
如果在 Azure Web Apps 上安装 Azure 存储时遇到问题,升级 pip 可能会有所帮助。
重要提示:如果您有早期版本的 azure-storage 软件包(版本 <= 0.36.0),则应在安装新的拆分软件包之前将其卸载。
您可以使用 pip 检查版本:
pip freeze
如果您看到 azure-storage==0.36.0(或任何低于 0.36.0 的版本),请先卸载它:
pip uninstall azure-storage
适用于 Python 的 Azure 存储 SDK 由 5 个包组成:
注意:在 0.36.0 版本之前(包括版本 0.36.0),曾经有一个包含所有服务的单个包(azure-storage)。不再支持,用户应根据需要单独安装上述3个服务包。另外,表包不再在azure-storage命名空间下发布,请参考cosmosdb。
要通过 Python 包索引 (PyPI) 安装,请键入:
pip 安装 azure-storage-blob pip 安装 azure 存储文件 pip 安装 azure 存储队列
要通过 git 获取 SDK 的源代码,只需输入:
git 克隆 git://github.com/Azure/azure-storage-python.git cd ./azure-storage-python/azure-storage-nspkg python setup.py 安装 cd ../azure-storage-common python setup.py 安装 cd ../azure-storage-blob python setup.py 安装
将 azure-storage-blob 替换为 azure-storage-file 或 azure-storage-queue,以安装其他服务。
通过 GitHub 或 PyPi 下载代码的 zip 文件。然后按照选项 2 中的相同说明进行操作。
要使用此SDK调用Microsoft Azure存储服务,您需要先创建一个帐户。
为了使调试更容易,建议为名为“azure.storage”的记录器打开日志记录。以下是两个示例配置:
# Basic configuration: configure the root logger, including 'azure.storage'
logging . basicConfig ( format = '%(asctime)s %(name)-20s %(levelname)-5s %(message)s' , level = logging . INFO )
# More advanced configuration allowing more control
logger = logging . getLogger ( 'azure.storage' )
handler = logging . StreamHandler ()
formatter = logging . Formatter ( '%(asctime)s %(name)-20s %(levelname)-5s %(message)s' )
handler . setFormatter ( formatter )
logger . addHandler ( handler )
logger . setLevel ( logging . INFO )
以下是我们如何使用日志级别,建议使用 INFO:
请参阅示例目录以获取 blob、队列和文件使用示例。
如果您对所提供的代码有疑问,请务必查看 MSDN 上的 Microsoft Azure 开发人员论坛或 Stack Overflow 上的开发人员论坛。
如果你想成为该项目的积极贡献者,请按照 Azure 项目贡献指南中提供的说明进行操作。您可以在 CONTRIBUTING.md 文档中找到有关贡献的更多详细信息。
如果您遇到该库的任何错误,请在项目的问题部分提出问题。