Lägga till meddelanden i en Azure Storage-kö med Functions

  • Artikel

I Azure Functions kan du använda indata- och utdatabindningar för att skapa data från externa tjänster som är tillgängliga för din kod. I den här snabbstarten använder du en utdatabindning för att skapa ett meddelande i en kö när en funktion utlöses av en HTTP-begäran. Du använder Azure Storage-containern för att visa de kömeddelanden som din funktion skapar.

Förutsättningar

För att slutföra den här snabbstarten behöver du:

Lägg till en utdatabindning

I det här avsnittet använder du portalens användargränssnitt för att lägga till en Queue Storage-utdatabindning till funktionen som du skapade tidigare. Den här bindningen gör det möjligt att skriva minimal kod för att skapa ett meddelande i en kö. Du behöver inte skriva kod för uppgifter som till exempel att öppna en lagringsanslutning, skapa en kö eller lägga till en referens i en kö. Azure Functions-körningen och utdatabindningen tar hand om de här aktiviteterna åt dig.

  1. Öppna sidan för funktionsappen som du skapade i Skapa din första funktion i Azure Portal på sidan för funktionsappar i Azure Portal. Om du vill öppna sidan söker du efter och väljer Funktionsapp. Välj sedan funktionsappen.

  2. Välj din funktionsapp och välj sedan den funktion som du skapade i den tidigare snabbstarten.

  3. Välj Integrering och sedan + Lägg till utdata.

    Skapa en utdatabindning för funktionen.

  4. Välj bindningstypen Azure Queue Storage och lägg till inställningarna som anges i tabellen som följer den här skärmbilden:

    Lägg till en Queue Storage-utdatabindning i en funktion på Azure Portal.

    Inställning Föreslaget värde Beskrivning
    Meddelandeparameternamn outputQueueItem Namnet på utdatabindningsparametern.
    Könamn utkö Namnet på kön som ska anslutas till i ditt Storage-konto.
    Lagringskontoanslutning AzureWebJobsStorage Du kan antingen använda den lagringskontoanslutning som redan används i funktionsappen eller skapa en ny.

  5. Välj OK för att lägga till bindningen.

Nu när du har definierat en utdatabindning måste du uppdatera koden så att bindningen används när meddelanden läggs till i en kö.

Lägg till kod som använder utdatabindning

I det här avsnittet lägger du till kod som skriver ett meddelande till utdatakön. Meddelandet innehåller värdet som skickades till HTTP-utlösaren i frågesträngen. Om frågesträngen till exempel innehåller name=Azure så är kömeddelandet Name passed to the function: Azure (Namn som skickats till funktionen: Azure).

  1. I funktionen väljer du Kod + Test för att visa funktionskoden i redigeraren.

  2. Uppdatera funktionskoden beroende på ditt funktionsspråk:

    Lägg till en outputQueueItem-parameter till metodsignaturen som visas i följande exempel.

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

    I meddelandetexten för funktionen precis före return-instruktionen lägger du till kod som använder parametern för att skapa ett kömeddelande.

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

  3. Välj Spara för att spara ändringarna.

Testa funktionen

  1. När kodändringarna har sparats väljer du Testa.

  2. Kontrollera att testet matchar bilden nedan och välj Kör.

    Testa kölagringsbindningen i Azure Portal.

    Observera att Begärandetexten innehåller värdet nameAzure. Värdet visas i kömeddelandet som skapas när funktionen anropas.

    Som ett alternativ till att välja Kör här kan du anropa funktionen genom att ange en URL i en webbläsare och ange värdet name i frågesträngen. Webbläsarmetoden visas i den tidigare snabbstarten.

  3. Kontrollera i loggarna att funktionen har slutförts utan fel.

En ny kö med namnet outqueue skapas i ditt lagringskonto av funktionskörningen när utdatabindningen används för första gången. Du använder lagringskontot för att kontrollera att kön och ett meddelande i den har skapats.

Hitta lagringskontot som är anslutet till AzureWebJobsStorage

  1. Gå till funktionsappen och välj Konfiguration.

  2. Under Programinställningar väljer du AzureWebJobsStorage.

    Skärmbild som visar sidan Konfiguration med AzureWebJobsStorage valt.

  3. Leta upp och anteckna kontonamnet.

    Leta upp lagringskontot som är anslutet till AzureWebJobsStorage.

Granska utdatakö

  1. I resursgruppen för funktionsappen väljer du det lagringskonto som du använder för den här snabbstarten.

  2. Under Kötjänst väljer du Köer och väljer kön med namnet outqueue.

    Kön innehåller meddelandet som köutdatabindningen skapade när du körde den HTTP-utlösta funktionen. Om du startade en funktion med standardvärdet name för Azure så är kömeddelandet Name passed to the function: Azure (Namn som skickats till funktionen: Azure).

  3. Kör funktionen igen så ser du ett nytt meddelande i kön.

Rensa resurser

De andra snabbstarterna i den här samlingen bygger på den här snabbstarten. Om du planerar att arbeta med efterföljande snabbstarter, självstudier eller med någon av de tjänster som du har skapat i den här snabbstarten ska du inte rensa resurserna.

Resurser i Azure avser funktionsappar, funktioner, lagringskonton och så vidare. De är grupperade i resursgrupper och du kan ta bort allt i en grupp genom att ta bort gruppen.

Du har skapat resurser för att slutföra dessa snabbstarter. Du kan debiteras för dessa resurser, beroende på kontostatus och tjänstpriser. Om du inte behöver resurserna längre så visar vi hur du tar bort dem här:

  1. Gå till sidan Resursgrupp i Azure Portal.

    Om du vill komma till sidan från funktionsappsidan väljer du fliken Översikt och väljer sedan länken under Resursgrupp.

    Skärmbild som visar hur du väljer den resursgrupp som ska tas bort från funktionsappsidan.

    Om du vill komma till sidan från instrumentpanelen väljer du Resursgrupper och sedan den resursgrupp som du använde för den här artikeln.

  2. På sidan Resursgrupp granskar du listan över inkluderade resurser och kontrollerar att det är de som du vill ta bort.

  3. Välj Ta bort resursgrupp och följ anvisningarna.

    Borttagningen kan ta några minuter. När du är färdig visas ett meddelande i några sekunder. Du kan även välja klockikonen längst upp på sidan för att se meddelandet.

Nästa steg

I den här snabbstarten lade du till en utdatabindning i en befintlig funktion. Mer information om bindning till Queue Storage finns i Azure Functions Storage queue bindings (Azure Functions-lagringsköbindningar).