適用於 Python 的 Microsoft Azure 儲存體 SDK(已棄用)
該專案將在[社區支持](https://azure.github.io/azure-sdk/policies_support.html#package-lifecycle) 中持續到2024 年9 月13 日。的客戶端庫將永久停用。有關停用和使用此項目的替代方案的更多詳細信息,請訪問[停用通知:舊版Azure 存儲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 現已正式發布!
請造訪 https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage 以了解更多資訊。
注意:目前儲存庫適用於 azure-storage-blob<=2.1.0,升級到 v12.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 之前的版本升級,請參閱升級文件、範例目錄中的使用範例以及 ChangeLog 和 BreakingChanges。
如果在 Azure Web Apps 上安裝 Azure 儲存體時遇到問題,升級 pip 可能會有所幫助。
重要提示:如果您有早期版本的 azure-storage 軟體包(版本 <= 0.36.0),則應在安裝新的分割軟體包之前將其卸載。
您可以使用 pip 檢查版本:
pip freeze
如果您看到 azure-storage==0.36.0(或任何低於 0.36.0 的版本),請先解除安裝它:
pip uninstall azure-storage
適用於 Python 的 Azure 儲存體 SDK 由 5 個套件組成:
注意:在 0.36.0 版本之前(包括版本 0.36.0),曾經有一個包含所有服務的單一套件(azure-storage)。不再支持,用戶應根據需要單獨安裝上述3個服務包。另外,表包不再在azure-storage命名空間下發布,請參考cosmosdb。
若要透過 Python 套件索引 (PyPI) 安裝,請鍵入:
pip 安裝 azure-storage-blob pip 安裝 azure 儲存文件 pip 安裝 azure 儲存佇列
要透過 git 取得 SDK 的原始碼,只需輸入:
git 克隆 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」的記錄器開啟日誌記錄。以下是兩個範例配置:
# 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 文件中找到有關貢獻的更多詳細資訊。
如果您遇到該程式庫的任何錯誤,請在專案的問題部分提出問題。