SDK de stockage Microsoft Azure pour Python (obsolète)
Ce projet sera dans [Support communautaire](https://azure.github.io/azure-sdk/policies_support.html#package-lifecycle) jusqu'au 13 septembre 2024. Après cette date, le projet et les bibliothèques clientes associées seront définitivement retirés. . Pour plus de détails sur le retrait et les alternatives à l'utilisation de ce projet, consultez [Avis de retrait : Les anciennes bibliothèques client Azure Storage Python seront retirées le 13 septembre 2024](https://azure.microsoft.com/updates/retirement-notice- les-bibliothèques-client-python-de-stockage-azure-héritées-seront-retraitées-le-13-septembre-2024/).
NOUVELLES!! Azure-storage-blob v12 est désormais GA !
Visitez https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage pour en savoir plus.
Remarque : le dépôt actuel concerne azure-storage-blob<=2.1.0, la mise à niveau vers la v12.0.0 pourrait casser votre code actuel.
Ce projet fournit une bibliothèque cliente en Python qui facilite la consommation des services Microsoft Azure Storage. Pour obtenir de la documentation, veuillez consulter le Centre de développement Microsoft Azure Python et notre référence API (également disponible sur readthedocs).
Si vous recherchez les bibliothèques Service Bus ou Azure Management, veuillez visiter https://github.com/Azure/azure-sdk-for-python.
IMPORTANT : Si vous disposez d'une version antérieure du package azure (version < 1.0), vous devez la désinstaller avant d'installer ce package.
Vous pouvez vérifier la version en utilisant pip :
pip freeze
Si vous voyez azure==0.11.0 (ou toute version inférieure à 1.0), désinstallez-le d'abord, puis réinstallez-le :
pip uninstall azure
pip install azure
Si vous effectuez une mise à niveau à partir d'une version antérieure à 0.30.0, consultez la documentation de mise à niveau, les exemples d'utilisation dans le répertoire des exemples, ainsi que ChangeLog et BreakingChanges.
Si vous rencontrez des problèmes lors de l'installation du stockage Azure sur Azure Web Apps, la mise à niveau de pip peut vous aider.
IMPORTANT : Si vous disposez d'une version antérieure du package azure-storage (version <= 0.36.0), vous devez la désinstaller avant d'installer les nouveaux packages fractionnés.
Vous pouvez vérifier la version en utilisant pip :
pip freeze
Si vous voyez azure-storage==0.36.0 (ou toute version inférieure à 0.36.0), désinstallez-le d'abord :
pip uninstall azure-storage
Le SDK Azure Storage pour Python est composé de 5 packages :
Remarque : avant et y compris la version 0.36.0, il existait un seul package (azure-storage) contenant tous les services. Il n'est plus pris en charge et les utilisateurs doivent installer les 3 packages de services mentionnés précédemment individuellement, en fonction des besoins. De plus, le package table n'est plus publié sous l'espace de noms Azure-Storage, veuillez vous référer à cosmosdb.
Pour installer via le Python Package Index (PyPI), tapez :
pip installer azure-storage-blob pip installe le fichier de stockage Azure pip installe la file d'attente de stockage Azure
Pour obtenir le code source du SDK via git, tapez simplement :
git clone git://github.com/Azure/azure-storage-python.git cd ./azure-storage-python/azure-storage-nspkg installation de python setup.py cd ../azure-storage-common installation de python setup.py cd ../azure-storage-blob installation de python setup.py
Remplacez azure-storage-blob par azure-storage-file ou azure-storage-queue pour installer les autres services.
Téléchargez un zip du code via GitHub ou PyPi. Suivez ensuite les mêmes instructions que dans l'option 2.
Pour utiliser ce SDK pour appeler les services de stockage Microsoft Azure, vous devez d'abord créer un compte.
Pour faciliter le débogage, il est recommandé d'activer la journalisation pour le logger nommé « azure.storage ». Voici deux exemples de configuration :
# 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 )
Voici comment nous utilisons les niveaux de journalisation, il est recommandé d'utiliser INFO :
Consultez le répertoire d’exemples pour obtenir des exemples d’utilisation des objets blob, des files d’attente et des fichiers.
Assurez-vous de consulter les forums des développeurs Microsoft Azure sur MSDN ou les forums des développeurs sur Stack Overflow si vous rencontrez des problèmes avec le code fourni.
Si vous souhaitez devenir un contributeur actif à ce projet, veuillez suivre les instructions fournies dans les directives de contribution aux projets Azure. Vous pouvez trouver plus de détails sur la contribution dans le document CONTRIBUTING.md.
Si vous rencontrez des bugs avec la bibliothèque, veuillez signaler un problème dans la section Problèmes du projet.