Compartilhar via


Saída de hubs de eventos do Azure Stream Analytics

Os serviço de Hubs de Eventos do Azure são um ingestor de eventos altamente escalonável de publicação/assinatura. Ele pode coletar milhões de eventos por segundo. Um uso de um hub de eventos como saída é quando a saída de um trabalho do Stream Analytics torna-se a entrada de outro trabalho de streaming. Para obter informações sobre o tamanho máximo da mensagem e a otimização do tamanho do lote, consulte a seção Tamanho do lote de saída.

Configuração de saída

A tabela a seguir tem os parâmetros necessários para configurar os fluxos de dados dos hubs de eventos como uma saída.

Nome da propriedade Descrição
Alias de saída Um nome amigável utilizado em consultas para direcionar a saída da consulta para esse hub de eventos.
Namespace do Hub de Eventos Um contêiner para um conjunto de entidades de mensagens. Quando você criou um novo hub de eventos, também criou um namespace do hub de eventos.
Nome do Hub de Eventos O nome da sua saída de hub de eventos.
Nome da política do hub de eventos A política de acesso compartilhado, que você pode criar na guia Configurar do hub de eventos. Cada política de acesso compartilhado tem um nome, as permissões definidas por você e as chaves de acesso.
Chave de política do hub de eventos A chave de acesso compartilhado que é usada para autenticar o acesso ao namespace do hub de eventos.
Coluna de chave da partição Opcional. Uma coluna contém a chave de partição para a saída do hub de eventos.
Formato de serialização do evento O formato de serialização para dados de saída. Há suporte para JSON, CSV e Avro.
Codificação Para CSV e JSON, UTF-8 é o único formato de codificação com suporte no momento.
Delimitador Aplicável somente à serialização de CSV. O Stream Analytics é compatível com vários delimitadores comuns para serialização de dados no formato CSV. Os valores com suporte são vírgula, ponto e vírgula, espaço, tab e barra vertical.
Formatar Aplicável somente à serialização de JSON. Uma Linha separada especifica que a saída é formatada com cada objeto JSON separado por uma nova linha. Se você selecionar Linha separada, o JSON será lido um objeto por vez. O conteúdo inteiro por si só não seria um JSON válido. A matriz especifica que a saída é formatada como uma matriz de objetos JSON.
Colunas da propriedade Opcional. Colunas separadas por vírgula que precisam ser anexadas como propriedades de usuário da mensagem de saída em vez do conteúdo. Há mais informações sobre esse recurso na seção Propriedades de metadados personalizadas para saída.

Particionamento

O particionamento varia dependendo do alinhamento da partição. Quando a chave de partição de saída do hub de eventos estiver alinhada de forma igual com a etapa de consulta (anterior) de upstream, o número de gravadores será o mesmo que o de partições na saída do hub de eventos. Cada gravador usa a classe EventHubSender para enviar eventos para a partição específica. Quando a chave de partição de saída do hub de eventos não é alinhada com a etapa de consulta (anterior) de upstream, o número de gravadores será o mesmo que o de partições nessa etapa anterior. Cada gravador usa a classe SendBatchAsync no EventHubClient para enviar eventos para todas as partições de saída.

Tamanho do lote de saída

O tamanho máximo da mensagem é 256 KB ou 1 MB por mensagem. Para obter mais informações, consulte Limites dos Hubs de Eventos. Quando o particionamento de entrada/saída não estiver alinhado, cada evento é compactado individualmente em um EventData e enviado em um lote com até o tamanho máximo da mensagem. Isso também ocorrerá se forem usadas propriedades de metadados personalizadas. Quando o particionamento de entrada/saída estiver alinhado, vários eventos serão compactados em uma única instância EventData com até o tamanho máximo da mensagem e serão enviados.

Personalizar propriedades de metadados para a saída

Você pode anexar colunas de consulta às suas mensagens de saída como propriedades de usuário. Essas colunas não entram no conteúdo. As propriedades estão presentes no formato de um dicionário na mensagem de saída. Chave é o nome da coluna e valor é o valor da coluna no dicionário de propriedades. Todos os tipos de dados do Stream Analytics têm suporte, exceto Registro e Matriz.

No exemplo a seguir, adicionamos os campos DeviceId e DeviceStatus aos metadados.

  1. Use a seguinte consulta:

    select *, DeviceId, DeviceStatus from iotHubInput
    
  2. Configure DeviceId,DeviceStatus como colunas de propriedade na saída.

    Colunas da propriedade

A imagem a seguir é das propriedades da mensagem de saída esperadas e inspecionadas no hub de eventos usando o Service Bus Explorer.

Propriedades personalizadas do evento

Entrega Exatamente Uma Vez

Por padrão, há suporte para exatamente uma entrega na saída do hub de eventos. Independentemente da entrada, o Stream Analytics garante que não haverá nenhuma perda de dados nem duplicata na saída do hub de eventos entre as reinicializações feitas pelo usuário na hora da última saída, impedindo que sejam produzidas duplicatas. Isso simplifica muito o pipeline de streaming, pois não é preciso monitorar, implementar e solucionar problemas da lógica de eliminação de duplicação.

Próximas etapas