Delen via


Functies verbinden met Azure-services met behulp van bindingen

Wanneer u een functie maakt, wordt taalspecifieke triggercode in uw project toegevoegd vanuit een set triggersjablonen. Als u uw functie wilt verbinden met andere services met behulp van invoer- of uitvoerbindingen, moet u specifieke bindingsdefinities toevoegen aan uw functie. Zie Concepten van Azure Functions-triggers en -bindingen voor meer informatie over bindingen.

Lokale ontwikkeling

Wanneer u functies lokaal ontwikkelt, moet u de functiecode bijwerken om bindingen toe te voegen. Voor talen die gebruikmaken van function.jsonbiedt Visual Studio Code hulpprogramma's voor het toevoegen van bindingen aan een functie.

Handmatig bindingen toevoegen op basis van voorbeelden

Wanneer u een binding toevoegt aan een bestaande functie, moet u bindingsspecifieke kenmerken toevoegen aan de functiedefinitie in code.

Wanneer u een binding toevoegt aan een bestaande functie, moet u bindingsspecifieke aantekeningen toevoegen aan de functiedefinitie in code.

Wanneer u een binding toevoegt aan een bestaande functie, moet u de functiecode bijwerken en een definitie toevoegen aan het function.json configuratiebestand.

Wanneer u een binding toevoegt aan een bestaande functie, moet u de functiedefinitie bijwerken, afhankelijk van uw model:

U moet bindingsspecifieke aantekeningen toevoegen aan de functiedefinitie in code.

In het volgende voorbeeld ziet u de functiedefinitie nadat u een Queue Storage-uitvoerbinding hebt toegevoegd aan een door HTTP geactiveerde functie:

Omdat een door HTTP geactiveerde functie ook een HTTP-antwoord retourneert, retourneert de functie een MultiResponse object, dat zowel de HTTP- als de wachtrijuitvoer vertegenwoordigt.

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

Dit voorbeeld is de definitie van het MultiResponse object dat de uitvoerbinding bevat:

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

Wanneer u dat voorbeeld toepast op uw eigen project, moet u mogelijk HttpRequest veranderen naar HttpRequestData en IActionResult naar HttpResponseData, afhankelijk van of u ASP.NET Core-integratie gebruikt of niet.

Berichten worden naar de wachtrij verzonden wanneer de functie is voltooid. De manier waarop u de uitvoerbinding definieert, is afhankelijk van uw procesmodel. Zie Bindingen toevoegen aan een functie voor meer informatie, inclusief koppelingen naar voorbeeldbindingscode waarnaar u kunt verwijzen.

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

Zie Bindingen toevoegen aan een functie voor meer informatie, inclusief koppelingen naar voorbeeldbindingscode waarnaar u kunt verwijzen.

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' };
    }
  },
});

De manier waarop u de uitvoerbinding definieert, is afhankelijk van de versie van uw Node.js model. Zie Bindingen toevoegen aan een functie voor meer informatie, inclusief koppelingen naar voorbeeldbindingscode waarnaar u kunt verwijzen.

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

Zie Bindingen toevoegen aan een functie voor meer informatie, inclusief koppelingen naar voorbeeldbindingscode waarnaar u kunt verwijzen.

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

De manier waarop u de uitvoerbinding definieert, is afhankelijk van de versie van uw Python-model. Zie Bindingen toevoegen aan een functie voor meer informatie, inclusief koppelingen naar voorbeeldbindingscode waarnaar u kunt verwijzen.

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

De manier waarop u de uitvoerbinding definieert, is afhankelijk van de versie van uw Node.js model. Zie Bindingen toevoegen aan een functie voor meer informatie, inclusief koppelingen naar voorbeeldbindingscode waarnaar u kunt verwijzen.

Gebruik de volgende tabel om voorbeelden te vinden van specifieke bindingstypen die u kunt gebruiken om u te helpen bij het bijwerken van een bestaande functie. Kies eerst het taaltabblad dat overeenkomt met uw project.

Bindingscode voor C# is afhankelijk van het specifieke procesmodel.

Dienst Voorbeelden Voorbeelden
Blob-opslag Trekker
Invoer
Uitvoer
Verbinden
Azure Cosmos DB Trekker
Invoer
Uitvoer
Verbinden
Azure-gegevensverkenner Invoer
Uitvoer
Verbinden
Azure SQL Trekker
Invoer
Uitvoer
Verbinden
Gebeurtenisgrid Trekker
Uitvoer
Verbinden
Evenement Hubs Trekker
Uitvoer
IoT-hub Trekker
Uitvoer
HTTP Trekker Verbinden
Wachtrij opslag Trekker
Uitvoer
Verbinden
RabbitMQ Trekker
Uitvoer
SendGrid Uitvoer
Dienstbus Trekker
Uitvoer
Verbinden
SignalR Trekker
Invoer
Uitvoer
Tabelopslag Invoer
Uitvoer
Tijdmeter Trekker Verbinden
Twilio Uitvoer Verbinden
Dienst Voorbeelden Voorbeelden
Blob-opslag Trekker
Invoer
Uitvoer
Verbinden
Azure Cosmos DB Trekker
Invoer
Uitvoer
Verbinden
Azure-gegevensverkenner Invoer
Uitvoer
Verbinden
Azure SQL Trekker
Invoer
Uitvoer
Gebeurtenisgrid Trekker
Uitvoer
Verbinden
Evenement Hubs Trekker
Uitvoer
IoT-hub Trekker
Uitvoer
HTTP Trekker Verbinden
Wachtrij opslag Trekker
Uitvoer
Verbinden
RabbitMQ Trekker
Uitvoer
SendGrid Uitvoer
Dienstbus Trekker
Uitvoer
Verbinden
SignalR Trekker
Invoer
Uitvoer
Tabelopslag Invoer
Uitvoer
Tijdmeter Trekker Verbinden
Twilio Uitvoer Verbinden
Dienst Voorbeelden Voorbeelden
Blob-opslag Trekker
Invoer
Uitvoer
Verbinden
Azure Cosmos DB Trekker
Invoer
Uitvoer
Verbinden
Azure-gegevensverkenner Invoer
Uitvoer
Azure SQL Trekker
Invoer
Uitvoer
Verbinden
Gebeurtenisgrid Trekker
Uitvoer
Verbinden
Evenement Hubs Trekker
Uitvoer
IoT-hub Trekker
Uitvoer
HTTP Trekker Verbinden
Wachtrij opslag Trekker
Uitvoer
Verbinden
RabbitMQ Trekker
Uitvoer
SendGrid Uitvoer
Dienstbus Trekker
Uitvoer
Verbinden
SignalR Trekker
Invoer
Uitvoer
Tabelopslag Invoer
Uitvoer
Tijdmeter Trekker Verbinden
Twilio Uitvoer Verbinden
Dienst Voorbeelden Voorbeelden
Blob-opslag Trekker
Invoer
Uitvoer
Verbinden
Azure Cosmos DB Trekker
Invoer
Uitvoer
Verbinden
Azure SQL Trekker
Invoer
Uitvoer
Gebeurtenisgrid Trekker
Uitvoer
Verbinden
Evenement Hubs Trekker
Uitvoer
IoT-hub Trekker
Uitvoer
HTTP Trekker Verbinden
Wachtrij opslag Trekker
Uitvoer
Verbinden
RabbitMQ Trekker
Uitvoer
SendGrid Uitvoer
Dienstbus Trekker
Uitvoer
Verbinden
SignalR Trekker
Invoer
Uitvoer
Tabelopslag Invoer
Uitvoer
Tijdmeter Trekker Verbinden
Twilio Uitvoer Verbinden

Bindingscode voor Python is afhankelijk van de python-modelversie.

Dienst Voorbeelden Voorbeelden
Blob-opslag Trekker
Invoer
Uitvoer
Verbinden
Azure Cosmos DB Trekker
Invoer
Uitvoer
Verbinden
Azure-gegevensverkenner Invoer
Uitvoer
Azure SQL Trekker
Invoer
Uitvoer
Verbinden
Gebeurtenisgrid Trekker
Uitvoer
Verbinden
Evenement Hubs Trekker
Uitvoer
IoT-hub Trekker
Uitvoer
HTTP Trekker Verbinden
Wachtrij opslag Trekker
Uitvoer
Verbinden
RabbitMQ Trekker
Uitvoer
SendGrid Uitvoer
Dienstbus Trekker
Uitvoer
Verbinden
SignalR Trekker
Invoer
Uitvoer
Tabelopslag Invoer
Uitvoer
Tijdmeter Trekker Verbinden
Twilio Uitvoer Verbinden

Visual Studio Code

Wanneer u Visual Studio Code gebruikt om uw functie te ontwikkelen en uw functie een function.json-bestand gebruikt, kan de Azure Functions-extensie automatisch een binding toevoegen aan een bestaand function.json-bestand. Zie Invoer- en uitvoerbindingen toevoegen voor meer informatie.

Azure Portal

Wanneer u uw functies in Azure Portal ontwikkelt, voegt u invoer- en uitvoerbindingen toe op het tabblad Integreren voor een bepaalde functie. De nieuwe bindingen worden toegevoegd aan het function.json-bestand of aan de methodekenmerken, afhankelijk van uw taal. In de volgende artikelen ziet u voorbeelden van het toevoegen van bindingen aan een bestaande functie in de portal:

Volgende stappen