適用于Azure Functions概觀的 Azure Blob 儲存體系結

Azure Functions透過觸發程式和系結與Azure 儲存體整合。 與 Blob 儲存體整合可讓您建置函式,以回應 Blob 資料中的變更,以及讀取和寫入值。

動作 類型
以 Blob 儲存體資料變更身分執行函式 觸發程序
讀取函式中的 Blob 儲存體資料 輸入繫結
允許函式寫入 Blob 儲存體資料 輸出繫結

安裝擴充功能

您安裝的 NuGet 套件擴充取決於您在函數應用程式中使用的 C# 模式:

函式會在與 Azure Functions 主機相同的處理序中執行。 若要深入了解,請參閱使用 Azure Functions 開發 C# 類別庫函式

擴充的功能會根據擴充版本而有所不同:

此版本引進 了使用身分識別而非秘密進行連線的能力。 如需使用受控識別設定函式應用程式的教學課程,請參閱 使用身分識別型連線建立函式應用程式教學課程

此版本可讓您系結至來自 Azure.儲存體 的類型。Blob。 深入瞭解這些新類型與 不同, Microsoft.Azure.Storage 以及如何從 Azure.儲存體移轉至這些類型 WindowsAzure.Storage。Blob 移轉指南

此延伸模組可透過安裝Microsoft.Azure.WebJobs.Extensions.儲存體取得。Blob NuGet套件5.x 版。

使用 .NET CLI:

dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage.Blobs --version 5.0.0

注意

Blob 儲存體、佇列儲存體和資料表儲存體現在使用個別的延伸模組,並個別參考。 例如,若要針對 .NET 進程應用程式中的所有三個服務使用觸發程式和系結,您應該將下列套件新增至您的專案:

先前,延伸模組隨附為Microsoft.Azure.WebJobs.Extensions.儲存體 4.x 版。 這個相同的套件也有 5.x 版,其只會參考 Blob 和佇列的分割套件。 從舊版升級套件參考時,您可能需要另外參考新的Microsoft.Azure.WebJobs.Extensions.Tables NuGet套件。 此外,參考這些較新的分割套件時,請確定您未參考舊版的合併儲存體套件,因為這會導致相同系結的兩個定義發生衝突。

安裝搭售方案

Blob 儲存體系結是 擴充功能套件組合的一部分,其指定于 host.json 專案檔中。 您可能需要修改此套件組合來變更系結的版本,或尚未安裝套件組合。 若要深入了解,請參閱擴充搭售方案

此版本引進 了使用身分識別而非秘密進行連線的能力。 如需使用受控識別設定函式應用程式的教學課程,請參閱 使用身分識別型連線建立函式應用程式教學課程

您可以從擴充功能套件組合 v3 新增此版本的擴充功能,方法是在您的檔案中 host.json 新增或取代下列程式碼:

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[3.3.0, 4.0.0)"
    }
}

若要深入瞭解,請參閱 更新擴充功能

注意

延伸模組套件組合 3.x 版目前不包含資料表儲存體系結。 如果您的應用程式需要資料表儲存體,您現在必須繼續使用 2.x 版。

host.json 設定

本節說明適用于使用此系結之函式的函式應用程式組態設定。 這些設定僅適用于使用擴充功能 5.0.0 版和更新版本時。 下面的範例 host.json 檔案僅包含此繫結的 2.x+ 版本設定。 如需 2.x 版本和更新版本中函數應用程式組態設定的詳細資訊,請參閱 Azure Functions 的 host.json 參考

注意

本節不適用於 5.0.0 之前的擴充功能版本。 針對這些舊版,Blob 沒有任何函式全應用程式組態設定。

{
    "version": "2.0",
    "extensions": {
        "blobs": {
            "maxDegreeOfParallelism": 4
        }
    }
}
屬性 預設 描述
maxDegreeOfParallelism 8 * (可用核心數目) 每個 Blob 觸發函式允許的並行調用整數數目。 允許的最小值為 1。

後續步驟