跳转到主要内容

Microsoft Azure Storage Common客户端库(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 上找到)。

如果您正在寻找服务总线或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之前的版本升级,请参阅升级文档、sample目录中的使用示例以及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

功能

  • blob

    • 创建/读取/更新/删除容器

    • 创建/读取/更新/删除 blob

    • 高级 blob 操作

  • 队列

    • 创建/删除队列

    • 插入/查看队列消息

    • 高级队列操作

  • 文件

    • 创建/更新/删除共享

    • 创建/更新/删除目录

    • 创建/读取/更新/删除文件

    • 高级文件操作

入门

下载

Python 的 Azure 存储 SDK 由 5 个包组成

  • azure-storage-blob

    • 包含 blob 服务 API。

  • azure-storage-file

    • 包含文件服务 API。

  • azure-storage-queue

    • 包含队列服务 API。

  • azure-storage-common

    • 包含 blob、文件和队列共享的通用代码。

  • azure-storage-nspkg

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

注意:从 0.36.0 版本开始,之前有一个包含所有服务的单个包(azure-storage)。它不再受支持,用户应根据需要单独安装上述 3 个服务包。此外,不再在 azure-storage 命名空间下发布 table 包,请参阅 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 目录中的 blob、队列和文件使用示例。

需要帮助?

如果遇到提供的代码问题,请务必检查 Microsoft Azure 开发者论坛Stack Overflow 开发者论坛

贡献代码或提供反馈

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

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

了解更多

项目详情


下载文件

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

源分发

azure-storage-common-2.1.0.tar.gz (41.9 kB 查看散列值)

上传时间

构建分发

azure_storage_common-2.1.0-py2.py3-none-any.whl (47.8 kB 查看散列值)

上传时间 Python 2 Python 3

由以下支持