Microsoft Azure Storage SDK for Python (非推奨)
このプロジェクトは、2024 年 9 月 13 日まで [コミュニティ サポート](https://azure.github.io/azure-sdk/policies_support.html#package-lifecycle) になります。この日以降、プロジェクトと関連するクライアント ライブラリは完全に廃止されます。 。廃止の詳細と、このプロジェクトを使用するための代替案については、[廃止のお知らせ: 従来の Azure Storage Python クライアント ライブラリは 2024 年 9 月 13 日に廃止されます](https://azure.microsoft.com/updates/retirement-notice-) を参照してください。 the-legacy-azure-storage-python-client-libraries-will-be-retired-on-13-september-2024/)。
ニュース!! azure-storage-blob v12 は現在 GA です。
詳細については、https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage にアクセスしてください。
注: 現在のリポジトリは azure-storage-blob<=2.1.0 用であり、v12.0.0 にアップグレードすると現在のコードが破損する可能性があります。
このプロジェクトは、Microsoft Azure Storage サービスを簡単に利用できるようにする Python のクライアント ライブラリを提供します。ドキュメントについては、Microsoft Azure Python Developer Center および API リファレンス (readthedocs からも入手可能) を参照してください。
Service Bus または Azure Management ライブラリをお探しの場合は、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 より前のバージョンからアップグレードする場合は、アップグレードのドキュメント、サンプル ディレクトリ内の使用例、および ChangeLog と BreakingChanges を参照してください。
Azure Web Apps に Azure Storage をインストールする際に問題が発生した場合は、pip をアップグレードすると解決する可能性があります。
重要: azure-storage パッケージの以前のバージョン (バージョン <= 0.36.0) がある場合は、新しい分割パッケージをインストールする前にそれをアンインストールする必要があります。
pip を使用してバージョンを確認できます。
pip freeze
azure-storage==0.36.0 (または 0.36.0 未満のバージョン) が表示された場合は、まずそれをアンインストールします。
pip uninstall azure-storage
Azure Storage SDK for Python は 5 つのパッケージで構成されています。
注: バージョン 0.36.0 以前は、すべてのサービスを含む単一のパッケージ (azure-storage) がありました。これはサポートされなくなったため、ユーザーは必要に応じて前述の 3 つのサービス パッケージを個別にインストールする必要があります。さらに、テーブルパッケージは azure-storage 名前空間でリリースされなくなりました。cosmosdb を参照してください。
Python Package Index (PyPI) 経由でインストールするには、次のように入力します。
pip インストール azure-storage-blob pip インストール azure-storage-file pip インストール azure-storage-queue
git 経由で SDK のソース コードを取得するには、次のように入力するだけです。
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 に置き換えて、他のサービスをインストールします。
GitHub または PyPi 経由でコードの zip をダウンロードします。次に、オプション 2 と同じ手順に従います。
この SDK を使用して Microsoft Azure ストレージ サービスを呼び出すには、まずアカウントを作成する必要があります。
デバッグを容易にするために、「azure.storage」という名前のロガーのログ記録を有効にすることをお勧めします。以下に 2 つの構成例を示します。
# 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 を使用することをお勧めします。
BLOB、キュー、ファイル使用法のサンプルについては、サンプル ディレクトリを参照してください。
提供されたコードに問題がある場合は、MSDN の Microsoft Azure 開発者フォーラムまたは Stack Overflow の開発者フォーラムを必ずチェックしてください。
このプロジェクトへの積極的な貢献者になりたい場合は、Azure プロジェクトの貢献ガイドラインに記載されている手順に従ってください。貢献に関する詳細については、CONTRIBUTING.md ドキュメントを参照してください。
ライブラリにバグが発生した場合は、プロジェクトの「問題」セクションに問題を報告してください。