如何在Microsoft Azure Functions中將DocumentDB數據庫輸入綁定與服務總線觸發器綁定和BrokeredMessage一起使用？

Question

我正在編寫一個簡單的函數，當新消息進入服務總線隊列時將觸發該函數。 該功能的輸入是一個DocumentDB文檔。 我需要訪問文檔中的值並將其鍵入控制台日志中。

創建服務總線隊列觸發器綁定時，將自動按以下方式創建它：

public static void Run(string myQueueItem, TraceWriter log)
{
    log.Info($"C# ServiceBus queue trigger function processed message: {myQueueItem}");
}

現在，根據此頁面 ，可以訪問我數據庫中的正確文檔，可以設置綁定，以便從隊列消息中獲取文檔ID：

id支持類似於{queueTrigger}的綁定，該綁定使用隊列消息的字符串值作為文檔ID。

這意味着您可以將消息發送到隊列，然后像這樣綁定到您的文檔：

{
    "name": "inputDocument",
    "type": "documentDB",
    "databaseName": "MyDatabase",
    "collectionName": "MyCollection",
    "id" : "{myQueueItem}",//<<<
    "connection": "MyAccount_DOCUMENTDB",     
    "direction": "in"
}

到目前為止，一切似乎都按預期進行。 但是，為了將消息發送到服務總線隊列，您必須將其作為BrokeredMessage類型（ link ）發送。 並且當您這樣做時，您將無法再以字符串形式訪問消息，從而使自動創建的函數無效。

可以通過以下方式使用BrokeredMessages：

project.json：

{
    "frameworks": {
        "net46":{
            "dependencies": {
                "WindowsAzure.ServiceBus": "2.7.6"
            }
        }
    }
}

run.csx：

using Microsoft.ServiceBus.Messaging;
....
log.Info($"C# ID: {queueItem.GetBody<string>()})

但是我還無法找出如何將{queueItem.GetBody<string>()}傳遞到輸入文檔綁定的id屬性中。 因此，我不能再使用上述通過"id" : "{myQueueItem}"綁定documentdb輸入的方法，因此無法從任何文檔讀取任何值。

• 有沒有一種方法可以將原始字符串發送到總線隊列，或者BrokeredMessage確實是唯一的可能性？ （根據我的發現，不可能使用原始字符串）

• 如果BrokeredMessage確實是唯一的方法，是否仍然可以從消息中獲取字符串值並將其用作DocumentDB文檔的ID？

• 如果以上兩種方法均不可行，您能否以此為我指出正確的方向？

我的功能的更完整說明：

應用程序會定期將新文檔發送到DocumentDB數據庫中。 它與文檔一起（在等待插入完成之后）將一條帶有新文檔ID的消息發送到服務總線隊列中。 然后觸發器將連接到新文檔並檢查其中的整數值。 如果該值大於10，它將發送有關它的電子郵件通知。

我已經成功創建了該文件，並通過基於Web的編輯器手冊Run（使用其中一個文檔的字符串ID作為測試輸入）對其進行了測試。 但是，當我嘗試將其與自動發送文檔和消息的應用程序一起使用時，如上所述，我遇到了BrokeredMessage問題。

以下是不帶BrokeredMessage的wórking函數的完整代碼：

using System;
using System.Net;
using System.Net.Mail;

public static void Run(string queueItem, dynamic inputDocument, TraceWriter log)
{
    log.Info($"C# ID: {queueItem}, Value: {inputDocument.Value}");

    if (inputDocument.Value > 10)
    {
        var fromAddress = new MailAddress("---@gmail.com", "From ---");
        var toAddress = new MailAddress("---@gmail.com", "To ---");
        const string fromPassword = "---";
        const string subject = "Notification";
        const string body = "Temperature too high!";

        var smtp = new SmtpClient
        {
            Host = "smtp.gmail.com",
            Port = 587,
            EnableSsl = true,
            DeliveryMethod = SmtpDeliveryMethod.Network,
            UseDefaultCredentials = false,
            Credentials = new NetworkCredential(fromAddress.Address, fromPassword)
        };
        using (var message = new MailMessage(fromAddress, toAddress)
        {
            Subject = subject,
            Body = body
        })
        {
            smtp.Send(message);
        }
    }
}

Answer 1

這是一個工作示例，顯示了如何以POCO形式接收ServiceBus消息並綁定到其屬性。

如果您使用正確的application/json內容類型將消息發送到隊列，該函數將為您反序列化到POCO中，並且Document DB輸入綁定將綁定到DocumentId屬性並為您檢索文檔。 您無需在project.json中添加任何內容即可正常工作。

function.json文件：

{
  "bindings": [
    {
      "name": "input",
      "type": "serviceBusTrigger",
      "direction": "in",
      "queueName": "<your-queue.",
      "connection": "<your-connection>",
      "accessRights": "Manage"
    },
    {
      "type": "documentDB",
      "name": "document",
      "databaseName": "<your-db>",
      "collectionName": "<your-collection>",
      "id": "{DocumentId}",
      "connection": "<your-connection>",
      "direction": "in"
    }
  ]
}

功能代碼：

using System;
using System.Threading.Tasks;

public class Input
{
    public string DocumentId { get; set; }
    public int Value { get; set; }
}

public static void Run(Input input, dynamic document, TraceWriter log)
{
    log.Info($"Message received (DocumentId: {input.DocumentId}, Value {input.Value})");
    log.Info($"Document read {document.id}");
}

對於C＃函數，要使用綁定參數（例如{DocumentId}參數），必須將觸發器輸入綁定到定義這些屬性的POCO對象。

對於發送電子郵件，您還可以查看我們的SendGrid輸出綁定。 我們在門戶網站的“示例”下有完整的示例“ SendGrid-CSharp” :)