Partilhar via


Adicionar um destino Eventhouse a um fluxo de eventos

Este artigo mostra como adicionar um Eventhouse como destino a um fluxo de eventos em fluxos de eventos do Microsoft Fabric.

Nota

Os recursos aprimorados são habilitados por padrão quando você cria fluxos de eventos agora. Se você tiver fluxos de eventos que foram criados usando recursos padrão, esses fluxos de eventos continuarão a funcionar. Você ainda pode editá-los e usá-los como de costume. Recomendamos que você crie um novo fluxo de eventos para substituir fluxos de eventos padrão para que possa aproveitar os recursos e benefícios adicionais dos fluxos de eventos aprimorados.

Pré-requisitos

  • Acesso a um espaço de trabalho no modo de licença de capacidade de malha (ou) no modo de licença de avaliação com permissões de Colaborador ou superiores.
  • Acesso a um Eventhouse criado em um espaço de trabalho do Fabric onde você tem permissões de Colaborador ou superiores.

Nota

O número máximo de fontes e destinos para um eventstream é 11.

Adicionar uma Eventhouse como destino

Para adicionar uma Eventhouse como destino, você pode escolher entre dois modos de ingestão: Ingestão direta ou Processamento de eventos antes da ingestão.

Modo de ingestão direta

O modo de ingestão direta ingere os dados do seu evento diretamente na Eventhouse sem qualquer processamento. Você pode usar o modo de ingestão direta para adicionar um destino Eventhouse ao seu fluxo padrão.

Importante

Você pode usar a ingestão direta apenas para seu fluxo padrão. A ingestão direta não pode seguir operadores de processamento ou fluxos derivados. Se desejar adicionar um destino de evento após o processamento de operadores ou de fluxos derivados, utilize Processamento de eventos antes da ingestão.

  1. No modo de Edição do seu fluxo de eventos, selecione Adicionar destino no friso ou selecione Transformar eventos ou adicionar cartão de destino na tela e, em seguida, selecione Casa de Eventos.

    Uma captura de tela da seleção de Eventhouse na lista suspensa Adicionar destino.

  2. Na tela Eventhouse, selecione Ingestão direta.

  3. Insira um nome de Destino, um Espaço de Trabalhoe um Eventhouse a partir do espaço de trabalho selecionado.

  4. Selecione Guardar.

    Uma captura de tela da tela de configuração do Eventhouse.

  5. Conecte o novo cartão de destino do Eventhouse à saída do seu fluxo de eventos, se ainda não estiver conectado, e selecione Publicar.

    Uma captura de tela do fluxo de eventos com o botão Publicar realçado.

  6. Em Visualização dinâmica, selecione Configurar no nó de destino da Casa de Eventos.

    Uma captura de tela do fluxo de eventos publicado com o botão Configurar no destino do Banco de Dados KQL realçado.

  7. O seu Eventhouse abre no ecrã Obter dados. Selecione uma tabela existente do banco de dados KQL ou selecione Nova tabela para criar uma nova tabela para rotear e ingerir os dados.

  8. Forneça um nome de conexão de dados ou mantenha o nome fornecido e selecione Avançar. Pode levar alguns minutos para extrair dados do fluxo de eventos.

    Uma captura de tela da tela Obter dados para o destino do banco de dados KQL, com o botão Avançar realçado.

  9. Na tela Inspecionar os dados, você pode:

    • Selecione um Formato para visualizar como os dados são enviados para a sua Casa de Eventos.
    • Selecione Editar colunas para configurar as colunas para seus dados.
    • Selecione Avançado para selecionar eventos a serem incluídos ou escolher opções de mapeamento.

    Uma captura de tela mostrando os formatos de dados e as opções avançadas na tela Inspecionar os dados.

  10. Se você selecionar Editar colunas, na tela Editar colunas, poderá:

    • Selecione Adicionar coluna para adicionar uma coluna.
    • Selecione Colunas de origem para mapear.
    • Aplique a transformação de mapeamento a colunas.
    • Altere os valores de dados de exemplo.

    Em seguida, selecione Aplicar.

    Uma captura de tela da tela Editar colunas.

  11. Quando terminar de configurar os dados, selecione Concluir na tela Inspecionar os dados .

  12. No ecrã Resumo, reveja os detalhes e o estado da ingestão de dados, incluindo a tabela com o esquema que definiu e a ligação entre o fluxo de eventos e o Eventhouse. Selecione Fechar para finalizar a configuração do Eventhouse.

    Uma captura de tela da tela Resumo com o botão Fechar realçado.

Agora você pode ver o destino da Eventhouse na tela em Visualização dinâmica.

Uma captura de tela do destino do Banco de Dados KQL configurado na Visualização dinâmica.

Processamento de eventos antes da ingestão

O processamento de eventos antes do modo de ingestão processa os dados do evento antes de ingeri-los na Eventhouse. Use esse modo se você aplicar operadores como filtragem ou agregação para processar os dados antes da ingestão ou após um fluxo derivado.

  1. No modo Edição para seu fluxo de eventos, passe o mouse sobre um operador ou fluxo derivado, selecione +e, em seguida, selecione Eventhouse .

    Uma captura de tela da seleção do símbolo + para a saída do operador e da seleção do Banco de Dados KQL.

  2. Na tela Eventhouse, Processamento de eventos antes da ingestão já deve estar selecionado. Preencha o restante das informações sobre sua Eventhouse e selecione Salvar.

    Uma captura de tela da tela de configuração do Banco de Dados KQL para Processamento de eventos antes da ingestão.

  3. Para implementar o destino Eventhouse recém-adicionado, selecione Publicar.

    Uma captura de tela do fluxo de eventos no modo de edição com o destino do banco de dados KQL adicionado.

Depois de concluir estas etapas, o eventstream com destino Eventhouse estará disponível para consulta na visualização ao vivo .

Uma captura de tela do fluxo de processamento de eventos do Banco de Dados KQL configurado na Visualização dinâmica.

Para saber como adicionar outros destinos a um fluxo de eventos, consulte os seguintes artigos:

Pré-requisitos

Antes de começar, você deve preencher os seguintes pré-requisitos:

  • Acesso a um espaço de trabalho no modo de licença de capacidade de malha (ou) no modo de licença de avaliação com permissões de Colaborador ou superiores.
  • Acesso ao espaço de trabalho com permissões de Colaborador ou superior onde seu banco de dados KQL está localizado.

Nota

O número máximo de fontes e destinos para um eventstream é 11.

Adicionar um banco de dados KQL como destino

Para adicionar um banco de dados KQL como destino, você precisa ter um banco de dados KQL criado no espaço de trabalho e escolher entre dois modos de ingestão: Ingestão direta e Processamento de eventos antes da ingestão.

Ingestão direta

Esse modo ingere os dados do evento diretamente no banco de dados KQL sem qualquer processamento. Você pode usar esse modo se quiser ingerir os dados do evento no estado em que se encontram e executar qualquer processamento ou transformação posteriormente no banco de dados KQL usando consultas KQL.

  1. Selecione Novo destino na faixa de opções ou "+" na tela principal do editor e, em seguida, selecione Banco de Dados KQL. A tela de configuração de destino do banco de dados KQL é exibida.

  2. Selecione Ingestão direta, insira um nome de destino, selecione um espaço de trabalho, escolha um banco de dados KQL no espaço de trabalho selecionado e, em seguida, selecione Adicionar e configurar.

    Nota

    Você só pode selecionar espaços de trabalho que tenham a mesma capacidade de malha de região que o fluxo de eventos.

    Captura de tela da tela de configuração de destino do modo de pull do banco de dados KQL.

  3. Na página Obter dados, navegue pelas guias para concluir a configuração:

    1. Configurar: use uma tabela existente do seu banco de dados KQL ou crie uma nova para rotear e ingerir os dados. Preencha os campos obrigatórios e selecione Avançar.

      Captura de tela mostrando a guia Destino da tela Ingestão de dados para criar um destino de banco de dados KQL.

    2. Inspecionar: selecione um formato de dados e visualize como os dados são enviados para o banco de dados KQL.

      Captura de tela mostrando o formato de dados da tela Ingest data para criar um destino de banco de dados KQL.

      Você também pode alterar o nome da coluna, o tipo de dados ou a coluna de atualização clicando na seta no cabeçalho da tabela. Preencha os campos obrigatórios e selecione Concluir.

      Captura de tela mostrando como alterar a coluna da tela Ingest data para criar um destino de banco de dados KQL.

      Captura de tela mostrando a alteração do nome da coluna, tipo de dados da tela Ingest data para criar um destino de banco de dados KQL.

    3. Resumo: Revise o status da ingestão de dados, incluindo a tabela criada com o esquema definido e a conexão entre o fluxo de eventos e o banco de dados KQL.

      Captura de tela mostrando a guia Resumo da tela Ingestão de dados para criar um destino de banco de dados KQL.

  4. Depois de configurar tudo e selecionar Fechar, um destino de banco de dados KQL aparece na tela, conectado ao seu fluxo de eventos.

    Captura de tela mostrando o novo destino do modo de extração do banco de dados KQL.

Processamento de eventos antes da ingestão

Esse modo processa os dados do evento antes de ingeri-los no banco de dados KQL. Você pode usar esse modo se quiser aplicar algum processamento ou transformação aos dados do evento antes de ingeri-los, como filtrar, agregar ou expandir. Você pode projetar a lógica de processamento usando o processador de eventos.

  1. Selecione Processamento de eventos antes da ingestão, complete as informações sobre seu banco de dados KQL e selecione Abrir processador de eventos.

    Captura de tela da tela de configuração de destino do modo push do banco de dados KQL.

  2. Projete o processamento de eventos com o processador de eventos e selecione Salvar

    Captura de ecrã do ecrã do processador de eventos do modo push.

  3. Quando você escolhe uma tabela Kusto existente, a validação de esquema entre o esquema atual neste fluxo de eventos e a tabela KQL de destino é executada. Se os dois esquemas não forem correspondidos, uma mensagem de erro será mostrada e lembrará você de abrir o processador de eventos para ajustar o esquema nesse fluxo de eventos de acordo.

    Captura de tela da tela de erro do processador de eventos do modo push.

    Quando você abre o processador de eventos, as informações detalhadas de incompatibilidade são mostradas na guia Erro de criação.

    Captura de tela da tela de informações de incompatibilidade do processador de eventos do modo push.

  4. Depois de configurar tudo e selecionar Salvar, um destino de banco de dados KQL aparece na tela, conectado ao seu fluxo de eventos, e você pode verificar as métricas nos logs e insights de dados nos logs de tempo de execução.

    Captura de tela mostrando o novo destino do modo push do banco de dados KQL.

Gerir um destino

Editar/remover: você pode editar ou remover um destino de fluxo de eventos por meio do painel de navegação ou da tela.

Quando você seleciona Editar, o painel de edição é aberto no lado direito do editor principal. Você pode modificar a configuração como desejar, incluindo a lógica de transformação de eventos por meio do editor do processador de eventos.

Captura de tela mostrando onde selecionar as opções de modificação e exclusão para destinos na tela.

Para saber como adicionar outros destinos a um fluxo de eventos, consulte os seguintes artigos: