Sdílet prostřednictvím


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

Při vytváření funkce se kód triggeru specifický pro jazyk přidá do projektu ze sady šablon aktivačních událostí. 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, poskytuje Visual Studio Code 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 do funkce aktivované protokolem 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 static MultiResponse Run([HttpTrigger(AuthorizationLevel.Function, "get", "post")] HttpRequest req,
    FunctionContext executionContext)
{

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; }
}

Když tento příklad použijete u svého vlastního projektu, budete možná muset změnit HttpRequest na HttpRequestData a IActionResult na HttpResponseData, v závislosti na tom, jestli používáte integraci ASP.NET Core nebo ne.

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 projektu.

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

Služba Příklady Vzorky
Blob Storage Spouštěč
Vstup
Výstup
Odkaz
Azure Cosmos DB Spouštěč
Vstup
Výstup
Odkaz
Azure Data Explorer Vstup
Výstup
Odkaz
Azure SQL Spouštěč
Vstup
Výstup
Odkaz
Event Grid Spouštěč
Výstup
Odkaz
Centra událostí Spouštěč
Výstup
Centrum IoT Spouštěč
Výstup
HTTP Spouštěč Odkaz
Queue Storage Spouštěč
Výstup
Odkaz
RabbitMQ Spouštěč
Výstup
SendGrid Výstup
Sběrnice Spouštěč
Výstup
Odkaz
Azure SignalR Service Spouštěč
Vstup
Výstup
Table Storage Vstup
Výstup
Časovač Spouštěč Odkaz
Twilio Výstup Odkaz
Služba Příklady Vzorky
Blob Storage Spouštěč
Vstup
Výstup
Odkaz
Azure Cosmos DB Spouštěč
Vstup
Výstup
Odkaz
Azure Data Explorer Vstup
Výstup
Odkaz
Azure SQL Spouštěč
Vstup
Výstup
Event Grid Spouštěč
Výstup
Odkaz
Centra událostí Spouštěč
Výstup
Centrum IoT Spouštěč
Výstup
HTTP Spouštěč Odkaz
Queue Storage Spouštěč
Výstup
Odkaz
RabbitMQ Spouštěč
Výstup
SendGrid Výstup
Sběrnice Spouštěč
Výstup
Odkaz
Azure SignalR Service Spouštěč
Vstup
Výstup
Table Storage Vstup
Výstup
Časovač Spouštěč Odkaz
Twilio Výstup
Služba Příklady Vzorky
Blob Storage Spouštěč
Vstup
Výstup
Odkaz
Azure Cosmos DB Spouštěč
Vstup
Výstup
Odkaz
Azure Data Explorer Vstup
Výstup
Azure SQL Spouštěč
Vstup
Výstup
Odkaz
Event Grid Spouštěč
Výstup
Centra událostí Spouštěč
Výstup
Centrum IoT Spouštěč
Výstup
HTTP Spouštěč Odkaz
Queue Storage Spouštěč
Výstup
Odkaz
RabbitMQ Spouštěč
Výstup
SendGrid Výstup
Sběrnice Spouštěč
Výstup
Odkaz
Azure SignalR Service Spouštěč
Vstup
Výstup
Table Storage Vstup
Výstup
Časovač Spouštěč
Twilio Výstup
Služba Příklady Vzorky
Blob Storage Spouštěč
Vstup
Výstup
Azure Cosmos DB Spouštěč
Vstup
Výstup
Azure SQL Spouštěč
Vstup
Výstup
Event Grid Spouštěč
Výstup
Centra událostí Spouštěč
Výstup
Centrum IoT Spouštěč
Výstup
HTTP Spouštěč Odkaz
Queue Storage Spouštěč
Výstup
RabbitMQ Spouštěč
Výstup
SendGrid Výstup
Sběrnice Spouštěč
Výstup
Azure SignalR Service Spouštěč
Vstup
Výstup
Table Storage Vstup
Výstup
Č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 Spouštěč
Vstup
Výstup
Odkaz
Azure Cosmos DB Spouštěč
Vstup
Výstup
Odkaz
Azure Data Explorer Vstup
Výstup
Azure SQL Spouštěč
Vstup
Výstup
Odkaz
Event Grid Spouštěč
Výstup
Centra událostí Spouštěč
Výstup
Centrum IoT Spouštěč
Výstup
HTTP Spouštěč Odkaz
Queue Storage Spouštěč
Výstup
RabbitMQ Spouštěč
Výstup
SendGrid Výstup
Sběrnice Spouštěč
Výstup
Odkaz
Azure SignalR Service Spouštěč
Vstup
Výstup
Table Storage Vstup
Výstup
Časovač Spouštěč
Twilio Výstup

Visual Studio Code

Když k vývoji funkce použijete Visual Studio Code a vaše 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í na webu Azure Portal přidáte vstupní a výstupní vazby na kartě Integrace 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