跳转到主要内容

Microsoft Azure Storage File Client Library for Python

项目描述

Microsoft Azure Storage SDK for Python

https://travis-ci.org/Azure/azure-storage-python.svg https://img.shields.io/codecov/c/github/azure/azure-storage-python.svg

此项目提供了一个Python客户端库,简化了对Microsoft Azure Storage服务的使用。有关文档,请参阅Microsoft Azure Python开发者中心 和我们的 API参考(也可在readthedocs上找到)。

如果您正在寻找Service Bus或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的版本升级,请参阅升级文档、samples目录中的使用示例以及ChangeLog和BreakingChanges。

如果您在安装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 个包组成

  • azure-storage-blob

    • 包含块服务 API。

  • azure-storage-file

    • 包含文件服务 API。

  • azure-storage-queue

    • 包含队列服务 API。

  • azure-storage-common

    • 包含块、文件和队列共享的公共代码。

  • azure-storage-nspkg

    • 拥有 azure.storage 命名空间,用户不应直接使用此包。

注意:在版本 0.36.0 及之前,曾经有一个包含所有服务的单个包(azure-storage)。它不再受支持,并且根据需要,用户应单独安装上述 3 个服务包。另外, 包不再在 azure-storage 命名空间下发布,请参阅 cosmosdb

选项 1:通过 PyPi

要通过 Python 包索引(PyPI)安装,请键入

pip install azure-storage-blob
pip install azure-storage-file
pip install azure-storage-queue

选项 2:通过 Git 获取源代码

要使用 git 获取 SDK 的源代码,请键入

git clone git://github.com/Azure/azure-storage-python.git

cd ./azure-storage-python/azure-storage-nspkg
python setup.py install

cd ../azure-storage-common
python setup.py install

cd ../azure-storage-blob
python setup.py install

将 azure-storage-blob 替换为 azure-storage-file 或 azure-storage-queue,以安装其他服务。

选项 3:源代码 Zip 文件

通过 GitHub 或 PyPi 下载代码的 zip 文件。然后按照选项 2 中的相同说明进行操作。

最低要求

  • Python 2.7、3.3、3.4、3.5 或 3.6。

  • 请参阅 setup.py 以获取依赖项

用法

要使用此 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

  • DEBUG:记录签名字符串

  • INFO:记录出站请求和响应,以及重试尝试

  • WARNING:未使用

  • ERROR:记录所有重试后仍然失败的调用

代码示例

请参阅 samples 目录以获取块、队列和文件使用示例。

需要帮助?

如果您在使用提供的代码时遇到问题,请务必查看 Microsoft Azure MSDN 开发者论坛Stack Overflow 开发者论坛

贡献代码或提供反馈

如果您想成为此项目的积极贡献者,请按照 Azure 项目贡献指南 中提供的说明操作。您可以在 CONTRIBUTING.md 文档 中找到有关贡献的更多详细信息。

如果您在库中遇到任何错误,请在项目的 问题 部分中提交一个问题。

了解更多

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源代码分发

azure-storage-file-2.1.0.tar.gz (36.2 kB 查看哈希值)

上传时间 源代码

构建分发

azure_storage_file-2.1.0-py2.py3-none-any.whl (37.0 kB 查看哈希值)

上传时间 Python 2 Python 3