Microsoft Azure Storage SDK für Python (veraltet)
Dieses Projekt befindet sich bis zum 13. September 2024 im [Community-Support](https://azure.github.io/azure-sdk/policies_support.html#package-lifecycle). Nach diesem Datum werden das Projekt und die zugehörigen Clientbibliotheken endgültig eingestellt . Weitere Informationen zur Einstellung und zu Alternativen zur Verwendung dieses Projekts finden Sie unter [Hinweis zur Einstellung: Die alten Azure Storage Python-Clientbibliotheken werden am 13. September 2024 eingestellt](https://azure.microsoft.com/updates/retirement-notice- the-legacy-azure-storage-python-client-libraries-will-be-retired-on-13-september-2024/).
NACHRICHT!! Azure-Storage-Blob v12 ist jetzt GA!
Besuchen Sie https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage, um mehr zu erfahren.
Hinweis : Das aktuelle Repo ist für Azure-Storage-Blob<=2.1.0. Ein Upgrade auf Version 12.0.0 könnte Ihren aktuellen Code beschädigen.
Dieses Projekt stellt eine Clientbibliothek in Python bereit, die die Nutzung von Microsoft Azure Storage-Diensten vereinfacht. Die Dokumentation finden Sie im Microsoft Azure Python Developer Center und in unserer API-Referenz (auch auf readthedocs verfügbar).
Wenn Sie nach den Service Bus- oder Azure Management-Bibliotheken suchen, besuchen Sie bitte https://github.com/Azure/azure-sdk-for-python.
WICHTIG : Wenn Sie über eine frühere Version des Azure-Pakets (Version < 1.0) verfügen, sollten Sie diese deinstallieren, bevor Sie dieses Paket installieren.
Sie können die Version mit pip überprüfen:
pip freeze
Wenn Sie azure==0.11.0 (oder eine andere Version unter 1.0) sehen, deinstallieren Sie es zuerst und installieren Sie es dann erneut:
pip uninstall azure
pip install azure
Wenn Sie ein Upgrade von einer älteren Version als 0.30.0 durchführen, sehen Sie sich das Upgrade-Dokument, die Verwendungsbeispiele im Beispielverzeichnis sowie das ChangeLog und BreakingChanges an.
Wenn bei der Installation von Azure Storage auf Azure Web Apps Probleme auftreten, kann ein Upgrade von pip hilfreich sein.
WICHTIG : Wenn Sie über eine frühere Version des Azure-Storage-Pakets (Version <= 0.36.0) verfügen, sollten Sie diese deinstallieren, bevor Sie die neuen Split-Pakete installieren.
Sie können die Version mit pip überprüfen:
pip freeze
Wenn azure-storage==0.36.0 (oder eine andere Version unter 0.36.0) angezeigt wird, deinstallieren Sie es zuerst:
pip uninstall azure-storage
Das Azure Storage SDK für Python besteht aus 5 Paketen:
Hinweis : Vor und einschließlich Version 0.36.0 gab es ein einziges Paket (Azure-Storage), das alle Dienste enthielt. Es wird nicht mehr unterstützt und Benutzer sollten die drei oben genannten Servicepakete je nach Bedarf einzeln installieren. Darüber hinaus wird das Tabellenpaket nicht mehr unter dem Namensraum „azure-storage“ veröffentlicht, siehe cosmosdb.
Geben Sie zur Installation über den Python Package Index (PyPI) Folgendes ein:
pip install azure-storage-blob pip installiert die Azure-Speicherdatei pip install azure-storage-queue
Um den Quellcode des SDK über Git zu erhalten, geben Sie einfach Folgendes ein:
Git-Klon git://github.com/Azure/azure-storage-python.git cd ./azure-storage-python/azure-storage-nspkg Python setup.py installieren cd ../azure-storage-common Python setup.py installieren cd ../azure-storage-blob Python setup.py installieren
Ersetzen Sie „azure-storage-blob“ durch „azure-storage-file“ oder „azure-storage-queue“, um die anderen Dienste zu installieren.
Laden Sie eine Zip-Datei des Codes über GitHub oder PyPi herunter. Befolgen Sie dann die gleichen Anweisungen wie in Option 2.
Um dieses SDK zum Aufrufen von Microsoft Azure-Speicherdiensten zu verwenden, müssen Sie zunächst ein Konto erstellen.
Um das Debuggen zu vereinfachen, wird empfohlen, die Protokollierung für den Logger mit dem Namen „azure.storage“ zu aktivieren. Hier sind zwei Beispielkonfigurationen:
# 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 )
So verwenden wir die Protokollierungsstufen. Es wird empfohlen, INFO zu verwenden:
Beispiele für die Verwendung von Blobs, Warteschlangen und Dateien finden Sie im Beispielverzeichnis.
Schauen Sie sich unbedingt die Microsoft Azure-Entwicklerforen auf MSDN oder die Entwicklerforen auf Stack Overflow an, wenn Sie Probleme mit dem bereitgestellten Code haben.
Wenn Sie ein aktiver Mitwirkender an diesem Projekt werden möchten, befolgen Sie bitte die Anweisungen in den Beitragsrichtlinien für Azure-Projekte. Weitere Details zum Mitwirken finden Sie im Dokument CONTRIBUTING.md.
Wenn Sie auf Fehler in der Bibliothek stoßen, melden Sie bitte ein Problem im Abschnitt „Probleme“ des Projekts.