azure storage python
v2.1.0
Microsoft Azure Storage SDK для Python (устарело)
Этот проект будет находиться в [поддержке сообщества](https://azure.github.io/azure-sdk/policies_support.html#package-lifecycle) до 13 сентября 2024 г. После этой даты проект и связанные клиентские библиотеки будут окончательно прекращены. . Дополнительные сведения о прекращении использования этого проекта и альтернативах использованию этого проекта см. на странице [Уведомление о прекращении использования: устаревшие клиентские библиотеки Azure Storage Python будут прекращены 13 сентября 2024 г.](https://azure.microsoft.com/updates/retirement-notice- the-legacy-azure-storage-python-client-libraries-будет выведен из эксплуатации 13-сентября-2024 г./).
НОВОСТИ!! azure-storage-blob v12 теперь общедоступна!
Посетите https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage, чтобы узнать больше.
Примечание . Текущий репозиторий предназначен для azure-storage-blob<=2.1.0, обновление до версии 12.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, см. документацию по обновлению, примеры использования в каталоге примеров, а также журнал изменений и BreakingChanges.
Если у вас возникли проблемы при установке хранилища Azure в веб-приложениях Azure, может помочь обновление pip.
ВАЖНО . Если у вас установлена более ранняя версия пакета azure-storage (версия <= 0.36.0), вам следует удалить ее перед установкой новых разделенных пакетов.
Проверить версию можно с помощью pip:
pip freezeЕсли вы видите azure-storage==0.36.0 (или любую версию ниже 0.36.0), сначала удалите ее:
pip uninstall azure-storageПакет SDK службы хранилища Azure для Python состоит из 5 пакетов:
Примечание . До версии 0.36.0 включительно существовал один пакет (azure-storage), содержащий все службы. Он больше не поддерживается, и пользователям следует установить три вышеупомянутых пакета услуг индивидуально, в зависимости от необходимости. Кроме того, пакет table больше не выпускается в пространстве имен azure-storage, см. CosmosDB.
Для установки через индекс пакетов Python (PyPI) введите:
pip install azure-storage-blob pip install файл-хранилища Azure pip install azure-storage-queue
Чтобы получить исходный код SDK через git, просто введите:
git clone 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, чтобы установить другие службы.
Загрузите ZIP-архив кода через GitHub или PyPi. Затем следуйте тем же инструкциям, что и в варианте 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:
См. каталог примеров для примеров использования больших двоичных объектов, очередей и файлов.
Обязательно посетите форумы разработчиков Microsoft Azure на MSDN или форумы разработчиков на Stack Overflow, если у вас возникли проблемы с предоставленным кодом.
Если вы хотите стать активным участником этого проекта, следуйте инструкциям, приведенным в Руководстве по участию в проектах Azure. Более подробную информацию о вкладе вы можете найти в документе CONTRIBUTING.md.
Если вы обнаружите какие-либо ошибки в библиотеке, сообщите о проблеме в разделе «Проблемы» проекта.
