Partilhar via


Capture dados de Hubs de Eventos no formato Delta Lake

Este artigo explica como usar o editor sem código para capturar automaticamente dados de streaming em Hubs de Eventos em uma conta do Azure Data Lake Storage Gen2 no formato Delta Lake.

Pré-requisitos

  • Seus Hubs de Eventos do Azure e recursos do Azure Data Lake Storage Gen2 devem estar acessíveis publicamente e não podem estar protegidos em um firewall ou protegidos em uma Rede Virtual do Azure.
  • Os dados em seus Hubs de Eventos devem ser serializados no formato JSON, CSV ou Avro.

Configurar um trabalho para capturar dados

Use as etapas a seguir para configurar um trabalho do Stream Analytics para capturar dados no Azure Data Lake Storage Gen2.

  1. No portal do Azure, navegue até o hub de eventos.

  2. Selecione Recursos>processar dados e selecione Iniciar na captura de dados para ADLS Gen2 no cartão de formato Delta Lake.
    Captura de tela mostrando os cartões de início de dados dos Hubs de Eventos de Processo.

    Como alternativa, selecione Captura de recursos>e selecione a opção Delta Lake em "Formato de serialização de eventos de saída" e, em seguida, selecione Iniciar configuração de captura de dados. Captura de tela mostrando o ponto de entrada da criação de dados de captura.

  3. Insira um nome para identificar seu trabalho do Stream Analytics. Selecione Criar.
    Captura de tela mostrando a janela de trabalho do New Stream Analytics onde você insere o nome do trabalho.

  4. Especifique o tipo de serialização de seus dados nos Hubs de Eventos e o método de Autenticação que o trabalho usa para se conectar aos Hubs de Eventos. Em seguida, selecione Conectar. Captura de tela mostrando a configuração de conexão dos Hubs de Eventos.

  5. Quando a conexão é estabelecida com êxito, você vê:

    • Campos que estão presentes nos dados de entrada. Você pode escolher Adicionar campo ou selecionar o símbolo de três pontos ao lado de um campo para, opcionalmente, remover, renomear ou alterar seu nome.
    • Uma amostra dinâmica de dados de entrada na tabela de visualização de dados sob o modo de exibição de diagrama. Refresca-se periodicamente. Você pode selecionar Pausar visualização de streaming para exibir uma exibição estática da entrada de exemplo.
      Captura de ecrã a mostrar dados de exemplo em Pré-visualização de Dados.
  6. Selecione o bloco Azure Data Lake Storage Gen2 para editar a configuração.

  7. Na página de configuração do Azure Data Lake Storage Gen2 , siga estas etapas:

    1. Selecione a assinatura, o nome da conta de armazenamento e o contêiner no menu suspenso.

    2. Depois que a assinatura for selecionada, o método de autenticação e a chave da conta de armazenamento deverão ser preenchidos automaticamente.

    3. Para o caminho da tabela Delta, ele é usado para especificar o local e o nome da tabela Delta Lake armazenada no Azure Data Lake Storage Gen2. Você pode optar por usar um ou mais segmentos de caminho para definir o caminho para a tabela delta e o nome da tabela delta. Para saber mais, consulte a tabela Escrever no Delta Lake.

    4. Selecione Ligar.

      Primeira captura de tela mostrando a janela Blob onde você edita a configuração de conexão de um blob.

  8. Quando a conexão é estabelecida, você vê campos que estão presentes nos dados de saída.

  9. Selecione Salvar na barra de comandos para salvar sua configuração.

  10. Selecione Iniciar na barra de comandos para iniciar o fluxo de streaming para capturar dados. Em seguida, na janela de trabalho Start Stream Analytics:

    1. Escolha a hora de início da saída.
    2. Selecione o número de unidades de streaming (SU) com as quais o trabalho é executado. SU representa os recursos de computação alocados para executar um trabalho do Stream Analytics. Para obter mais informações, consulte Unidades de streaming no Azure Stream Analytics.
      Captura de tela mostrando a janela de trabalho do Start Stream Analytics onde você define a hora de início da saída, as unidades de streaming e o tratamento de erros.
  11. Depois de selecionar Iniciar, o trabalho começa a ser executado em dois minutos e as métricas serão abertas na seção da guia, conforme mostrado na imagem a seguir. Captura de tela mostrando o gráfico de métricas.

  12. O novo trabalho pode ser visto na guia Trabalhos do Stream Analytics.Captura de tela mostrando o link Métricas abertas selecionado.

Verificar a saída

Verifique se os arquivos de parquet com o formato Delta lake são gerados no contêiner do Armazenamento do Azure Data Lake.

Captura de tela mostrando os arquivos Parquet gerados no contêiner do Azure Data Lake Storage (ADLS).

Considerações ao usar o recurso de replicação geográfica de Hubs de Eventos

Os Hubs de Eventos do Azure lançaram recentemente o recurso de Replicação Geográfica na visualização pública. Esse recurso é diferente do recurso de Recuperação de Desastres Geográficos dos Hubs de Eventos do Azure.

Quando o tipo de failover é Forçado e a consistência da replicação é assíncrona, o trabalho do Stream Analytics não garante exatamente uma saída para uma saída dos Hubs de Eventos do Azure.

O Azure Stream Analytics, como produtor com um hub de eventos uma saída, pode observar atraso de marca d'água no trabalho durante a duração do failover e durante a limitação pelos Hubs de Eventos caso o atraso de replicação entre primário e secundário atinja o atraso máximo configurado.

O Azure Stream Analytics, como consumidor com Hubs de Eventos como Entrada, pode observar atraso de marca d'água no trabalho durante a duração do failover e pode ignorar dados ou localizar dados duplicados após a conclusão do failover.

Devido a essas ressalvas, recomendamos que você reinicie o trabalho do Stream Analytics com a hora de início apropriada logo após a conclusão do failover dos Hubs de Eventos. Além disso, como o recurso de replicação geográfica dos Hubs de Eventos está em visualização pública, não recomendamos o uso desse padrão para trabalhos do Stream Analytics de produção neste momento. O comportamento atual do Stream Analytics melhorará antes que o recurso de replicação geográfica dos Hubs de Eventos esteja disponível em geral e possa ser usado em trabalhos de produção do Stream Analytics.

Próximos passos

Agora você sabe como usar o editor sem código do Stream Analytics para criar um trabalho que captura dados de Hubs de Eventos para o Azure Data Lake Storage Gen2 no formato Delta lake. Em seguida, você pode saber mais sobre o Azure Stream Analytics e como monitorar o trabalho que você criou.