技能 Azure Storage File Share SDK for Python
📦

Azure Storage File Share SDK for Python

安全 🔑 環境變數

使用 Python SDK 管理 Azure 檔案共用

使用 Azure 儲存體檔案共用需要了解複雜的 SDK 模式和驗證方法。本技能提供所有常見檔案共用作業的現成可用程式碼範例。

支援: Claude Codex Code(CC)
🥉 72 青銅
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「Azure Storage File Share SDK for Python」。 將本機組態檔上傳至 Azure 檔案共用

預期結果:

顯示 ShareServiceClient 初始化、檔案用戶端擷取，以及具備適當錯誤處理的 upload_file() 方法的程式碼範例

正在使用「Azure Storage File Share SDK for Python」。 列出目錄中的所有檔案及其大小

預期結果:

使用 list_directories_and_files() 逐一查看目錄內容，區分檔案和子目錄，並顯示中繼資料

安全審計

安全
v1 • 2/25/2026

This skill is a documentation guide for Azure Storage File Share SDK for Python. Static analysis scanned 0 files with 0 risk patterns detected. The skill uses standard Azure SDK patterns with proper credential handling via environment variables and DefaultAzureCredential. No malicious patterns, command injection risks, or prompt injection attempts were found.

0
已掃描檔案
0
分析行數
1
發現項
1
審計總數

風險因素

🔑 環境變數 (1)
SKILL.md:22-26
審計者: claude

品質評分

38
架構
100
可維護性
87
內容
50
社群
100
安全
74
規範符合性

你能建構什麼

雲端原生應用程式儲存體

建立從 Azure 檔案共用儲存和擷取檔案的應用程式，並提供完整的 SDK 支援上傳、下載和管理作業。

傳統應用程式遷移

使用 Python SDK 模式實作雲端相容的檔案作業，將內部部署 SMB 檔案共用工作負載遷移至 Azure。

自動化備份工作流程

使用共用快照和程式化檔案管理建立自動化備份解決方案，以保護資料。

試試這些提示

基本檔案上傳 
示範如何使用連接字串驗證將文字檔案上傳至 Azure 檔案共用。
列出共用和檔案 
列出我儲存體帳戶中的所有檔案共用，然後列出特定共用目錄中的檔案。
Entra ID 驗證設定 
協助我設定使用 DefaultAzureCredential 的 Azure 檔案共用存取，以進行生產環境使用。
大型檔案串流 
我需要從 Azure 檔案共用下載大型檔案，而不將其完全載入記憶體。示範使用區塊處理的串流方法。

最佳實務

  • 使用環境變數儲存連接字串和帳戶 URL，以將認證保持在原始程式碼之外
  • 生產工作負載建議使用搭配 DefaultAzureCredential 的 Entra ID 驗證，而非連接字串
  • 使用區塊下載串流大型檔案，以避免檔案大小超過可用 RAM 時發生記憶體問題

避免

  • 將連接字串或帳戶金鑰直接寫入原始程式碼
  • 將整個大型檔案載入記憶體，而非使用串流下載
  • 未明確關閉非同步用戶端，這可能導致資源洩漏

常見問題

如何驗證 Azure 儲存體的檔案共用作業？
請使用連接字串（開發最簡單）或搭配 DefaultAzureCredential 的 Entra ID（生產環境建議使用）。連接字串透過 AZURE_STORAGE_CONNECTION_STRING 環境變數設定，而 Entra ID 使用 AZURE_STORAGE_ACCOUNT_URL。
我可以上傳至 Azure 檔案共用的最大檔案大小為何？
Azure 檔案共用支援進階帳戶最多 100 TiB 的檔案，標準帳戶最多 1 TiB。大型檔案請使用搭配範圍作業的串流上傳，以區塊方式上傳。
如何建立檔案共用的時間點備份？
使用 ShareClient 上的 create_snapshot() 方法建立唯讀快照。然後您可以使用設定為快照時間戳記的 snapshot 參數，透過 get_share_client() 存取快照。
我可以在 Azure 儲存體模擬器或 Azurite 中使用此技能嗎？
是的，您可以使用 Azurite 或傳統模擬器的模擬器連接字串格式（UseDevelopmentStorage=true）。這允許在沒有 Azure 訂用帳戶的情況下進行本機開發。
檔案作業失敗時如何處理錯誤？
Azure SDK 會從 azure.core.exceptions 模組擲出例外狀況。將作業包裝在 try-except 區塊中，並處理特定的例外狀況，例如 ResourceNotFoundError、ResourceExistsError 和 HttpResponseError。
所有檔案共用作業都支援非同步嗎？
是的，azure.storage.fileshare.aio 模組提供所有用戶端的非同步版本。在高輸送量情境中使用非模式下模式，並記得使用 await close() 明確關閉非同步用戶端。

開發者詳情

作者

sickn33

授權

MIT

儲存庫

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-storage-file-share-py

引用

main

檔案結構

📄 SKILL.md