Anslut Azure Functions att Azure Storage med Visual Studio Code

• Installera .NET Core CLI verktyg.

• Slutför stegen i del 1 av Visual Studio Code-snabbstarten.

• Slutför stegen i del 1 av Visual Studio Code-snabbstarten.

• Slutför stegen i del 1 av Visual Studio Code-snabbstarten.

• Slutför stegen i del 1 av Visual Studio Code-snabbstarten.

• Slutför stegen i del 1 av Visual Studio Code-snabbstarten.

• Slutför stegen i del 1 av Visual Studio Code-snabbstarten.

Projektet har konfigurerats för att använda tilläggspaketet, som automatiskt installerar en fördefinierad uppsättning tilläggspaket.

Användning av tilläggspaketet är aktiverat i filen host.json i projektroten, som visas på följande sätt:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[1.*, 2.0.0)"
  } 
}

Binding-attribut definieras direkt i function.jsi filen. Beroende på bindnings typen kan ytterligare egenskaper krävas. I kös Ekö konfigurationen beskrivs de fält som krävs för en Azure Storage Queue-bindning. Tillägget gör det enkelt att lägga till bindningar till function.jsi filen.

Om du vill skapa en bindning högerklickar du på (Ctrl + klicka på macOS) function.json filen i mappen HttpTrigger och väljer Lägg till bindning.... Följ anvisningarna för att definiera följande bindnings egenskaper för den nya bindningen:

En bindning läggs till bindings i matrisen i function.jspå, vilket bör se ut så här:

{
  "type": "queue",
  "direction": "out",
  "name": "msg",
  "queueName": "outqueue",
  "connection": "AzureWebJobsStorage"
}

I ett C#-projekt definieras bindningarna som bindningsattribut för funktionsmetoden. Specifika definitioner beror på om din app körs i processen (C#-klassbiblioteket) eller i en isolerad process.

[Queue("outqueue"),StorageAccount("AzureWebJobsStorage")] ICollector<string> msg,

[FunctionName("HttpExample")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req, 
    [Queue("outqueue"),StorageAccount("AzureWebJobsStorage")] ICollector<string> msg, 
    ILogger log)

public class MultiResponse
{
    [QueueOutput("outqueue",Connection = "AzureWebJobsStorage")]
    public string[] Messages { get; set; }
    public HttpResponseData HttpResponse { get; set; }
}

I ett Java-projekt definieras bindningarna som bindnings anteckningar i funktions metoden. function.js filen skapas sedan automatiskt baserat på dessa anteckningar.

Bläddra till platsen för funktions koden under src/main/Java, öppna filen Function. java -projekt och Lägg till följande parameter i run metod definitionen:

@QueueOutput(name = "msg", queueName = "outqueue", 
connection = "AzureWebJobsStorage") OutputBinding<String> msg,

msgParametern är en OutputBinding<T> typ som representerar en samling strängar som skrivs som meddelanden till en utgående bindning när funktionen slutförs. I det här fallet är utdata en lagrings kö med namnet outqueue . Anslutnings strängen för lagrings kontot anges av- connection metoden. I stället för själva anslutnings strängen skickar du den program inställning som innehåller anslutnings strängen för lagrings kontot.

runMetod definitionen bör nu se ut som i följande exempel:

@FunctionName("HttpExample")
public HttpResponseMessage run(
        @HttpTrigger(name = "req", methods = {HttpMethod.GET, HttpMethod.POST}, authLevel = AuthorizationLevel.ANONYMOUS) 
        HttpRequestMessage<Optional<String>> request, 
        @QueueOutput(name = "msg", queueName = "outqueue", 
        connection = "AzureWebJobsStorage") OutputBinding<String> msg, 
        final ExecutionContext context) {

Lägg till kod som använder msg objektet utgående bindning på context.bindings för att skapa ett köat meddelande. Lägg till den här koden före context.res instruktionen.

// Add a message to the Storage queue,
// which is the name passed to the function.
context.bindings.msg = (req.query.name || req.body.name);

I det här läget bör din funktion se ut så här:

module.exports = async function (context, req) {
    context.log('JavaScript HTTP trigger function processed a request.');

    if (req.query.name || (req.body && req.body.name)) {
        // Add a message to the Storage queue,
        // which is the name passed to the function.
        context.bindings.msg = (req.query.name || req.body.name);
        context.res = {
            // status: 200, /* Defaults to 200 */
            body: "Hello " + (req.query.name || req.body.name)
        };
    }
    else {
        context.res = {
            status: 400,
            body: "Please pass a name on the query string or in the request body"
        };
    }
};

Lägg till kod som använder msg objektet utgående bindning på context.bindings för att skapa ett köat meddelande. Lägg till den här koden före context.res instruktionen.

context.bindings.msg = name;

I det här läget bör din funktion se ut så här:

import { AzureFunction, Context, HttpRequest } from "@azure/functions"

const httpTrigger: AzureFunction = async function (context: Context, req: HttpRequest): Promise<void> {
    context.log('HTTP trigger function processed a request.');
    const name = (req.query.name || (req.body && req.body.name));

    if (name) {
        // Add a message to the storage queue, 
        // which is the name passed to the function.
        context.bindings.msg = name; 
        // Send a "hello" response.
        context.res = {
            // status: 200, /* Defaults to 200 */
            body: "Hello " + (req.query.name || req.body.name)
        };
    }
    else {
        context.res = {
            status: 400,
            body: "Please pass a name on the query string or in the request body"
        };
    }
};

export default httpTrigger;

Lägg till kod som använder Push-OutputBinding cmdleten för att skriva text till kön med hjälp av msg utgående bindning. Lägg till den här koden innan du anger statusen OK i if instruktionen.

$outputMsg = $name
Push-OutputBinding -name msg -Value $outputMsg

I det här läget bör din funktion se ut så här:

using namespace System.Net

# Input bindings are passed in via param block.
param($Request, $TriggerMetadata)

# Write to the Azure Functions log stream.
Write-Host "PowerShell HTTP trigger function processed a request."

# Interact with query parameters or the body of the request.
$name = $Request.Query.Name
if (-not $name) {
    $name = $Request.Body.Name
}

if ($name) {
    # Write the $name value to the queue, 
    # which is the name passed to the function.
    $outputMsg = $name
    Push-OutputBinding -name msg -Value $outputMsg

    $status = [HttpStatusCode]::OK
    $body = "Hello $name"
}
else {
    $status = [HttpStatusCode]::BadRequest
    $body = "Please pass a name on the query string or in the request body."
}

# Associate values to output bindings by calling 'Push-OutputBinding'.
Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = $status
    Body = $body
})

Uppdatera HttpExample \ _ _ init _ _ .py så att den matchar följande kod och lägg till msg parametern i funktionsdefinitionen msg.set(name) och under -instruktionen. if name:

import logging

import azure.functions as func


def main(req: func.HttpRequest, msg: func.Out[func.QueueMessage]) -> str:

    name = req.params.get('name')
    if not name:
        try:
            req_body = req.get_json()
        except ValueError:
            pass
        else:
            name = req_body.get('name')

    if name:
        msg.set(name)
        return func.HttpResponse(f"Hello {name}!")
    else:
        return func.HttpResponse(
            "Please pass a name on the query string or in the request body",
            status_code=400
        )

Parametern msg är en instans av azure.functions.Out class . Dess set -metod skriver ett strängmeddelande till kön, i det här fallet det namn som skickas till funktionen i URL-frågesträngen.

Nu kan du använda den nya msg parametern för att skriva till utgående bindning från din funktions kod. Lägg till följande kodrad innan du lyckas med att lägga till värdet för name i msg utmatnings bindningen.

msg.setValue(name);

När du använder en utgående bindning behöver du inte använda Azure Storage SDK-koden för autentisering, hämta en referens till kön eller skriva data. Bindningarna Functions Runtime och Queue output utför dessa uppgifter åt dig.

runMetoden bör nu se ut som i följande exempel:

@FunctionName("HttpExample")
public HttpResponseMessage run(
        @HttpTrigger(name = "req", methods = {HttpMethod.GET, HttpMethod.POST}, authLevel = AuthorizationLevel.ANONYMOUS) 
        HttpRequestMessage<Optional<String>> request, 
        @QueueOutput(name = "msg", queueName = "outqueue", 
        connection = "AzureWebJobsStorage") OutputBinding<String> msg, 
        final ExecutionContext context) {
    context.getLogger().info("Java HTTP trigger processed a request.");

    // Parse query parameter
    String query = request.getQueryParameters().get("name");
    String name = request.getBody().orElse(query);

    if (name == null) {
        return request.createResponseBuilder(HttpStatus.BAD_REQUEST)
        .body("Please pass a name on the query string or in the request body").build();
    } else {
        // Write the name to the message queue. 
        msg.setValue(name);

        return request.createResponseBuilder(HttpStatus.OK).body("Hello, " + name).build();
    }
}

Uppdatera testerna

Eftersom archetype också skapar en uppsättning tester måste du uppdatera de här testerna för att hantera den nya msg parametern i run Metodsignaturen.

Bläddra till platsen för test koden under src/test/java, öppna filen Function. java -projekt och ersätt kodraden under //Invoke med följande kod.

@SuppressWarnings("unchecked")
final OutputBinding<String> msg = (OutputBinding<String>)mock(OutputBinding.class);
final HttpResponseMessage ret = new Function().run(req, msg, context);

Köra funktionen lokalt

Visual Studio Koden integreras med Azure Functions Core-verktyg så att du kan köra det här projektet på din lokala utvecklingsdator innan du publicerar till Azure.

1. Du anropar funktionen genom att trycka på F5 för att starta funktionsappsprojektet. Utdata från Core Tools visas på panelen Terminal. Din app startar i terminalpanelen. Du kan se URL-slutpunkten för den HTTP-utlösta funktionen som körs lokalt.

   

   Om du har problem med att Windows på en dator kontrollerar du att standardterminalen för Visual Studio Code inte är inställd på WSL Bash.

2. När Core Tools är igång går du till området Azure: Funktioner. Under Funktioner expanderar du Lokal Project > Functions. Högerklicka (välj Windows) eller Ctrl - klicka (macOS) på HttpExample funktionen och välj Kör funktion nu....

   

3. I Enter request body (Ange begärandetext) trycker du på Retur för att skicka ett meddelande om begäran till funktionen.

4. När funktionen körs lokalt och returnerar ett svar utlöses ett meddelande i Visual Studio Code. Information om funktionskörningen visas i terminalpanelen.

5. Tryck på Ctrl + C för att stoppa Core Tools och koppla från felsökningsprogrammet.

Köra funktionen lokalt

1. Precis som i föregående artikel trycker du på F5 för att starta funktionsappsprojektet och Core Tools.

2. När Core Tools är igång går du till området Azure: Funktioner. Under Funktioner expanderar du Lokal Project > Functions. Högerklicka (Ctrl-klicka på Mac) på funktionen HttpExample och välj Kör funktion nu....

   

3. I Ange begärandetext visas brödtextvärdet för begärandemeddelandet. { "name": "Azure" } Tryck på Retur för att skicka det här begärandemeddelandet till din funktion.

4. När ett svar returneras trycker du på Ctrl + C för att stoppa Core Tools.

Eftersom du använder lagringsanslutningssträngen ansluter funktionen till Azure Storage-kontot när den körs lokalt. En ny kö med namnet outqueue skapas i ditt lagringskonto av Functions-körningen när utdatabindningen används för första gången. Du använder den Storage Explorer för att kontrollera att kön har skapats tillsammans med det nya meddelandet.

• Exempel på fullständiga funktionsprojekt i C#.

• Azure Functions C#-utvecklarreferens

• Exempel på fullständiga funktionsprojekt i JavaScript.

• JavaScript-utvecklarhandbok för Azure Functions

• Exempel på fullständiga funktionsprojekt i Java.

• Azure Functions Java-utvecklarguide

• Exempel på fullständiga funktionsprojekt i TypeScript.

• Azure Functions utvecklarhandbok för TypeScript

• Exempel på fullständiga funktionsprojekt i Python.

• Python-utvecklarhandbok för Azure Functions

• Exempel på fullständiga funktionsprojekt i PowerShell.

• PowerShell-utvecklarhandbok för Azure Functions