Conceitos dos acionadores e dos enlaces das Funções do Azure

Artigo
10/16/2024

Neste artigo, você aprenderá os conceitos de alto nível em torno de funções, gatilhos e associações.

Os gatilhos fazem com que uma função seja executada. Um acionador define como uma função é invocada e uma função tem de ter exatamente um acionador. Os gatilhos também podem passar dados para sua função, como você faria com chamadas de método.

A vinculação a uma função é uma forma de conectar declarativamente suas funções a outros recursos; As ligações passam dados para sua função (uma ligação de entrada) ou permitem que você grave dados de sua função (uma ligação de saída) usando parâmetros de ligação. Seu gatilho de função é essencialmente um tipo especial de ligação de entrada.

Você pode misturar e combinar diferentes ligações para se adequar ao cenário específico da sua função. Os enlaces são opcionais e uma função pode ter um ou mais enlaces de entrada e/ou de saída.

Gatilhos e associações permitem evitar o acesso de codificação a outros serviços. A sua função recebe dados (por exemplo, os conteúdos de uma mensagem de fila) em parâmetros de função. Pode enviar dados (por exemplo, para criar uma mensagem de fila) através do valor de retorno da função.

Considere os seguintes exemplos de como você pode implementar diferentes funções.

Cenário de exemplo	Acionador	Vinculação de entrada	Vinculação de saída
Chega uma nova mensagem de fila que executa uma função para gravar em outra fila.	Fila^*	Nenhuma	Fila^*
Um trabalho agendado lê o conteúdo do Armazenamento de Blob e cria um novo documento do Azure Cosmos DB.	Temporizador	Armazenamento de Blobs	Azure Cosmos DB
A Grade de Eventos é usada para ler uma imagem do Armazenamento de Blobs e um documento do Azure Cosmos DB para enviar um email.	Event Grid	Armazenamento de Blobs e Azure Cosmos DB	SendGrid

^* Representa filas diferentes

Esses exemplos não devem ser exaustivos, mas são fornecidos para ilustrar como você pode usar gatilhos e ligações juntos. Para obter um conjunto mais abrangente de cenários, consulte Cenários do Azure Functions.

Gorjeta

O Functions não exige que você use associações de entrada e saída para se conectar aos serviços do Azure. Você sempre pode criar um cliente SDK do Azure em seu código e usá-lo em vez disso para suas transferências de dados. Para obter mais informações, consulte Conectar-se a serviços.

Definições de desencadeamento e vinculativas

Gatilhos e ligações são definidos de forma diferente dependendo da linguagem de desenvolvimento. Certifique-se de que seleciona o seu idioma na parte superior do artigo.

As ligações podem ser de entrada ou de saída. Nem todos os serviços suportam ligações de entrada e saída. Consulte sua extensão de vinculação específica para obter exemplos de código de ligações específicas.

Este exemplo mostra uma função acionada por HTTP com uma associação de saída que grava uma mensagem em uma fila de Armazenamento do Azure.

Para funções de biblioteca de classes C#, gatilhos e associações são configurados decorando métodos e parâmetros com atributos C#, onde o atributo específico aplicado pode depender do modelo de tempo de execução C#:

Modelo de trabalhador isolado
Modelo em processo

O gatilho HTTP (HttpTrigger) é definido no método para uma função chamada HttpExample que retorna um MultiResponse Run objeto:

[Function("HttpExample")]
public static MultiResponse Run([HttpTrigger(AuthorizationLevel.Function, "get", "post")] HttpRequestData req,
    FunctionContext executionContext)
{

Este exemplo mostra a definição de MultiResponse objeto que retorna um HttpResponse para a solicitação HTTP e também grava uma mensagem em uma fila de armazenamento usando uma QueueOutput ligação:

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

Para obter mais informações, consulte o guia de modelo de trabalhador isolado em C#.

O gatilho HTTP (HttpTrigger) é definido no método para uma função chamada HttpExample que grava em uma fila de armazenamento definida pelos Queue atributos e StorageAccount no msg parâmetro:Run

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

Para obter mais informações, consulte o guia de modelo em processo em C#.

As funções de script C# herdadas usam um arquivo de definição de function.json. Para obter mais informações, consulte a referência do desenvolvedor do script C# do Azure Functions (.csx).

Para funções Java, triggers e bindings são configurados anotando métodos e parâmetros específicos. Esse gatilho HTTP (@HttpTrigger) é definido no método para uma função chamada HttpTriggerQueueOutput, que grava em uma fila @QueueOutput de armazenamento definida pela anotação no message run parâmetro:

@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.");

Para obter mais informações, consulte o Guia do desenvolvedor Java.

A maneira como os gatilhos e a ligação são definidos para Node.js funções depende da versão específica do Node.js para Funções:

No Node.js para o Functions versão 4, você configura gatilhos e associações usando objetos exportados do @azure/functions módulo. Para obter mais informações, consulte o Node.js guia do desenvolvedor.

Este exemplo é uma função acionada por HTTP que cria um item de fila para cada solicitação HTTP recebida.

O http método no objeto exportado app define um gatilho HTTP e o storageQueue método on output define uma ligação de saída nesse gatilho.

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

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

app.http('httpTrigger1', {
    methods: ['GET', 'POST'],
    authLevel: 'anonymous',
    extraOutputs: [queueOutput],
    handler: async (request, context) => {
        const body = await request.text();
        context.extraOutputs.set(queueOutput, body);
        return { body: 'Created queue item.' };
    },
});

Este arquivo de exemplo function.json define a função de gatilho HTTP que retorna uma resposta HTTP e grava em uma fila de armazenamento.

{
  "bindings": [
    {
      "type": "httpTrigger",
      "direction": "in",
      "authLevel": "function",
      "name": "input"
    },
    {
      "type": "http",
      "direction": "out",
      "name": "$return"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "myQueueItem",
      "queueName": "outqueue",
      "connection": "MyStorageConnectionAppSetting"
    }
  ]
}

O http método no objeto exportado app define um gatilho HTTP e o storageQueue método on output define uma ligação de saída nesse gatilho.

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

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

export async function httpTrigger1(request: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
    const body = await request.text();
    context.extraOutputs.set(queueOutput, body);
    return { body: 'Created queue item.' };
}

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

Este arquivo de exemplo function.json define a função de gatilho HTTP que retorna uma resposta HTTP e grava em uma fila de armazenamento.

{
  "bindings": [
    {
      "type": "httpTrigger",
      "direction": "in",
      "authLevel": "function",
      "name": "input"
    },
    {
      "type": "http",
      "direction": "out",
      "name": "$return"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "myQueueItem",
      "queueName": "outqueue",
      "connection": "MyStorageConnectionAppSetting"
    }
  ]
}

Este arquivo de exemplo function.json define a função:

    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "Request",
      "methods": [
        "get",
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "Response"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

Para obter mais informações, consulte o guia do desenvolvedor do PowerShell.

A forma como a função é definida depende da versão do Python for Functions:

No Python for Functions versão 2, você define a função diretamente no código usando decoradores.

app = func.FunctionApp(http_auth_level=func.AuthLevel.ANONYMOUS)

@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.')

No Python for Functions versão 1, este arquivo de exemplo function.json define uma função de gatilho HTTP que retorna uma resposta HTTP e grava em uma fila de armazenamento.

    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "Request",
      "methods": [
        "get",
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "Response"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

Adicionar associações a uma função

Você pode conectar sua função a outros serviços usando ligações de entrada ou saída. Adicione uma associação adicionando suas definições específicas à sua função. Para saber como, consulte Adicionar associações a uma função existente no Azure Functions.

Ligações suportadas

Esta tabela mostra as associações com suporte nas versões principais do tempo de execução do Azure Functions:

Type	1,x¹	2.x e superior²	Acionador	Entrada	Saída
Armazenamento de blobs	✔	✔	✔	✔	✔
BD do Cosmos para o Azure	✔	✔	✔	✔	✔
Azure Data Explorer		✔		✔	✔
SQL do Azure		✔	✔	✔	✔
Dapr⁴		✔	✔	✔	✔
Event Grid	✔	✔	✔		✔
Hubs de Eventos	✔	✔	✔		✔
HTTP & webhooks	✔	✔	✔		✔
Hub IoT	✔	✔	✔
Kafka³		✔	✔		✔
Aplicações Móveis	✔			✔	✔
Hubs de Notificação	✔				✔
Armazenamento de filas	✔	✔	✔		✔
Redis		✔	✔
CoelhoMQ³		✔	✔		✔
SendGrid	✔	✔			✔
Service Bus	✔	✔	✔		✔
SignalR		✔	✔	✔	✔
Armazenamento de tabelas	✔	✔		✔	✔
Temporizador	✔	✔	✔
Twilio	✔	✔			✔

Notas:

O suporte terminará para a versão 1.x do tempo de execução do Azure Functions em 14 de setembro de 2026. É altamente recomendável que você migre seus aplicativos para a versão 4.x para obter suporte completo.
A partir do tempo de execução da versão 2.x, todas as associações, exceto HTTP e Timer, devem ser registradas. Consulte Registrar extensões de vinculação.
Os gatilhos não são suportados no plano de consumo. Requer gatilhos controlados por tempo de execução.
Suportado apenas em Kubernetes, IoT Edge e outros modos auto-hospedados.

Para obter informações sobre quais associações estão em visualização ou são aprovadas para uso em produção, consulte Idiomas suportados.

Versões de extensão de vinculação específicas só são suportadas enquanto o SDK do serviço subjacente é suportado. As alterações no suporte na versão do SDK do serviço subjacente afetam o suporte para a extensão de consumo.

Exemplos de código de enlaces

Use a tabela a seguir para encontrar mais exemplos de tipos de vinculação específicos que mostram como trabalhar com associações em suas funções. Primeiro, escolha a guia de idioma que corresponde ao seu projeto.

O código de vinculação para C# depende do modelo de processo específico.

Processo isolado
Em processo

Serviço	Exemplos	Exemplos
Armazenamento de Blobs	Acionador Entrada Saída	Ligação
Azure Cosmos DB	Acionador Entrada Saída	Ligação
Azure Data Explorer	Entrada Saída	Ligação
SQL do Azure	Acionador Entrada Saída	Ligação
Event Grid	Acionador Saída	Ligação
Hubs de Eventos	Acionador Saída
IoT Hub	Acionador Saída
HTTP	Acionador	Ligação
Armazenamento de filas	Acionador Saída	Ligação
RabbitMQ	Acionador Saída
SendGrid	Saída
Service Bus	Acionador Saída	Ligação
SignalR	Acionador Entrada Saída
Armazenamento de tabelas	Entrada Saída
Temporizador	Acionador	Ligação
Twilio	Saída	Ligação

Serviço	Exemplos	Exemplos
Armazenamento de Blobs	Acionador Entrada Saída	Ligação
Azure Cosmos DB	Acionador Entrada Saída	Ligação
Azure Data Explorer	Entrada Saída	Ligação
SQL do Azure	Acionador Entrada Saída	Ligação
Event Grid	Acionador Saída	Ligação
Hubs de Eventos	Acionador Saída
IoT Hub	Acionador Saída
HTTP	Acionador	Ligação
Armazenamento de filas	Acionador Saída	Ligação
RabbitMQ	Acionador Saída
SendGrid	Saída
Service Bus	Acionador Saída	Ligação
SignalR	Acionador Entrada Saída
Armazenamento de tabelas	Entrada Saída
Temporizador	Acionador	Ligação
Twilio	Saída	Ligação

Serviço	Exemplos	Exemplos
Armazenamento de Blobs	Acionador Entrada Saída	Ligação
Azure Cosmos DB	Acionador Entrada Saída	Ligação
Azure Data Explorer	Entrada Saída	Ligação
SQL do Azure	Acionador Entrada Saída
Event Grid	Acionador Saída	Ligação
Hubs de Eventos	Acionador Saída
IoT Hub	Acionador Saída
HTTP	Acionador	Ligação
Armazenamento de filas	Acionador Saída	Ligação
RabbitMQ	Acionador Saída
SendGrid	Saída
Service Bus	Acionador Saída	Ligação
SignalR	Acionador Entrada Saída
Armazenamento de tabelas	Entrada Saída
Temporizador	Acionador	Ligação
Twilio	Saída	Ligação

Serviço	Exemplos	Exemplos
Armazenamento de Blobs	Acionador Entrada Saída	Ligação
Azure Cosmos DB	Acionador Entrada Saída	Ligação
Azure Data Explorer	Entrada Saída
SQL do Azure	Acionador Entrada Saída	Ligação
Event Grid	Acionador Saída	Ligação
Hubs de Eventos	Acionador Saída
IoT Hub	Acionador Saída
HTTP	Acionador	Ligação
Armazenamento de filas	Acionador Saída	Ligação
RabbitMQ	Acionador Saída
SendGrid	Saída
Service Bus	Acionador Saída	Ligação
SignalR	Acionador Entrada Saída
Armazenamento de tabelas	Entrada Saída
Temporizador	Acionador	Ligação
Twilio	Saída	Ligação

Serviço	Exemplos	Exemplos
Armazenamento de Blobs	Acionador Entrada Saída	Ligação
Azure Cosmos DB	Acionador Entrada Saída	Ligação
SQL do Azure	Acionador Entrada Saída
Event Grid	Acionador Saída	Ligação
Hubs de Eventos	Acionador Saída
IoT Hub	Acionador Saída
HTTP	Acionador	Ligação
Armazenamento de filas	Acionador Saída	Ligação
RabbitMQ	Acionador Saída
SendGrid	Saída
Service Bus	Acionador Saída	Ligação
SignalR	Acionador Entrada Saída
Armazenamento de tabelas	Entrada Saída
Temporizador	Acionador	Ligação
Twilio	Saída	Ligação

O código de vinculação para Python depende da versão do modelo Python.

Serviço	Exemplos	Exemplos
Armazenamento de Blobs	Acionador Entrada Saída	Ligação
Azure Cosmos DB	Acionador Entrada Saída	Ligação
Azure Data Explorer	Entrada Saída
SQL do Azure	Acionador Entrada Saída	Ligação
Event Grid	Acionador Saída	Ligação
Hubs de Eventos	Acionador Saída
IoT Hub	Acionador Saída
HTTP	Acionador	Ligação
Armazenamento de filas	Acionador Saída	Ligação
RabbitMQ	Acionador Saída
SendGrid	Saída
Service Bus	Acionador Saída	Ligação
SignalR	Acionador Entrada Saída
Armazenamento de tabelas	Entrada Saída
Temporizador	Acionador	Ligação
Twilio	Saída	Ligação

Serviço	Exemplos	Exemplos
Armazenamento de Blobs	Acionador Entrada Saída	Ligação
Azure Cosmos DB	Acionador Entrada Saída	Ligação
Azure Data Explorer	Entrada Saída
SQL do Azure	Acionador Entrada Saída	Ligação
Event Grid	Acionador Saída	Ligação
Hubs de Eventos	Acionador Saída
IoT Hub	Acionador Saída
HTTP	Acionador	Ligação
Armazenamento de filas	Acionador Saída	Ligação
RabbitMQ	Acionador Saída
SendGrid	Saída
Service Bus	Acionador Saída	Ligação
SignalR	Acionador Entrada Saída
Armazenamento de tabelas	Entrada Saída
Temporizador	Acionador	Ligação
Twilio	Saída	Ligação

Ligações personalizadas

Você pode criar ligações de entrada e saída personalizadas. As ligações devem ser criadas no .NET, mas podem ser consumidas a partir de qualquer idioma suportado. Para obter mais informações sobre como criar associações personalizadas, consulte Criando ligações de entrada e saída personalizadas.

Partilhar via

Conceitos dos acionadores e dos enlaces das Funções do Azure

Definições de desencadeamento e vinculativas

Adicionar associações a uma função

Ligações suportadas

Exemplos de código de enlaces

Ligações personalizadas

Comentários

Recursos adicionais

Partilhar via

Conceitos dos acionadores e dos enlaces das Funções do Azure

Definições de desencadeamento e vinculativas

Adicionar associações a uma função

Ligações suportadas

Exemplos de código de enlaces

Ligações personalizadas

Conteúdos relacionados

Comentários

Recursos adicionais