Microsoft Azure Storage Common客户端库(Python版)
项目描述
Microsoft Azure Storage SDK for Python
本项目提供了一个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 的散列值
算法 | 散列摘要 | |
---|---|---|
SHA256 | ccedef5c67227bc4d6670ffd37cec18fb529a1b7c3a5e53e4096eb0cf23dc73f |
|
MD5 | 8b78fae1786098193ce21ddea0bf0157 |
|
BLAKE2b-256 | 4812e074fe454bc327fbe2a61e20d3260473ee4a0fd85387baf249dc83c8e774 |
azure_storage_common-2.1.0-py2.py3-none-any.whl 的散列值
算法 | 散列摘要 | |
---|---|---|
SHA256 | b01a491a18839b9d05a4fe3421458a0ddb5ab9443c14e487f40d16f9a1dc2fbe |
|
MD5 | 2a1bc3a3c9d804497df3e46f5e6fb07f |
|
BLAKE2b-256 | 6ba06794b318ce0118d1a4053bdf0149a60807407db9b710354f2b203c2f5975 |