使用 Functions 在 Azure 儲存體佇列中新增訊息

在 Azure Functions 中，輸入和輸出繫結會提供宣告式方法，以便從您的程式碼可用之外部服務製作資料。 在本快速入門中，您會使用輸出繫結，在函式由 HTTP 要求觸發時於佇列中建立訊息。 您可使用 Azure 儲存體容器來檢視函式建立的佇列訊息。

必要條件

若要完成本快速入門：

• Azure 訂用帳戶。 如果您沒有 Azure 訂用帳戶，請在開始前建立免費帳戶。

• 請遵循從 Azure 入口網站建立您的第一個函式中的指示，但是不要進行清除資源步驟。 該快速入門會建立您可以在這裡使用的函式應用程式和函式。

新增輸出繫結

在本節中，您會使用入口網站 UI 來將佇列儲存體輸出繫結新增至您稍早建立的函式。 這個繫結可供撰寫最少的程式碼，即可在佇列中建立訊息。 您不需要為以下工作撰寫程式碼，例如開啟儲存體連線、建立佇列，或取得佇列的參考。 Azure Functions 執行階段和佇列輸出繫結會為您進行這些工作。

1. 在 Azure 入口網站中，針對您在從 Azure 入口網站建立您的第一個函式中建立的函式應用程式，開啟函式應用程式分頁。 若要開啟此頁面，請搜尋並選取函數應用程式。 接著，選取函數應用程式。

2. 選取函數應用程式，然後選取在稍早的快速入門中所建立函式。

3. 選取 [整合]，然後選取 [+ 新增輸出]。

   

4. 選取 [Azure 佇列儲存體輸出] 繫結類型，然後新增此螢幕擷取畫面後續表格中所指定的設定：

   

   設定	建議的值	描述
   訊息參數名稱	outputQueueItem	輸出繫結參數的名稱。
   佇列名稱	outqueue	儲存體帳戶中的連線目標佇列名稱。
   儲存體帳戶連線	AzureWebJobsStorage	您可以使用應用程式函式已在使用的儲存體帳戶連線，或建立新的連線。

5. 選取 [確定] 來新增繫結。

您已定義了輸出繫結，接下來您需要將程式碼更新為使用繫結來對佇列新增訊息。

新增會使用輸出繫結的程式碼

在本節中，您會將撰寫訊息的程式碼新增至輸出佇列。 此訊息包含值，該值會傳遞至查詢字串中的 HTTP 觸發程序。 例如，如果查詢字串包含 name=Azure，則佇列訊息會是「Name passed to the function: Azure」。

1. 在函式中，選取 [編碼 + 測試] 以在編輯器中顯示函式程式碼。

2. 根據您的函式語言更新函式程式碼：

   C#

   將 outputQueueItem 參數新增至方法簽章，如下列範例所示。

   public static async Task<IActionResult> Run(HttpRequest req,
       ICollector<string> outputQueueItem, ILogger log)
   {
       ...
   }
   

   在 return 陳述式前面的函式所包含的本文中，新增使用參數的程式碼以建立佇列訊息。

   outputQueueItem.Add("Name passed to the function: " + name);
   

   JavaScript

   新增會使用 context.bindings 物件上之輸出繫結的程式碼以建立佇列訊息。

   context.bindings.outputQueueItem = "Name passed to the function: " + 
               (req.query.name || req.body.name);
   

3. 選取儲存以儲存變更。

測試函式

1. 儲存程式碼的變更後，選取 [測試]。

2. 確認測試符合下列影像，然後選取 [執行]。

   

   請注意，要求本文包含 name 值：Azure。 這個值會出現在叫用函式時建立的佇列訊息中。

   除了在這裡選取 [執行] 之外，您可以呼叫函式，方法是在瀏覽器中輸入 URL，並且在查詢字串中指定 name 值。 瀏覽器方法會顯示在先前的快速入門中。

3. 檢查記錄以確定函式已成功。

您第一次使用輸出繫結時，Functions 執行階段會在儲存體帳戶中建立名為 outqueue 的新佇列。 您將使用儲存體帳戶來確認已建立佇列以及其中的訊息。

尋找連線至 AzureWebJobsStorage 的儲存體帳戶

1. 移至函數應用程式，然後選取 [設定]。

2. 在 [應用程式設定] 下選取 [AzureWebJobsStorage]。

   

3. 找出並記下帳戶名稱。

   

檢查輸出佇列

1. 在函數應用程式的資源群組中，選取用於本快速入門的儲存體帳戶。

2. 在 [佇列服務] 下選取 [佇列]，然後選取名為 outqueue 的佇列。

   佇列包含訊息，該訊息將您執行 HTTP 觸發程序函式時建立的輸出繫結排入佇列。 如果您叫用具有預設 name 值為 Azure 的函式，佇列訊息是：Name passed to the function: Azure。

3. 再次執行函式，您會看到新的訊息出現在佇列中。

清除資源

此集合中的其他快速入門會以本快速入門為基礎。 如果您打算繼續進行後續的快速入門、教學課程或者您在本快速入門中建立的任何服務，請勿清除資源。

在 Azure 中「資源」是指函式應用程式、函式、儲存體帳戶等等。 其會分組為「資源群組」，您可以藉由刪除群組來刪除群組中的所有項目。

您已建立完成這些快速入門所需的資源。 您可能必須支付這些資源，取決於您的帳戶狀態和服務定價。 如果您不再需要資源，刪除方式如下：

1. 在 Azure 入口網站中，移至 [資源群組] 分頁。

   若要從函數應用程式頁面移至該頁面，選取 [概觀] 索引標籤，然後選取 [資源群組] 底下的連結。

   

   若要從儀表板移至該頁面，請選取 [資源群組]，然後選取您用於本文的資源群組。

2. 在 [資源群組] 分頁中，檢閱包含資源的清單，並確認這些是您想要刪除的項目。

3. 選取 [刪除資源群組]，並遵循指示。

   刪除作業可能需要幾分鐘。 完成時，通知會出現幾秒鐘的時間。 您也可以選取分頁頂端的鈴鐺圖示以檢視通知。

下一步

在本快速入門中，您將輸出繫結新增至現有函式。 如需佇列儲存體繫結的詳細資訊，請參閱 Azure Functions 儲存體佇列繫結。

• Azure Functions 觸發程序和繫結概念
  了解 Functions 與其他服務整合的方式。
• Azure Functions 開發人員參考
  提供更多有關 Functions 執行階段的技術資訊，以及可供撰寫函數程式碼及定義觸發程序和繫結時參考。
• 撰寫 Azure Functions 並在本機進行測試
  說明在本機開發函式的選項。