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

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

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

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

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

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

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

Пример сценария	Триггер	Входные привязки	Выходные привязки
В очередь поступает новое сообщение, которое запускает функцию для записи в другую очередь.	Очередь^*	Нет	Очередь^*
Запланированное задание считывает содержимое объектов Azure Blob Storage и создает новый документ в Azure Cosmos DB.	Таймер	Хранилище блобов	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 static MultiResponse Run([HttpTrigger(AuthorizationLevel.Function, "get", "post")] HttpRequestData req,
    FunctionContext executionContext)
{

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

public class MultiResponse
{
    [QueueOutput("outqueue",Connection = "AzureWebJobsStorage")]
    public string[] Messages { get; set; }
    public HttpResponseData 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 файл определения. Дополнительные сведения см. в справочнике разработчика по скрипту C# Функции Azure (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²	Триггер	Ввод	Выходные данные
Хранилище блобов	✔	✔	✔	✔	✔
Azure Cosmos DB	✔	✔	✔	✔	✔
Обозреватель данных Azure	✔			✔	✔
Azure SQL	✔		✔	✔	✔
Dapr⁴	✔		✔	✔	✔
Сетка событий	✔	✔	✔		✔
Центры событий	✔	✔	✔		✔
HTTP и веб-перехватчики	✔	✔	✔		✔
Центр IoT	✔	✔	✔
Kafka³	✔		✔		✔
Мобильные приложения		✔		✔	✔
Протокол контекста модели	✔		✔
Центры уведомлений		✔		✔
Хранилище очередей	✔	✔	✔		✔
Редис	✔		✔	✔	✔
RabbitMQ³	✔		✔		✔
SendGrid	✔	✔			✔
Служебная шина	✔	✔	✔		✔
Служба SignalR Azure	✔		✔	✔	✔
Хранилище таблиц	✔	✔		✔	✔
Таймер	✔	✔	✔
Twilio	✔	✔			✔

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

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

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

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

Расширения привязки Функций Azure используют пакеты SDK службы Azure для подключения к службам 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 (общедоступная версия)	Быстрый старт `BlobClient` `ContainerClient` `StorageStreamDownloader`
Azure Cosmos DB	`CosmosClient` `DatabaseProxy` `ContainerProxy`	Ввод: предварительный просмотр	Быстрый старт `ContainerProxy` `CosmosClient` `DatabaseProxy`
Центры событий Azure	`EventData`	Триггер: предварительная версия	Быстрый старт `EventData`
Сервисная шина Azure	`ServiceBusReceivedMessage`	Триггер: предварительная версия	Быстрый старт `ServiceBusReceivedMessage`

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

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

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

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

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

Это важно

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-12-17

Поделиться через