Självstudie: Ladda upp och analysera en fil med Azure Functions och Blob Storage

Artikel
07/27/2023

I den här självstudien får du lära dig hur du laddar upp en bild för att Azure Blob Storage och bearbeta den med hjälp av Azure Functions och Visuellt innehåll. Du får också lära dig hur du implementerar Azure Function-utlösare och bindningar som en del av den här processen. Tillsammans analyserar dessa tjänster en uppladdad bild som innehåller text, extraherar texten ur den och lagrar sedan texten på en databasrad för senare analys eller andra syften.

Azure Blob Storage är Microsofts enormt skalbara objektlagringslösning för molnet. Blob Storage är utformat för att lagra bilder och dokument, strömma mediefiler, hantera säkerhetskopierings- och arkivdata och mycket mer. Du kan läsa mer om Blob Storage på översiktssidan.

Azure Functions är en serverlös datorlösning som gör att du kan skriva och köra små kodblock som mycket skalbara, serverlösa, händelsedrivna funktioner. Du kan läsa mer om Azure Functions på översiktssidan.

I den här självstudien får du lära dig hur man:

Ladda upp bilder och filer till Blob Storage
Använda en Azure-funktionshändelseutlösare för att bearbeta data som laddats upp till Blob Storage
Använda Azure AI-tjänster för att analysera en bild
Skriva data till Table Storage med azure-funktionsutdatabindningar

Förutsättningar

Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
Visual Studio 2022 installerat.

Skapa lagringskontot och containern

Det första steget är att skapa lagringskontot som ska innehålla de uppladdade blobdata, som i det här scenariot blir bilder som innehåller text. Ett lagringskonto erbjuder flera olika tjänster, men i den här självstudien används Blob Storage och Table Storage.

Azure-portalen
Azure CLI

Logga in på Azure-portalen.

I sökfältet överst i portalen söker du efter Lagring och väljer resultatet med etiketten Lagringskonton.
På sidan Lagringskonton väljer du + Skapa längst upp till vänster.
På sidan Skapa ett lagringskonto anger du följande värden:
- Prenumeration: Välj önskad prenumeration.
- Resursgrupp: Välj Skapa ny och ange ett namn på msdocs-storage-functionoch välj sedan OK.
- Lagringskontonamn: Ange värdet msdocsstoragefunction. Lagringskontonamnet måste vara unikt i Azure, så du kan behöva lägga till siffror efter namnet, till exempel msdocsstoragefunction123.
- Region: Välj den region som är närmast dig.
- Prestanda: Välj Standard.
- Redundans: Låt standardvärdet vara markerat.
Välj Granska + Skapa längst ned så validerar Azure den information som du angav. När inställningarna har verifierats väljer du Skapa så börjar Azure etablera lagringskontot, vilket kan ta en stund.

Skapa containern

När lagringskontot har etablerats väljer du Gå till Resurs. Nästa steg är att skapa en lagringscontainer inuti kontot för att lagra uppladdade bilder för analys.
I navigeringspanelen väljer du Containrar.
På sidan Containrar väljer du + Container överst. I den utskjutande panelen anger du ett Namn på imageanalysis och kontrollerar att den offentliga åtkomstnivån är inställd på Blob (endast anonym läsåtkomst för blobar). Välj sedan Skapa.

Du bör se att den nya containern visas i listan över containrar.

Hämta anslutningssträngen

Det sista steget är att hämta vår anslutningssträng för lagringskontot.

I den vänstra navigeringspanelen väljer du Åtkomstnycklar.
På sidan Åtkomstnycklar väljer du Visa nycklar. Kopiera värdet för anslutningssträngen under avsnittet key1 och klistra in det här någonstans att använda för senare. Du vill också anteckna lagringskontots namn msdocsstoragefunction för senare.

Dessa värden är nödvändiga när vi behöver ansluta vår Azure-funktion till det här lagringskontot.

Azure CLI-kommandon kan köras i Azure Cloud Shell eller på en arbetsstation med Azure CLI installerat.

För att skapa lagringskontot och containern kan vi köra CLI-kommandona som visas nedan.

az group create --location eastus --name msdocs-storage-function \

az storage account create --name msdocsstorageaccount --resource-group msdocs-storage-function -l eastus --sku Standard_LRS \

az storage container create --name imageanalysis --account-name msdocsstorageaccount --resource-group msdocs-storage-function

Du kan behöva vänta en stund tills Azure etablerar dessa resurser.

När kommandona har slutförts måste vi också hämta anslutningssträngen för lagringskontot. Anslutningssträngen används senare för att ansluta vår Azure-funktion till lagringskontot.

az storage account show-connection-string -g msdocs-storage-function -n msdocsstorageaccount

Kopiera värdet för connectionString egenskapen och klistra in den någonstans att använda för senare. Du vill också anteckna lagringskontots namn msdocsstoragefunction för senare.

Skapa Visuellt innehåll-tjänsten

Skapa sedan det Visuellt innehåll tjänstkonto som ska bearbeta våra uppladdade filer. Visuellt innehåll ingår i Azure AI-tjänster och erbjuder en mängd olika funktioner för att extrahera data från bilder. Du kan läsa mer om Visuellt innehåll på översiktssidan.

Azure-portalen
Azure CLI

I sökfältet överst i portalen söker du efter Dator och väljer resultatet visuellt innehåll.
På sidan Visuellt innehåll väljer du + Skapa.
På sidan Skapa Visuellt innehåll anger du följande värden:
- Prenumeration: Välj önskad prenumeration.
- Resursgrupp: Använd den msdocs-storage-function resursgrupp som du skapade tidigare.
- Region: Välj den region som är närmast dig.
- Namn: Ange i namnet msdocscomputervision.
- Prisnivå: Välj Kostnadsfri om den är tillgänglig, annars väljer du Standard S1.
- Markera rutan Ansvarig AI-meddelande om du godkänner villkoren
Välj Granska + Skapa längst ned. Det tar en stund för Azure att verifiera den information som du angav. När inställningarna har verifierats väljer du Skapa så börjar Azure etablera Visuellt innehåll-tjänsten, vilket kan ta en stund.
När åtgärden har slutförts väljer du Gå till Resurs.

Hämta nycklarna

Därefter måste vi hitta den hemliga nyckeln och slutpunkts-URL:en för Visuellt innehåll-tjänsten som ska användas i vår Azure-funktionsapp.

På Visuellt innehåll översiktssida väljer du Nycklar och slutpunkt.
På sidan Nycklar och Slutpunkt kopierar du värdet Key 1 och EndPoint-värdena och klistrar in dem någonstans att använda för senare.

För att skapa Visuellt innehåll-tjänsten kan vi köra CLI-kommandot nedan.

az cognitiveservices account create \
    --name msdocs-process-image \
    --resource-group msdocs-storage-function \
    --kind ComputerVision \
    --sku F1 \
    --location eastus2 \
    --yes

Du kan behöva vänta en stund tills Azure etablerar dessa resurser.

När Visuellt innehåll-tjänsten har skapats kan du hämta de hemliga nycklarna och URL-slutpunkten med hjälp av kommandona nedan.

az cognitiveservices account keys list \
    --name msdocs-process-image \
    --resource-group msdocs-storage-function  \ 
    
az cognitiveservices account list \
--name msdocs-process-image \
    --resource-group msdocs-storage-function --query "[].properties.endpoint"

Ladda ned och konfigurera exempelprojektet

Koden för Azure-funktionen som används i den här självstudien finns på den här GitHub-lagringsplatsen. Du kan också klona projektet med hjälp av kommandot nedan.

git clone https://github.com/Azure-Samples/msdocs-storage-bind-function-service.git \
cd msdocs-storage-bind-function-service/dotnet

Exempelprojektkoden utför följande uppgifter:

Hämtar miljövariabler för att ansluta till lagringskontot och Visuellt innehåll-tjänsten
Accepterar den uppladdade filen som en blobparameter
Analyserar bloben med hjälp av Visuellt innehåll-tjänsten
Skickar den analyserade bildtexten till en ny tabellrad med hjälp av utdatabindningar

När du har laddat ned och öppnat projektet finns det några viktiga begrepp att förstå i huvudmetoden Run som visas nedan. Azure-funktionen använder bindningar för utlösare och utdata, som tillämpas med hjälp av attribut för metodsignaturen Run .

Attributet Table använder två parametrar. Den första parametern anger namnet på tabellen för att skriva det tolkade bildtextvärdet som returneras av funktionen. Den andra Connection parametern hämtar en anslutningssträng för Table Storage från miljövariablerna så att vår Azure-funktion har åtkomst till den.

Attributet BlobTrigger används för att binda vår funktion till uppladdningshändelsen i Blob Storage och tillhandahåller den uppladdade bloben Run till funktionen. Blobutlösaren har två egna parametrar – en för namnet på blobcontainern som ska övervakas för uppladdningar och en för anslutningssträngen för vårt lagringskonto igen.

// Azure Function name and output Binding to Table Storage
[FunctionName("ProcessImageUpload")]
[return: Table("ImageText", Connection = "StorageConnection")]
// Trigger binding runs when an image is uploaded to the blob container below
public async Task<ImageContent> Run([BlobTrigger("imageanalysis/{name}", 
        Connection = "StorageConnection")]Stream myBlob, string name, ILogger log)
{
    // Get connection configurations
    string subscriptionKey = Environment.GetEnvironmentVariable("ComputerVisionKey");
    string endpoint = Environment.GetEnvironmentVariable("ComputerVisionEndpoint");
    string imgUrl = $"https://{ Environment.GetEnvironmentVariable("StorageAccountName")}
                        .blob.core.windows.net/imageanalysis/{name}";

    ComputerVisionClient client = new ComputerVisionClient(
        new ApiKeyServiceClientCredentials(subscriptionKey)) { Endpoint = endpoint };

    // Get the analyzed image contents
    var textContext = await AnalyzeImageContent(client, imgUrl);

    return new ImageContent { 
        PartitionKey = "Images",
        RowKey = Guid.NewGuid().ToString(), Text = textContext 
    };
}

public class ImageContent
{
    public string PartitionKey { get; set; }
    public string RowKey { get; set; }
    public string Text { get; set; }
}

Den här koden hämtar även viktiga konfigurationsvärden från miljövariabler, till exempel anslutningssträngen för lagringskontot och Visuellt innehåll nyckeln. Vi lägger till dessa miljövariabler i vår Azure-funktionsmiljö när den har distribuerats.

Funktionen ProcessImage använder också en andra metod med namnet AnalyzeImage, som visas nedan. Den här koden använder URL-slutpunkten och nyckeln för vårt Visuellt innehåll-konto för att skicka en begäran till servern om att bearbeta avbildningen. Begäran returnerar all text som identifieras i bilden, som sedan skrivs till Table Storage med hjälp av utdatabindningen för Run metoden.

static async Task<string> ReadFileUrl(ComputerVisionClient client, string urlFile)
{
    // Analyze the file using Computer Vision Client
    var textHeaders = await client.ReadAsync(urlFile);
    string operationLocation = textHeaders.OperationLocation;
    Thread.Sleep(2000);
    
    // Complete code omitted for brevity, view in sample project
    
    return text.ToString();
}

Körs lokalt

Om du vill köra projektet lokalt kan du fylla i miljövariablerna med hjälp av filen local.settings.json. I den här filen fyller du i platshållarvärdena med de värden som du sparade tidigare när du skapade Azure-resurserna.

Även om Azure-funktionskoden körs lokalt ansluter den fortfarande till livetjänsterna i Azure i stället för att använda några lokala emulatorer.

{
    "IsEncrypted": false,
    "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true",
      "FUNCTIONS_WORKER_RUNTIME": "dotnet",
      "StorageConnection": "your-storage-account-connection-string",
      "StorageAccountName": "your-storage-account-name",
      "ComputerVisionKey": "your-computer-vision-key",
      "ComputerVisionEndPoint":  "your-computer-vision-endpoint"
    }
}

Distribuera koden till Azure Functions

Nu är du redo att distribuera vårt program till Azure med hjälp av Visual Studio. Du kan också skapa Azure Functions-appen i Azure samtidigt som du ingår i distributionsprocessen.

Börja genom att välja projektnoden ProcessImage och sedan Publicera.
På dialogrutan Publicera väljer du Azure och sedan Nästa.
Välj Azure Function App (Windows) eller Azure Function App (Linux) på nästa skärm och välj sedan Nästa igen.
I steget Functions-instans ser du till att välja den prenumeration som du vill distribuera till. Välj sedan den gröna + symbolen till höger i dialogrutan.
En ny dialogruta öppnas. Ange följande värden för din nya funktionsapp.
- Namn: Ange msdocsprocessimage eller något liknande.
- Prenumerationsnamn: Välj vilken prenumeration du vill använda.
- Resursgrupp: Välj den msdocs-storage-function resursgrupp som du skapade tidigare.
- Plantyp: Välj Förbrukning.
- Plats: Välj den region som är närmast dig.
- Azure Storage: Välj det lagringskonto som du skapade tidigare.
När du har fyllt i alla dessa värden väljer du Skapa. Visual Studio och Azure börjar etablera de begärda resurserna, vilket tar en stund att slutföra.
När processen är klar väljer du Slutför för att stänga dialogarbetsflödet.
Det sista steget för att distribuera Azure-funktionen är att välja Publicera längst upp till höger på skärmen. Det kan också ta en stund att publicera funktionen. När programmet är klart körs det på Azure.

Ansluta tjänsterna

Azure-funktionen har distribuerats, men den kan inte ansluta till vårt lagringskonto och Visuellt innehåll tjänster ännu. Rätt nycklar och anslutningssträngar måste först läggas till i konfigurationsinställningarna för Azure Functions-appen.

Längst upp i Azure Portal söker du efter funktionen och väljer Funktionsapp i resultatet.
På skärmen Funktionsapp väljer du den funktionsapp som du skapade i Visual Studio.
På översiktssidan för funktionsappen väljer du Konfiguration i det vänstra navigeringsfältet. Då öppnas en sida där vi kan hantera olika typer av konfigurationsinställningar för vår app. För tillfället är vi intresserade av avsnittet Programinställningar .
Nästa steg är att lägga till inställningar för lagringskontots namn och anslutningssträng, den Visuellt innehåll hemliga nyckeln och Visuellt innehåll slutpunkten.
På fliken Programinställningar väljer du + Ny programinställning. I den utfällbara menyn som visas anger du följande värden:
- Namn: Ange värdet ComputerVisionKey.
- Värde: Klistra in den Visuellt innehåll nyckel som du sparade från tidigare.
Klicka på OK för att lägga till den här inställningen i din app.
Nu ska vi upprepa den här processen för slutpunkten för vår Visuellt innehåll-tjänst med hjälp av följande värden:
- Namn: Ange ett värde för ComputerVisionEndpoint.
- Värde: Klistra in slutpunkts-URL:en som du sparade från tidigare.
Upprepa det här steget igen för anslutningen till lagringskontot med hjälp av följande värden:
- Namn: Ange värdet StorageConnection.
- Värde: Klistra in anslutningssträngen som du sparade från tidigare.
Upprepa slutligen den här processen en gång till för lagringskontots namn med hjälp av följande värden:
- Namn: Ange värdet StorageAccountName.
- Värde: Ange namnet på lagringskontot som du skapade.
När du har lagt till de här programinställningarna måste du välja Spara överst på konfigurationssidan. När sparande har slutförts kan du även trycka på Uppdatera för att se till att inställningarna hämtas.

Alla nödvändiga miljövariabler för att ansluta vår Azure-funktion till olika tjänster finns nu på plats.

Ladda upp en avbildning till Blob Storage

Nu är du redo att testa vårt program! Du kan ladda upp en blob till containern och sedan kontrollera att texten i bilden har sparats i Table Storage.

Leta först upp Lagring överst i Azure Portal och välj lagringskonto. På sidan lagringskonto väljer du det konto som du skapade tidigare.
Välj sedan Containrar i det vänstra navigeringsfältet och navigera sedan till containern ImageAnalysis som du skapade tidigare. Härifrån kan du ladda upp en testbild direkt i webbläsaren.
Du hittar några exempelbilder som ingår i avbildningsmappen i roten för det nedladdningsbara exempelprojektet, eller så kan du använda en egen.
Längst upp på sidan ImageAnalysis väljer du Ladda upp. I den utfällbara menyn som öppnas väljer du mappikonen till höger för att öppna en filwebbläsare. Välj den bild som du vill ladda upp och välj sedan Ladda upp.
Filen ska visas i blobcontainern. Sedan kan du kontrollera att uppladdningen utlöste Azure-funktionen och att texten i bilden har analyserats och sparats i Table Storage korrekt.
Med hjälp av sökvägarna överst på sidan navigerar du upp en nivå i ditt lagringskonto. Leta upp och välj Lagringswebbläsaren i det vänstra navigeringsfältet och välj sedan Tabeller.
En ImageText-tabell bör nu vara tillgänglig. Klicka på tabellen för att förhandsgranska dataraderna i den. Du bör se en post för den bearbetade bildtexten i vår uppladdning. Du kan kontrollera detta med hjälp av tidsstämpeln eller genom att visa innehållet i kolumnen Text .

Grattis! Du lyckades bearbeta en avbildning som laddades upp till Blob Storage med hjälp av Azure Functions och Visuellt innehåll.

Rensa resurser

Om du inte kommer att fortsätta att använda det här programmet kan du ta bort de resurser som du skapade genom att ta bort resursgruppen.

Välj Resursgrupper i huvudnavigering
msdocs-storage-function Välj resursgruppen i listan.
Välj knappen Ta bort resursgrupp överst på översiktssidan för resursgruppen.
Ange resursgruppens namn msdocs-storage-function i bekräftelsedialogrutan.
Välj ta bort. Det kan ta några minuter att ta bort resursgruppen.

Dela via