Adicionar uma fonte de banco de dados Azure Data Explorer a um fluxo de eventos (versão prévia)

Este artigo mostra como adicionar uma fonte de banco de dados Azure Data Explorer (BD) a um fluxo de eventos Microsoft Fabric. 

Azure Data Explorer é uma plataforma de alto desempenho totalmente gerenciada que fornece insights em tempo real de dados de streaming maciços. Você pode usar os eventstreams do Microsoft Fabric para se conectar a um banco de dados Azure Data Explorer, transmitir os dados de suas tabelas e roteá-los para vários destinos dentro do Microsoft Fabric.

Pré-requisitos

• Acesso ao espaço de trabalho premium do Fabric com permissões de Contribuidor ou superior.
• Uma assinatura de Azure ativa.
• Um cluster Azure Data Explorer com pelo menos um banco de dados implantado. Verifique se o cluster está acessível publicamente e não está restrito por um firewall ou uma rede virtual. Se ele residir em uma rede protegida, conecte-se a ela usando a injeção de rede virtual do conector Eventstream.
• As permissões necessárias para acessar o cluster Azure Data Explorer.

Adicionar um banco de dados Azure Data Explorer como uma origem

Se você ainda não adicionou nenhuma fonte ao fluxo de eventos, selecione o bloco Conectar fontes de dados . Você também pode selecionar Adicionar fonte>Conectar fontes de dados na faixa de opções.

Se você estiver adicionando a origem a um fluxo de eventos já publicado, alterne para modo de edição. Na faixa de opções, selecione Adicionar fonte>Conectar fontes de dados.

Na página Selecione uma fonte de dados, pesquise Azure Data Explorer BD. No painel Azure Data Explorer BD, selecione Conectar.

Configurar e conectar-se a um banco de dados Azure Data Explorer

1. Na página Definir configurações de conexão, selecione Nova conexão.

   

2. Na seção Configurações de conexão da janela pop-up, siga estas etapas:

   1. Para Cluster, insira o URI do cluster Azure Data Explorer.

   2. As caixas Banco de Dados e Nome da Tabela na conexão de nuvem são opcionais. Os valores inseridos nessas caixas são ignorados nesta etapa. Você pode especificá-los na próxima etapa do assistente.

      Observação

      O conector Eventstream do Azure Data Explorer atualmente não oferece suporte a consultas personalizadas. Qualquer consulta Azure Data Explorer especificada é ignorada

   3. Para Nome da conexão, insira um nome para a conexão com o cluster do Azure Data Explorer. 

   4. Para Tipo de autenticação, apenas conta organizacional é suportada no momento.

   5. Selecione Conectar.

   

3. Na página Definir configurações de conexão, siga estas etapas se você não especificou o banco de dados e as tabelas nas configurações de conexão anteriormente:

   1. Na caixa Banco de Dados , insira o nome do banco de dados.

   2. Na caixa Inserir nomes de tabela , insira um único nome de tabela ou vários nomes de tabela separados por vírgulas.

      

4. Se você estiver usando um hub em tempo real, siga estas etapas. Caso contrário, vá para a próxima etapa.

   1. Na seção Source details, selecione o workspace Fabric onde deseja salvar o fluxo de eventos.

   2. Para nome do eventstream, insira um nome para o eventstream. O assistente cria um fluxo de eventos com a tabela selecionada no Azure Data Explorer como fonte.

   3. O valor do nome do Stream é gerado automaticamente para você acrescentando -stream ao nome do fluxo de eventos. Você pode ver esse fluxo na página Todos os fluxos de dados do hub de dados em tempo real quando o assistente terminar.

      

Detalhes do fluxo ou da origem

1. Na página Conectar , siga uma destas etapas com base em se você está usando o Eventstream ou Real-Time hub.

   • Fluxo de eventos:

     No painel Detalhes da origem à direita, siga estas etapas:

     1. Para o nome da fonte, selecione o botão Lápis para alterá-lo.

     2. Observe que o Nome Eventstream e o Nome do Fluxo são somente leitura.

   • Real-Time hub:

     Na seção Detalhes de streaming à direita, siga estas etapas:

     1. Selecione o workspace Fabric em que deseja criar o fluxo de eventos.

     2. Para o nome do eventstream, selecione o botão Lápis e insira um nome para o eventstream.

     3. O valor do nome do Stream é gerado automaticamente para você acrescentando -stream ao nome do fluxo de eventos. Esse fluxo aparece na página Todos os fluxos de dados do hub em tempo real quando a execução do assistente é finalizada.

2. Selecione Avançar na parte inferior da página Configurar .

Revisar e conectar

Na tela Examinar + conectar, revise o resumo e selecione Adicionar (Fluxo de Eventos) ou Conectar (Hub em Tempo Real).

Exibir um fluxo de eventos atualizado

1. Confirme se a origem do banco de dados Azure Data Explorer foi adicionada ao fluxo de eventos na tela no modo Edit. Para implementar essa fonte de banco de dados Azure Data Explorer recém-adicionada, selecione Publish.

   

2. Sua fonte de banco de dados Azure Data Explorer está disponível para visualização na visualização Live. 

   

   Observação

   Quando o conector de streaming do Azure Data Explorer para banco de dados é iniciado, ele captura apenas as novas alterações na tabela. Os dados históricos da tabela não são transmitidos para o fluxo de eventos.

Limitações

O conector de streaming Azure Data Explorer captura as alterações de tabela usando um cursor de banco de dados para consultar as diferenças entre dois tempos de ingestão. No entanto, cada resultado da consulta é limitado a um máximo de 64 MB ou 500.000 registros. Para obter detalhes, consulte os limites de consulta Azure Data Explorer. Se o banco de dados Azure Data Explorer tiver uma taxa de ingestão alta que exceda esse limite, o conector poderá falhar.

Conteúdo relacionado

• Para saber como adicionar outras fontes a um fluxo de eventos, consulte Adicionar e gerenciar uma fonte de evento em um fluxo de eventos.