триггеры и привязки Функции Azure

В этой статье вы узнаете о высокоуровневых понятиях, связанных с триггерами и привязками для функций.

Триггеры вызывают запуск функции. Триггер определяет, как вызывается функция, и функция должна иметь ровно один триггер. Триггеры также могут передавать данные в вашу функцию, аналогично вызовам методов.

Привязка к функции — это способ декларативного подключения функций к другим ресурсам. Привязки либо передают данные в функцию ( входную привязку), либо позволяют записывать данные из функции ( выходная привязка) с помощью параметров привязки. Триггер функции по сути является особым типом входной привязки.

Вы можете комбинировать привязки для достижения оптимального результата в конкретном сценарии функции. Привязки являются необязательными, а функция может иметь одну или несколько входных и/или выходных привязок.

Триггеры и привязки позволяют избежать жестко запрограммированного доступа к другим службам. Функция получает данные (например, содержимое сообщения из очереди) в параметрах функции. Вы отправляете данные (например, для создания сообщения в очереди) с помощью возвращаемого значения функции.

Рассмотрим следующие примеры реализации функций:

Пример сценария	Триггер	Входные привязки	Выходные привязки
В очередь поступает новое сообщение, которое запускает функцию для записи в другую очередь.	Очередь^*	Нет	Очередь^*
Запланированное задание считывает содержимое Хранилище BLOB-объектов Azure и создает новый документ Azure Cosmos DB.	Таймер	Хранилище блобов (Хранилище BLOB-объектов)	Azure Cosmos DB
Сетка событий Azure используется для чтения изображения из Хранилище BLOB-объектов и документа из Azure Cosmos DB для отправки сообщения электронной почты.	Сетка событий	Хранилище BLOB-объектов и Azure Cosmos DB	SendGrid

^* Представляет разные очереди.

Эти примеры не должны быть исчерпывающими, но они показывают, как можно использовать триггеры и привязки вместе. Более полный набор сценариев см. в разделе Функции Azure.

Подсказка

Функции Azure не требует использования входных и выходных привязок для подключения к службам Azure. Вы всегда можете создать в коде Azure SDK клиента и использовать его для передачи данных. Дополнительные сведения см. в разделе "Подключение к службам".

Определения триггеров и привязок

В следующем примере показана функция с триггером HTTP с выходной привязкой, которая записывает сообщение в очередь служба хранилища Azure.

Для функций библиотеки классов C# можно настроить триггеры и привязки путем декорирования методов и параметров атрибутами C#. Конкретный атрибут, который вы применяете, может зависеть от модели среды выполнения C#:

Изолированная рабочая модель
Модель внутрипроцессного процесса

Триггер HTTP (HttpTrigger) определен в методе Run для функции с именем HttpExample , возвращающей MultiResponse объект:

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

В этом примере показано MultiResponse определение объекта. Определение объекта возвращает HttpResponse в HTTP-запросе и записывает сообщение в очередь хранилища с помощью привязки QueueOutput.

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

Дополнительные сведения см. в руководстве по C# для изолированных рабочих моделей.

Триггер HTTP (HttpTrigger) определен в методе Run для функции с именем HttpExample. Эта функция записывает в очередь хранилища, которую определяют атрибуты Queue и StorageAccount на параметре msg.

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

Дополнительные сведения см. в руководстве по C# для моделей в процессе.

Устаревшие функции скрипта C# используют function.json файл определения. Дополнительные сведения см. в справочнике разработчика скриптов Функции Azure на C# (.csx).

Для функций Java можно настроить триггеры и привязки путем аннотирования определенных методов и параметров. HTTP-триггер @HttpTrigger определяется на методе run для функции с именем HttpExample. Функция записывает в очередь хранилища с именем outqueue, которая определяется аннотацией @QueueOutput на параметре msg:

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

Дополнительные сведения см. в руководстве разработчика Java.

Способ определения триггеров и привязок для функций Node.js зависит от конкретной версии Node.js для Функции Azure:

версия 4
версия 3

В Node.js для Функции Azure версии 4 можно настроить триггеры и привязки с помощью объектов, экспортированных из модуля @azure/functions. Дополнительные сведения см. в руководстве разработчика поNode.js.

версия 4
версия 3

Метод http экспортированного app объекта определяет триггер HTTP. Метод storageQueue определяет выходную привязку на этом триггере в output.

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

Этот пример function.json файла определяет функцию триггера HTTP, которая возвращает ответ HTTP и записывает в очередь хранилища:

{
  "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"
    }
  ]
}

версия 4
версия 3

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

{
  "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"
    }
  ]
}

Этот пример function.json файла определяет функцию:

    {
      "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"
    }
  ]
}

Дополнительные сведения см. в руководстве разработчика PowerShell.

Способ определения функции зависит от версии Python для Функции Azure:

версия 2
версия 1

В Python для Функции Azure версии 2 вы определяете функцию непосредственно в коде с помощью декораторов:

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

В Python для Функции Azure версии 1 в этом примере файл function.json определяет функцию триггера HTTP, которая возвращает http-ответ и записывает в очередь хранилища:

    {
      "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"
    }
  ]
}

Задача добавления привязок в функцию

Функцию можно подключить к другим службам с помощью входных или выходных привязок. Добавьте привязку, добавив в функцию определенные определения. Дополнительные сведения см. в статье Добавление привязок к существующей функции в Функции Azure.

Функции Azure поддерживает несколько привязок, которые должны быть настроены правильно. Например, функция может считывать данные из очереди (входная привязка) и записывать данные в базу данных (выходную привязку).

Поддерживаемые привязки

В этой таблице показаны привязки, поддерживаемые в основных версиях среды выполнения Функции Azure:

Тип	4.x¹	1.x²	Триггер	Ввод	Выходные данные
Хранилище BLOB-объектов	✔	✔	✔	✔	✔
Azure Cosmos DB	✔	✔	✔	✔	✔
Обозреватель данных Azure	✔			✔	✔
Azure SQL	✔		✔	✔	✔
Dapr⁴	✔		✔	✔	✔
Сетка событий	✔	✔	✔		✔
Центры событий	✔	✔	✔		✔
HTTP и веб-перехватчики	✔	✔	✔		✔
Центр IoT	✔	✔	✔
Kafka³	✔		✔		✔
Мобильные приложения		✔		✔	✔
Протокол контекста модели	✔		✔
Центры уведомлений		✔		✔
Хранилище очередей	✔	✔	✔		✔
Редис	✔		✔	✔	✔
RabbitMQ³	✔		✔		✔
SendGrid	✔	✔			✔
служебная шина	✔	✔	✔		✔
Служба Azure SignalR	✔		✔	✔	✔
Хранилище таблиц	✔	✔		✔	✔
Таймер	✔	✔	✔
Twilio	✔	✔			✔

Зарегистрируйте все привязки, кроме HTTP и таймера. См. Регистрация расширений привязок Функции Azure. Этот шаг не требуется при использовании среды выполнения Функций версии 1.x.
Support заканчивается для версии 1.x среды выполнения Функции Azure 14 сентября 2026. Перенос приложений в версию 4.x для полной поддержки.
Триггеры не поддерживаются в тарифном плане Consumption. Для этого типа привязки требуются триггеры, управляемые средой выполнения.
Этот тип привязки поддерживается только в Kubernetes, Azure IoT Edge и других автономных режимах.

Сведения о том, какие привязки находятся в предварительной версии или утверждены для использования в рабочей среде, см. поддерживаемые языки.

Определенные версии расширений привязки поддерживаются только в то время как поддерживается базовый пакет SDK службы. Изменения в поддержке в базовой версии пакета SDK службы влияют на поддержку используемого расширения.

Типы пакетов SDK

Расширения привязки Функции Azure используют SDK службы Azure для подключения к службам. Определенные типы пакетов SDK, используемые привязками, могут повлиять на работу с данными в функциях. Некоторые привязки поддерживают типы пакета SDK, обеспечивающие более широкие функциональные возможности и лучшую интеграцию со службой, а другие используют более универсальные типы, такие как строки или массивы байтов. Если они доступны, использование типов, специфичных для SDK, может обеспечить такие преимущества, как лучшая безопасность типов, более простая обработка данных и доступ к функциям, специфичным для службы.

В этой таблице указаны расширения привязки, которые в настоящее время поддерживают типы пакетов SDK:

Extension	Типы	Уровень поддержки
Хранилище BLOB-объектов Azure	`BlobClient` `BlobContainerClient` `BlockBlobClient` `PageBlobClient` `AppendBlobClient`	Триггер: GA Входные данные: GA (общедоступная версия)
Azure Cosmos DB	`CosmosClient` `Database` `Container`	Входные данные: GA (общедоступная версия)
Сетка событий Azure	`CloudEvent` `EventGridEvent`	Триггер: GA
Центры событий Azure	`EventData` `EventHubProducerClient`	Триггер: GA
Хранилище очередей Azure	`QueueClient` `QueueMessage`	Триггер: GA
Служебная шина Azure	`ServiceBusClient` `ServiceBusReceiver` `ServiceBusSender` `ServiceBusMessage`	Триггер: GA
Хранилище таблиц Azure	`TableClient` `TableEntity`	Входные данные: GA (общедоступная версия)

Рекомендации по типам пакета SDK:

При использовании выражений привязки, использующих данные триггера , нельзя использовать типы пакетов SDK для самого триггера.
В сценариях вывода, в которых можно использовать тип SDK, создайте и работайте с клиентами SDK напрямую, а не с помощью выходной привязки.
Триггер Azure Cosmos DB использует канал изменений Azure Cosmos DB и предоставляет элементы канала изменений в виде типов, сериализуемых в JSON. В результате типы SDK не поддерживаются этим триггером.

Дополнительные сведения см. в руководстве разработчика по пакетам SDK для C#.

Extension	Типы	Уровень поддержки	Образцы
Хранилище BLOB-объектов Azure	`BlobClient` `ContainerClient` `StorageStreamDownloader`	Триггер: GA Входные данные: GA (общедоступная версия)	Quickstart `BlobClient` `ContainerClient` `StorageStreamDownloader`
Azure Cosmos DB	`CosmosClient` `DatabaseProxy` `ContainerProxy`	Ввод: предварительный просмотр	Quickstart `ContainerProxy` `CosmosClient` `DatabaseProxy`
Центры событий Azure	`EventData`	Триггер: предварительная версия	Quickstart `EventData`
Служебная шина Azure	`ServiceBusReceivedMessage`	Триггер: предварительная версия	Quickstart `ServiceBusReceivedMessage`

Рекомендации по типам пакета SDK:

В сценариях вывода, в которых можно использовать тип SDK, создайте и работайте с клиентами SDK напрямую, а не с помощью выходной привязки.
Триггер Azure Cosmos DB использует канал изменений Azure Cosmos DB и предоставляет элементы канала изменений в виде типов, сериализуемых в JSON. В результате типы SDK не поддерживаются этим триггером.

Типы SDK поддерживаются только при использовании модели программирования Python версии 2. Дополнительные сведения см. в разделе SDK type bindings в руководстве разработчика Python.

Extension	Типы	Уровень поддержки
Хранилище BLOB-объектов Azure	`BlobClient` `ContainerClient` `ReadableStream`	Preview
Служебная шина Azure	`ServiceBusClient` `ServiceBusReceiver` `ServiceBusSender` `ServiceBusMessage`	Preview

Типы SDK поддерживаются только при использовании модели программирования Node версии 4. Дополнительные сведения см. в руководстве разработчика по пакету SDK Node.js.

Extension	Типы	Уровень поддержки
Хранилище BLOB-объектов Azure	`BlobClient` `BlobContainerClient`	Preview

Дополнительные сведения см. в разделе типы SDK в руководстве разработчика Java.

Это важно

Типы пакетов SDK в настоящее время не поддерживаются для приложений PowerShell.

Примеры кода для привязок

В следующей таблице приведены дополнительные примеры конкретных типов привязки, которые показывают, как работать с привязками в функциях. Сначала выберите вкладку языка, соответствующую проекту.

Код привязки для C# зависит от конкретной модели процесса.

Изолированный процесс
В процессе

Услуга	Примеры	Образцы
Хранилище блобов (Хранилище BLOB-объектов)	Trigger Входные данные Выходные данные	Link
Azure Cosmos DB	Trigger Входные данные Выходные данные	Link
Azure Data Explorer (Инструмент для анализа данных в Azure)	Входные данные Выходные данные	Link
Azure SQL	Trigger Входные данные Выходные данные	Link
Сетка событий	Trigger Выходные данные	Link
Центры событий	Trigger Выходные данные
Центр Интернета вещей	Trigger Выходные данные
HTTP	Trigger	Link
Хранилище очередей	Trigger Выходные данные	Link
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
служебная шина	Trigger Выходные данные	Link
Служба Azure SignalR	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger	Link
Twilio	Выходные данные	Link

Услуга	Примеры	Образцы
Хранилище блобов (Хранилище BLOB-объектов)	Trigger Входные данные Выходные данные	Link
Azure Cosmos DB	Trigger Входные данные Выходные данные	Link
Azure Data Explorer (Инструмент для анализа данных в Azure)	Входные данные Выходные данные	Link
Azure SQL	Trigger Входные данные Выходные данные	Link
Сетка событий	Trigger Выходные данные	Link
Центры событий	Trigger Выходные данные
Центр Интернета вещей	Trigger Выходные данные
HTTP	Trigger	Link
Хранилище очередей	Trigger Выходные данные	Link
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
служебная шина	Trigger Выходные данные	Link
Служба Azure SignalR	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger	Link
Twilio	Выходные данные	Link

Услуга	Примеры	Образцы
Хранилище блобов (Хранилище BLOB-объектов)	Trigger Входные данные Выходные данные	Link
Azure Cosmos DB	Trigger Входные данные Выходные данные	Link
Azure Data Explorer (Инструмент для анализа данных в Azure)	Входные данные Выходные данные	Link
Azure SQL	Trigger Входные данные Выходные данные
Сетка событий	Trigger Выходные данные	Link
Центры событий	Trigger Выходные данные
Центр Интернета вещей	Trigger Выходные данные
HTTP	Trigger	Link
Хранилище очередей	Trigger Выходные данные	Link
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
служебная шина	Trigger Выходные данные	Link
Служба Azure SignalR	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger	Link
Twilio	Выходные данные

Услуга	Примеры	Образцы
Хранилище блобов (Хранилище BLOB-объектов)	Trigger Входные данные Выходные данные	Link
Azure Cosmos DB	Trigger Входные данные Выходные данные	Link
Azure Data Explorer (Инструмент для анализа данных в Azure)	Входные данные Выходные данные
Azure SQL	Trigger Входные данные Выходные данные	Link
Сетка событий	Trigger Выходные данные
Центры событий	Trigger Выходные данные
Центр Интернета вещей	Trigger Выходные данные
HTTP	Trigger	Link
Хранилище очередей	Trigger Выходные данные	Link
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
служебная шина	Trigger Выходные данные	Link
Служба Azure SignalR	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger
Twilio	Выходные данные

Услуга	Примеры	Образцы
Хранилище блобов (Хранилище BLOB-объектов)	Trigger Входные данные Выходные данные
Azure Cosmos DB	Trigger Входные данные Выходные данные
Azure SQL	Trigger Входные данные Выходные данные
Сетка событий	Trigger Выходные данные
Центры событий	Trigger Выходные данные
Центр Интернета вещей	Trigger Выходные данные
HTTP	Trigger	Link
Хранилище очередей	Trigger Выходные данные
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
служебная шина	Trigger Выходные данные
Служба Azure SignalR	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger
Twilio	Выходные данные

Код привязки для Python зависит от версии модели Python.

версия 2
версия 1

Услуга	Примеры	Образцы
Хранилище блобов (Хранилище BLOB-объектов)	Trigger Входные данные Выходные данные	Link
Azure Cosmos DB	Trigger Входные данные Выходные данные	Link
Azure Data Explorer (Инструмент для анализа данных в Azure)	Входные данные Выходные данные
Azure SQL	Trigger Входные данные Выходные данные	Link
Сетка событий	Trigger Выходные данные
Центры событий	Trigger Выходные данные
Центр Интернета вещей	Trigger Выходные данные
HTTP	Trigger	Link
Хранилище очередей	Trigger Выходные данные
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
служебная шина	Trigger Выходные данные	Link
Служба Azure SignalR	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger
Twilio	Выходные данные

Услуга	Примеры	Образцы
Хранилище блобов (Хранилище BLOB-объектов)	Trigger Входные данные Выходные данные
Azure Cosmos DB	Trigger Входные данные Выходные данные
Azure Data Explorer (Инструмент для анализа данных в Azure)	Входные данные Выходные данные
Azure SQL	Trigger Входные данные Выходные данные	Link
Сетка событий	Trigger Выходные данные
Центры событий	Trigger Выходные данные
Центр Интернета вещей	Trigger Выходные данные
HTTP	Trigger
Хранилище очередей	Trigger Выходные данные
RabbitMQ	Trigger Выходные данные
SendGrid	Выходные данные
служебная шина	Trigger Выходные данные
Служба Azure SignalR	Trigger Входные данные Выходные данные
Хранилище таблиц	Входные данные Выходные данные
Таймер	Trigger
Twilio	Выходные данные

Пользовательские привязки

Вы можете создавать пользовательские входные и выходные привязки. Привязки должны создаваться в .NET, но их можно использовать на любом поддерживаемом языке. Дополнительные сведения о создании пользовательских привязок см. в разделе Создание пользовательских входных и выходных привязок.

Кері байланыс

Бет пайдалы болды ма?

Last updated on 2026-04-17