Gatilho e associações de Hubs de Eventos do Azure para o Azure Functions

Este artigo explica como trabalhar com associações de Hubs de Eventos do Azure para o Azure Functions. O Azure Functions dá suporte a associações de gatilho e de saída para os Hubs de Eventos.

Ação Tipo
Responda a eventos enviados a um fluxo de eventos do hub de eventos. Gatilho
Gravar eventos em um fluxo de eventos Associação de saída

Adicione ao seu aplicativo Functions

Funções 2.x e posteriores

Trabalhar com o gatilho e as ligações requer que você consulte o pacote apropriado. O pacote NuGet é utilizado para bibliotecas de classes .NET, enquanto o pacote de extensão é usado para todos os outros tipos de aplicativos.

Idioma Adicionar por... Comentários
C# Instalação do pacote NuGet, versão 3.x
Script C#, Java, JavaScript, Python, PowerShell Registro do pacote de extensão A extensão de Ferramentas do Azure é recomendada para uso com o Visual Studio Code.
Script C# (apenas online no portal do Azure) Adição de uma associação Para atualizar as extensões de associação existentes sem ter que republicar seu aplicativo de funções, confira Atualizar suas extensões.

Extensão de hubs de eventos 5.x e superior

Uma nova versão da extensão de associações de hubs de eventos está disponível como um pacote NuGet de visualização. Essa visualização apresenta a capacidade de se conectar usando uma identidade em vez de um segredo. Para aplicativos .NET, ele também altera os tipos aos quais você se pode associar, substituindo os tipos de Microsoft.Azure.EventHubs por tipos mais novos do Azure. Messaging. EventHubs.

Observação

O pacote de visualização não está incluído em um pacote de extensão e deve ser instalado manualmente. Para aplicativos .NET, adicione uma referência ao pacote. Para todos os outros tipos de aplicativos, consulte Atualizar suas extensões.

Funções 1.x

Os aplicativos do Functions 1.x têm automaticamente uma referência ao pacote NuGet Microsoft.Azure.Webjobs, versão 2. x.

configurações de host.json

O arquivo host.json contém configurações que controlam o comportamento de gatilho dos Hubs de Eventos. A configuração é diferente dependendo da versão do Azure Functions.

Funções 2.x e posteriores

{
    "version": "2.0",
    "extensions": {
        "eventHubs": {
            "batchCheckpointFrequency": 5,
            "eventProcessorOptions": {
                "maxBatchSize": 256,
                "prefetchCount": 512
            },
            "initialOffsetOptions": {
                "type": "fromStart",
                "enqueuedTimeUtc": ""
            }
        }
    }
}  
Propriedade Padrão Descrição
batchCheckpointFrequency 1 O número de lotes de eventos para processar antes de criar um ponto de verificação do cursor do EventHub.
eventProcessorOptions/maxBatchSize 10 A contagem máxima de eventos recebidos por loop de recebimento.
eventProcessorOptions/prefetchCount 300 A contagem da pré-busca padrão usada pelo EventProcessorHost subjacente. O valor mínimo permitido é 10.
initialOffsetOptions/type1 fromStart O local no fluxo de eventos do qual iniciar o processamento quando um ponto de verificação não existir no armazenamento. As opções são fromStart, fromEnd ou fromEnqueuedTime. O fromEnd processa novos eventos que foram enfileirados depois que o aplicativo de funções começou a ser executado. Aplica-se a todas as partições. Para obter mais informações, consulte a documentação do EventProcessorOptions.
initialOffsetOptions/enqueuedTimeUtc1 N/D Especifica o tempo de enfileiramento do evento no fluxo do qual iniciar o processamento. Quando initialOffsetOptions/type é configurado como fromEnqueuedTime, essa configuração é obrigatória. Compatível com hora em qualquer formato com suporte do DateTime.Parse(), como 2020-10-26T20:31Z. Para maior clareza, você também deve especificar um fuso horário. Quando o fuso horário não é especificado, o Functions assume o fuso horário local do computador que está executando o aplicativo de funções, que é o UTC quando executado no Azure. Para obter mais informações, consulte a documentação do EventProcessorOptions.

1 O suporte para intitialOffsetOptions começa com o EventHubs v4.2.0.

Observação

Para obter uma referência de host.json no Azure Functions 2.x e posterior, confira Referência de host.json para o Azure Functions.

Funções 1.x

{
    "eventHub": {
      "maxBatchSize": 64,
      "prefetchCount": 256,
      "batchCheckpointFrequency": 1
    }
}
Propriedade Padrão Descrição
maxBatchSize 64 A contagem máxima de eventos recebidos por loop de recebimento.
prefetchCount n/a A pré-busca padrão que será usada pelo EventProcessorHost subjacente.
batchCheckpointFrequency 1 O número de lotes de eventos para processar antes de criar um ponto de verificação do cursor do EventHub.

Observação

Para obter uma referência de host.json no Azure Functions 1.x, confira Referência de host.json para o Azure Functions 1.x.

Próximas etapas