用于python的Microsoft azure存储队列客户端库
azure-storage-queue的Python项目详细描述
用于python的Microsoft azure存储sdk
这个项目提供了一个python客户端库,使得 使用Microsoft azure存储服务。有关文档,请参见 微软的azure Python Developer Center和我们的API Reference(也可以在readthedocs上获得)。
If you are looking for the Service Bus or Azure Management libraries, please visit https://github.com/Azure/azure-sdk-for-python.
兼容性
important:如果你有早期版本的azure包 (版本<;1.0),您应该在安装此软件包之前卸载它。
您可以使用pip:
pip freeze
如果看到azure==0.11.0(或1.0以下的任何版本),请先卸载它,然后再次安装:
pip uninstall azure pip install azure
如果要从早于0.30.0的版本升级,请参阅升级文档 samples目录中的usage samples,以及changelog和breakingchanges。
如果您遇到problems在azure web应用上安装azure存储, upgrading pip可能有帮助。
important:如果你有早期版本的azure存储包 (version<;=0.36.0),您应该在安装新的拆分包之前卸载它。
您可以使用pip:
pip freeze
如果看到azure storage==0.36.0(或低于0.36.0的任何版本),请先卸载它:
pip uninstall azure-storage
功能
- 气泡
- 创建/读取/更新/删除容器
- 创建/读取/更新/删除blob
- 高级blob操作
- 排队
- 创建/删除队列
- 插入/查看队列消息
- 高级队列操作
- 文件
- 创建/更新/删除共享
- 创建/更新/删除目录
- 创建/读取/更新/删除文件
- 高级文件操作
开始
下载
用于python的azure存储sdk由5个包组成:
- azure存储blob
- 包含blob服务api。
- azure存储文件
- 包含文件服务API。
- azure存储队列
- 包含队列服务API。
- azure通用存储
- 包含blob、文件和队列共享的公共代码。
- 天青存储nspkg
- 拥有azure.storage命名空间,用户不应直接使用此命名空间。
note:在0.36.0之前(包括0.36.0版本),曾经有一个包含所有服务的包(azure存储)。 它不再受支持,用户应该根据需要单独安装前面提到的3个服务包。 此外,表包不再在azure存储命名空间下发布,请参阅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存储blob替换为azure存储文件或azure存储队列,以安装其他服务。
选项3:源zip
通过github或pypi下载代码的zip。然后按照选项2中的相同说明操作。
最低要求
- Python2.7、3.3、3.4、3.5或3.6。
- 有关依赖项,请参见setup.py
使用量
要使用此sdk调用Microsoft azure存储服务,您需要 第一个create an account。
记录
为了简化调试,建议为名为“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 controllogger=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)
下面是我们如何使用日志级别,建议使用信息:
- 调试:记录要签名的字符串
- 信息:记录传出的请求和响应,以及重试尝试
- 警告:未使用
- 错误:所有重试后仍失败的日志调用
代码示例
请参阅blob、队列和文件使用情况示例的示例目录。
需要帮助吗?
一定要查看Microsoft AzureDeveloper Forums on MSDN或 如果你有麻烦 提供的代码。
提供代码或反馈
如果你想成为这个项目的积极贡献者,请 按照Azure Projects Contribution Guidelines中提供的说明操作。您可以在CONTRIBUTING.md doc中找到更多有关贡献的详细信息。
如果您在库中遇到任何错误,请在 Issues项目的部分。