Partilhar via

Adicionar um ponto de extremidade personalizado ou uma fonte de aplicativo personalizada a um fluxo de eventos

Se quiser conectar seu próprio aplicativo a um fluxo de eventos, você pode adicionar um ponto de extremidade personalizado ou um aplicativo personalizado como fonte. Em seguida, pode enviar eventos em tempo real para o events stream da sua própria aplicação, utilizando o endpoint de ligação exposto no endpoint ou aplicação personalizada. Além disso, com o protocolo Apache Kafka disponível como uma opção para endpoints personalizados ou aplicativos personalizados, você pode enviar eventos em tempo real usando o protocolo Apache Kafka.

Este artigo mostra como adicionar um endpoint personalizado ou uma fonte de aplicação personalizada a um fluxo de eventos no 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

Antes de começar, certifique-se de que tem acesso à área de trabalho onde o seu fluxo de eventos está localizado. O espaço de trabalho deve estar na capacidade da estrutura ou no modo de avaliação.

  • Permissões de colaborador ou superiores são necessárias para editar a sequência de eventos para adicionar um ponto final personalizado.
  • Se você quiser usar a autenticação do Entra ID para conectar seu aplicativo, precisará de permissões de Membro ou superiores.

Se você estiver usando a autenticação do Entra ID, também precisará certificar-se de que a identidade gerenciada do ponto de extremidade personalizado tenha as permissões necessárias. Para fazer isso, defina as configurações necessárias no Portal de administração:

  1. Selecione Configurações (ícone de engrenagem) no canto superior direito.

  2. Selecione Portal de administração na seção Governança e informações .

    Captura de tela que mostra a seleção do link Portal de administração na seção Governança e informações.

  3. Ative a seguinte configuração de locatário para conceder à entidade de serviço acesso às Fabric APIs para criar espaços de trabalho, conexões ou pipelines de implantação.

    • Na página Configurações do locatário , na seção Configurações do desenvolvedor , expanda a opção A entidade de serviço pode usar a API de malha .
    • Mudar para Ativado.
    • Aplicar a toda a organização.
    • Selecione Aplicar.

    Captura de tela que mostra as configurações do desenvolvedor.

  4. Habilite essa opção para acessar todas as outras APIs (habilitadas por padrão para novos locatários):

    • Ainda na página Configurações do Inquilino, expanda a opção Permitir que principais de serviço criem e usem perfis.
    • Mudar para Ativado.
    • Aplicar a toda a organização.
    • Selecione Aplicar.

Nota

Um fluxo de eventos pode suportar até 11 fontes e destinos combinados ao usar os seguintes tipos:

  • Fontes: Azure Event Hubs, IoT Hub e endpoints personalizados.
  • Destinos: Pontos finais personalizados e Eventhouse com ingestão direta.

Quaisquer fontes ou destinos não incluídos na lista acima, e destinos não anexados ao fluxo padrão, não contam para esse limite.

Adicionar dados de ponto de extremidade personalizados como fonte

  1. Para adicionar uma fonte de ponto de extremidade personalizada, na página inicial, selecione Usar ponto de extremidade personalizado. Ou, se você já tiver um fluxo de eventos publicado e quiser adicionar dados de ponto de extremidade personalizados como fonte, alterne para o modo de edição. Na faixa de opções, selecione Adicionar fonte>Ponto de extremidade personalizado.

    Captura de tela da opção para usar um ponto de extremidade personalizado.

  2. Na caixa de diálogo Ponto de extremidade personalizado, insira um nome para a fonte personalizada em Nome da fonte, e selecione Adicionar.

    Captura de ecrã da caixa de diálogo para adicionar um endpoint personalizado.

  3. Depois de criar a origem personalizada do ponto final, ela é adicionada ao seu fluxo de eventos na interface no modo de edição. Para implementar os dados recém-adicionados da fonte do aplicativo personalizado, selecione Publicar.

    Captura de tela que mostra o fluxo de eventos no modo de edição, com o botão Publicar realçado.

Nota

Um fluxo de eventos pode suportar até 11 fontes e destinos combinados ao usar os seguintes tipos:

  • Fontes: Azure Event Hubs, IoT Hub e endpoints personalizados.
  • Destinos: Pontos finais personalizados e Eventhouse com ingestão direta.

Quaisquer fontes ou destinos não incluídos na lista acima, e destinos não anexados ao fluxo padrão, não contam para esse limite.

Obter detalhes do endpoint no painel de detalhes

Depois de criar uma fonte de ponto de extremidade personalizada, os seus dados ficam disponíveis para visualização em tempo real.

Captura de tela que mostra o fluxo de eventos na visualização ao vivo.

O painel Detalhes tem três guias de protocolo: Hub de Eventos, AMQP e Kafka. Cada guia de protocolo tem três páginas: Básico e Autenticação de Chave SAS. Estas páginas oferecem os detalhes do ponto final com o protocolo correspondente para conexão.

Básico mostra o nome, o tipo e o status do seu ponto de extremidade personalizado.

Captura de tela que mostra informações básicas no painel Detalhes da exibição ao vivo do fluxo de eventos.

A página Autenticação de Chave SAS fornece informações sobre chaves de conexão e também um link para o código de exemplo, com as chaves correspondentes incorporadas, que você pode usar para transmitir os eventos para seu fluxo de eventos. As informações na página Chaves variam de acordo com o protocolo.

Hub de eventos

A página de Autenticação de Chave SAS no separador Hub de Eventos contém informações relacionadas à cadeia de conexão de um hub de eventos. As informações incluem Nome do hub de eventos, Nome da chave de acesso compartilhado, Chave primária, Chave secundária, Cadeia de conexão-chave primária, Cadeia de conexão-chave secundária.

Captura de tela que mostra as principais informações no painel Detalhes do fluxo de eventos.

O formato do hub de eventos é o padrão para a cadeia de conexão e funciona com o SDK dos Hubs de Eventos do Azure. Esse formato permite que você se conecte ao seu fluxo de eventos por meio do protocolo Hubs de Eventos.

O exemplo a seguir mostra a aparência da cadeia de conexão no formato de hub de eventos:

Endpoint=sb://eventstream-xxxxxxxx.servicebus.windows.net/; SharedAccessKeyName=key_xxxxxxxx; SharedAccessKey=xxxxxxxx; EntityPath=es_xxxxxxx

Se você selecionar o botão Mostrar código de exemplo, verá o código Java pronto para uso que inclui as informações necessárias sobre chaves de conexão no hub de eventos. Copie e cole-o em seu aplicativo para uso.

Captura de tela que mostra o código de exemplo no painel Detalhes da exibição ao vivo do fluxo de eventos.

Protocolo AMQP (Advanced Message Queuing Protocol)

O formato AMQP é compatível com o protocolo AMQP 1.0, que é um protocolo de mensagens padrão que suporta a interoperabilidade entre várias plataformas e idiomas. Você pode usar esse formato para se conectar ao seu fluxo de eventos usando o protocolo AMQP.

Captura de tela que mostra as teclas AMQP no painel Detalhes da exibição ao vivo do fluxo de eventos.

Ao selecionar o botão Mostrar código de exemplo, você vê o código Java pronto para uso com informações de chave de conexão no formato AMQP.

Captura de tela que mostra o código de exemplo AMQP no painel Detalhes da exibição ao vivo do fluxo de eventos.

Kafka

O formato Kafka é compatível com o protocolo Apache Kafka, que é uma popular plataforma de streaming distribuído que suporta processamento de dados de alta taxa de transferência e baixa latência. Você pode usar as informações de Autenticação de Chave SAS no formato de protocolo Kafka para se conectar ao seu fluxo de eventos e transmitir os eventos.

Captura de tela que mostra as teclas Kafka no painel Detalhes da visualização ao vivo do fluxo de eventos.

Ao selecionar o botão Mostrar código de exemplo, você verá o código Java pronto para uso, incluindo as chaves de conexão necessárias no formato Kafka. Copie-o para seu uso.

Captura de tela que mostra o código de exemplo de Kafka no painel Detalhes da exibição ao vivo do fluxo de eventos.

Para obter um guia claro sobre como usar o endpoint personalizado com o protocolo Kafka, consulte este tutorial. Fornece passos detalhados para streaming e consumo de eventos através do endpoint personalizado usando o protocolo Kafka.

Nota

  • Você pode escolher o formato de protocolo que atenda às necessidades e preferências do seu aplicativo e, em seguida, copiar e colar a cadeia de conexão em seu aplicativo. Você também pode consultar ou copiar o código de exemplo, que mostra como enviar ou receber eventos usando vários protocolos.
  • Para sair da visualização de código de exemplo, selecione Ocultar código de exemplo.

Conteúdos relacionados

Para obter uma lista de fontes suportadas, consulte Adicionar uma fonte de evento em um fluxo de eventos

Pré-requisitos

  • Acesso a um espaço de trabalho no modo de licença de capacidade do Fabric ou no modo de licença de teste, com permissões de Colaborador ou superiores.
  • Se você não tiver um eventstream, crie um eventstream.

Adicionar um aplicativo personalizado como fonte

Se quiser conectar seu próprio aplicativo a um fluxo de eventos, você pode adicionar uma fonte de aplicativo personalizada. Em seguida, envie dados para o fluxo de eventos do seu próprio aplicativo com o endereço final de conexão exposto no app customizado.

Para adicionar uma fonte de aplicativo personalizada:

  1. Selecione Nova fonte na faixa de opções ou o sinal de adição (+) na tela principal do editor e, em seguida, selecione Aplicativo personalizado.

  2. No painel Aplicativo personalizado, insira um nome de origem para o aplicativo personalizado e selecione Adicionar.

    Captura de tela que mostra o painel para configurar um aplicativo personalizado como origem.

Obter detalhes do ponto final no painel Detalhes para enviar eventos

Depois de criar com êxito o aplicativo personalizado como uma fonte, você pode exibir as informações no painel Detalhes .

O painel Detalhes tem três guias de protocolo: Hub de Eventos, AMQP e Kafka. Cada guia de protocolo contém três páginas: Básico, Autenticação de chave SAS e Autenticação de ID do Entra. Estas páginas fornecem informações de ponto final específicas para o protocolo selecionado. Captura de tela que mostra uma fonte de aplicativo personalizada.

  • A página Básico mostra o nome, o tipo e o status do seu ponto de extremidade personalizado.

Captura de tela que mostra informações básicas para um aplicativo personalizado no painel Detalhes de um fluxo de eventos.

  • A Autenticação de Chave SAS e a Autenticação de ID Entra são dois métodos de autenticação suportados para ligar à sua aplicação:
    • A Autenticação de Chave SAS fornece as informações necessárias para produzir e consumir dados de fluxo de eventos usando chaves SAS (Assinatura de Acesso Compartilhado).
    • A Autenticação de ID do Entra permite que uma entidade de segurança (como um usuário ou entidade de serviço) consuma dados do Eventstream usando a autenticação do Microsoft Entra ID.

Para conhecer as etapas para usar a Autenticação de ID do Entra, consulte Habilitar a Autenticação de ID do Entra para um Aplicativo no Eventstream.
A seção a seguir descreve como se conectar a um destino de ponto de extremidade personalizado usando a Autenticação de Chave SAS.

Hub de eventos

A página Chaves no separador Hub de Eventos contém informações relacionadas à cadeia de conetividade de um hub de eventos. As informações incluem Nome do hub de eventos, Nome da chave de acesso compartilhado, Chave primária e Cadeia de conexão-chave primária.

Captura de tela que mostra as principais informações no painel Detalhes do fluxo de eventos.

O formato do hub de eventos é o padrão para a cadeia de conexão e funciona com o SDK dos Hubs de Eventos do Azure. Esse formato permite que você se conecte ao seu fluxo de eventos por meio do protocolo Hubs de Eventos.

O exemplo a seguir mostra a aparência da cadeia de conexão no formato de hub de eventos:

Endpoint=sb://eventstream-xxxxxxxx.servicebus.windows.net/; SharedAccessKeyName=key_xxxxxxxx; SharedAccessKey=xxxxxxxx; EntityPath=es_xxxxxxx

Selecione Mostrar botão de código de exemplo na página Hub de Eventos para obter o código pronto para uso que inclui as informações necessárias sobre chaves de conexão no hub de eventos. Basta copiá-lo e colá-lo em seu aplicativo para uso.

Captura de tela que mostra o código de exemplo no painel Detalhes do fluxo de eventos.

Kafka

O formato Kafka é compatível com o protocolo Apache Kafka, que é uma popular plataforma de streaming distribuído que suporta processamento de dados de alta taxa de transferência e baixa latência. Você pode usar as informações de Chaves e código de exemplo para o formato do protocolo Kafka para se conectar ao seu fluxo de eventos e fazer o streaming dos eventos.

Captura de tela que mostra as teclas Kafka no painel Detalhes do fluxo de eventos.

Selecione Mostrar botão de código de exemplo na página Kafka para obter código pronto, incluindo as chaves de conexão necessárias no formato Kafka. Basta copiá-lo para seu uso.

Captura de tela que mostra o código de exemplo de Kafka no painel Detalhes do fluxo de eventos.

AMQP

O formato AMQP é compatível com o protocolo AMQP 1.0, que é um protocolo de mensagens padrão que suporta a interoperabilidade entre várias plataformas e idiomas. Você pode usar esse formato para se conectar ao seu fluxo de eventos usando o protocolo AMQP.

Captura de tela que mostra as teclas AMQP no painel Detalhes do fluxo de eventos.

Selecione Mostrar botão de código de exemplo na página AMQP para obter código pronto para uso com informações de chave de conexão no formato AMQP.

Captura de tela que mostra o código de exemplo AMQP no painel Detalhes do fluxo de eventos.

Você pode escolher o formato de protocolo que atenda às necessidades e preferências do seu aplicativo e, em seguida, copiar e colar a cadeia de conexão em seu aplicativo. Você também pode consultar ou copiar o código de exemplo na página Código de exemplo , que mostra como enviar ou receber eventos usando vários protocolos.

Conteúdos relacionados

Para saber como adicionar outras fontes a um fluxo de eventos, consulte os seguintes artigos: