Připojení funkcí ke službám Azure pomocí vazeb

Když vytvoříte funkci, spouštěcí kód specifický pro jazyk se přidá do projektu ze sady spouštěcích šablon. Pokud chcete funkci připojit k jiným službám pomocí vstupních nebo výstupních vazeb, musíte do své funkce přidat konkrétní definice vazeb. Další informace o vazbách najdete v tématu koncepty triggerů a vazeb Azure Functions.

Místní vývoj

Při místním vývoji funkcí je potřeba aktualizovat kód funkce a přidat vazby. Pro jazyky, které používají function.json, Visual Studio Code poskytuje nástroje pro přidání vazeb do funkce.

Ruční přidání vazeb na základě příkladů

Při přidávání vazby do existující funkce je potřeba do definice funkce v kódu přidat atributy specifické pro vazbu.

Když přidáváte vazbu do existující funkce, musíte do definice funkce v kódu přidat poznámky specifické pro vazbu.

Při přidávání vazby do existující funkce je potřeba aktualizovat kód funkce a přidat definici do konfiguračního souboru function.json.

Při přidávání vazby k existující funkci je potřeba aktualizovat definici funkce v závislosti na modelu:

Do definice funkce v kódu je potřeba přidat poznámky specifické pro vazbu.

Následující příklad ukazuje definici funkce po přidání výstupní vazby Queue Storage výstupní vazby do funkce aktivované HTTP:

Protože funkce aktivovaná protokolem HTTP také vrací odpověď HTTP, funkce vrátí MultiResponse objekt, který představuje výstup HTTP i fronty.

[Function("HttpExample")]
public MultiResponse Run([HttpTrigger(AuthorizationLevel.Function, "get", "post")] HttpRequest req)

Tento příklad je definice objektu MultiResponse , který obsahuje výstupní vazbu:

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

V tomto příkladu se používá integrace ASP.NET Core. Pokud nepoužíváte integraci ASP.NET Core, musíte změnit HttpRequest na HttpRequestData a IActionResult na HttpResponseData.

Zprávy se posílají do fronty po dokončení funkce. Způsob, jakým definujete výstupní vazbu, závisí na modelu procesu. Další informace, včetně odkazů na ukázkový kód vazby, na který můžete odkazovat, najdete v tématu Přidání vazeb do funkce.

@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) {

Další informace, včetně odkazů na ukázkový kód vazby, na který můžete odkazovat, najdete v tématu Přidání vazeb do funkce.

const { app, output } = require('@azure/functions');

const sendToQueue = output.storageQueue({
  queueName: 'outqueue',
  connection: 'AzureWebJobsStorage',
});

app.http('HttpExample', {
  methods: ['GET', 'POST'],
  authLevel: 'anonymous',
  extraOutputs: [sendToQueue],
  handler: async (request, context) => {
    try {
      context.log(`Http function processed request for url "${request.url}"`);

      const name = request.query.get('name') || (await request.text());
      context.log(`Name: ${name}`);

      if (name) {
        const msg = `Name passed to the function ${name}`;
        context.extraOutputs.set(sendToQueue, [msg]);
        return { body: msg };
      } else {
        context.log('Missing required data');
        return { status: 404, body: 'Missing required data' };
      }
    } catch (error) {
      context.log(`Error: ${error}`);
      return { status: 500, body: 'Internal Server Error' };
    }
  },
});

Způsob, jakým definujete výstupní vazbu, závisí na verzi modelu Node.js. Další informace, včetně odkazů na ukázkový kód vazby, na který můžete odkazovat, najdete v tématu Přidání vazeb do funkce.

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

Další informace, včetně odkazů na ukázkový kód vazby, na který můžete odkazovat, najdete v tématu Přidání vazeb do funkce.

@app.route(route="HttpExample")
@app.queue_output(arg_name="msg", queue_name="outqueue", connection="AzureWebJobsStorage")
def HttpExample(req: func.HttpRequest, msg: func.Out [func.QueueMessage]) -> func.HttpResponse:
    logging.info('Python HTTP trigger function processed a request.')

Způsob, jakým definujete výstupní vazbu, závisí na verzi modelu Pythonu. Další informace, včetně odkazů na ukázkový kód vazby, na který můžete odkazovat, najdete v tématu Přidání vazeb do funkce.

import {
  app,
  output,
  HttpRequest,
  HttpResponseInit,
  InvocationContext,
  StorageQueueOutput,
} from '@azure/functions';

const sendToQueue: StorageQueueOutput = output.storageQueue({
  queueName: 'outqueue',
  connection: 'AzureWebJobsStorage',
});

export async function HttpExample(
  request: HttpRequest,
  context: InvocationContext,
): Promise<HttpResponseInit> {
  try {
    context.log(`Http function processed request for url "${request.url}"`);

    const name = request.query.get('name') || (await request.text());
    context.log(`Name: ${name}`);

    if (name) {
      const msg = `Name passed to the function ${name}`;
      context.extraOutputs.set(sendToQueue, [msg]);
      return { body: msg };
    } else {
      context.log('Missing required data');
      return { status: 404, body: 'Missing required data' };
    }
  } catch (error) {
    context.log(`Error: ${error}`);
    return { status: 500, body: 'Internal Server Error' };
  }
}

app.http('HttpExample', {
  methods: ['GET', 'POST'],
  authLevel: 'anonymous',
  handler: HttpExample,
});

Způsob, jakým definujete výstupní vazbu, závisí na verzi modelu Node.js. Další informace, včetně odkazů na ukázkový kód vazby, na který můžete odkazovat, najdete v tématu Přidání vazeb do funkce.

V následující tabulce najdete příklady konkrétních typů vazeb, které můžete použít k aktualizaci existující funkce. Nejprve zvolte kartu jazyka, která odpovídá vašemu project.

Vázání kódu pro jazyk C# závisí na konkrétním modelu procesu.

Služba Příklady Vzorky
Blob Storage (úložiště blobů) Trigger
Input
Output
Link
Azure Cosmos DB Spouštěč
Vstup
Výstup
Link
Azure Data Explorer Input
Output
Link
Azure SQL Trigger
Input
Output
Link
Event Grid Spouštěč
Výstup
Link
Centra událostí Spouštěč
Výstup
IoT Hub Spouštěč
Výstup
HTTP Spouštěč Link
Úložiště front Trigger
Output
Link
RabbitMQ Spouštěč
Výstup
SendGrid Výstup
Service Bus Spouštěč
Výstup
Link
Azure SignalR Service Spouštěč
Vstup
Výstup
Úložiště tabulky Input
Output
Časovač Spouštěč Link
Twilio Výstup Link
Služba Příklady Vzorky
Blob Storage (úložiště blobů) Spouštěč
Input
Output
Link
Azure Cosmos DB Spouštěč
Vstup
Výstup
Link
Azure Data Explorer Input
Output
Link
Azure SQL Trigger
Input
Output
Event Grid Spouštěč
Výstup
Link
Centra událostí Spouštěč
Výstup
IoT Hub Spouštěč
Výstup
HTTP Spouštěč Link
Úložiště front Spouštěč
Output
Link
RabbitMQ Spouštěč
Výstup
SendGrid Výstup
Service Bus Spouštěč
Výstup
Link
Azure SignalR Service Spouštěč
Vstup
Výstup
Úložiště tabulky Input
Output
Časovač Spouštěč Link
Twilio Výstup
Služba Příklady Vzorky
Blob Storage (úložiště blobů) Trigger
Input
Output
Link
Azure Cosmos DB Spouštěč
Vstup
Výstup
Link
Azure Data Explorer Input
Output
Azure SQL Trigger
Input
Output
Link
Event Grid Spouštěč
Výstup
Centra událostí Spouštěč
Výstup
IoT Hub Spouštěč
Výstup
HTTP Spouštěč Link
Úložiště front Trigger
Output
Link
RabbitMQ Spouštěč
Výstup
SendGrid Výstup
Service Bus Spouštěč
Výstup
Link
Azure SignalR Service Spouštěč
Vstup
Výstup
Úložiště tabulky Input
Output
Časovač Spouštěč
Twilio Výstup
Služba Příklady Vzorky
Blob Storage (úložiště blobů) Trigger
Input
Output
Azure Cosmos DB Spouštěč
Vstup
Výstup
Azure SQL Trigger
Input
Output
Event Grid Spouštěč
Výstup
Centra událostí Spouštěč
Výstup
IoT Hub Spouštěč
Výstup
HTTP Spouštěč Link
Úložiště front Trigger
Output
RabbitMQ Spouštěč
Výstup
SendGrid Výstup
Service Bus Spouštěč
Výstup
Azure SignalR Service Spouštěč
Vstup
Výstup
Úložiště tabulky Input
Output
Časovač Spouštěč
Twilio Výstup

Vázání kódu pro Python závisí na verzi modelu Pythonu.

Služba Příklady Vzorky
Blob Storage (úložiště blobů) Trigger
Input
Output
Link
Azure Cosmos DB Spouštěč
Vstup
Výstup
Link
Azure Data Explorer Input
Output
Azure SQL Trigger
Input
Output
Link
Event Grid Spouštěč
Výstup
Centra událostí Spouštěč
Výstup
IoT Hub Spouštěč
Výstup
HTTP Spouštěč Link
Úložiště front Trigger
Output
RabbitMQ Spouštěč
Výstup
SendGrid Výstup
Service Bus Spouštěč
Výstup
Link
Azure SignalR Service Spouštěč
Vstup
Výstup
Úložiště tabulky Input
Output
Časovač Spouštěč
Twilio Výstup

Visual Studio Code

Když k vývoji funkce použijete Visual Studio Code a funkce použije soubor function.json, rozšíření Azure Functions může automaticky přidat vazbu k existujícímu souboru function.json. Další informace najdete v tématu Přidání vstupních a výstupních vazeb.

Azure portal

Při vývoji funkcí v Azure portal přidáte vstupní a výstupní vazby do karty Integrate pro danou funkci. Nové vazby se přidají do souboru function.json nebo do atributů metody v závislosti na vašem jazyce. Následující články ukazují příklady přidání vazeb do existující funkce na portálu:

Další kroky