Adicionar um ponto de extremidade personalizado ou destino de aplicativo personalizado 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 destino. Em seguida, você pode consumir eventos em tempo real do fluxo de eventos para seu próprio aplicativo com o ponto de extremidade de conexão exposto no ponto de extremidade personalizado ou no aplicativo personalizado. Além disso, com o protocolo Apache Kafka disponível como uma opção para endpoints personalizados ou aplicativos personalizados, você pode consumir eventos em tempo real usando o protocolo Apache Kafka.
Este artigo mostra como adicionar um destino de ponto de extremidade personalizado ou um destino de aplicativo personalizado 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
Antes de começar, você deve obter 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 onde seu fluxo de eventos está localizado.
Nota
O número máximo de fontes e destinos para um eventstream é 11.
Adicionar um ponto de extremidade personalizado como destino
Se quiser rotear dados de eventos para seu aplicativo, você pode adicionar um ponto de extremidade personalizado como destino do fluxo de eventos:
Se estiver na vista dinâmica, mude para o modo de edição selecionando Editar no friso.
No modo de edição, adicione um destino de ponto de extremidade personalizado de uma das seguintes maneiras:
Selecione Adicionar destino na faixa de opções, selecione Ponto de extremidade personalizado e conecte o ponto de extremidade ao seu fluxo padrão ou fluxo derivado.
No editor, selecione Transformar eventos ou adicionar destino e, em seguida, selecione Ponto de extremidade personalizado.
Em Nome de destino, insira um nome para o ponto de extremidade personalizado. Em seguida, selecione Guardar.
Conecte o bloco de fluxo padrão ao bloco de ponto de extremidade personalizado se não houver conexão existente.
Para exibir as informações detalhadas do seu ponto de extremidade personalizado, selecione Publicar.
Obter detalhes do ponto de extremidade no painel Detalhes para consumir eventos
Na visualização dinâmica, selecione o bloco de ponto de extremidade personalizado. O painel Detalhes que aparece tem três guias de protocolo: Hub de Eventos, AMQP e Kafka.
Cada guia de protocolo tem três páginas: Básico, Chaves e Código de exemplo. 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.
Chaves fornece informações sobre chaves de conexão. O código de exemplo fornece 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 nestas páginas variam de acordo com o protocolo.
Hub de eventos
A página Chaves na guia 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 e Cadeia de conexão-chave primária.
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:
Ponto de extremidade=sb://eventstream-xxxxxxxx.servicebus.windows.net/; SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxxxxx;EntityPath=es_xxxxxxx
A página de código de exemplo na guia Hub de Eventos oferece 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.
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 código Chaves e Exemplo para o formato de protocolo Kafka para se conectar ao fluxo de eventos e consumir os eventos.
A página de código de exemplo na guia Kafka fornece código pronto, incluindo as chaves de conexão necessárias no formato Kafka. Basta copiá-lo para seu uso.
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.
A página de código de exemplo na guia AMQP fornece código pronto para uso com informações de chave de conexão no formato AMQP.
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 outros destinos a um fluxo de eventos, consulte os seguintes artigos:
Pré-requisitos
Antes de começar, você deve obter acesso ao espaço de trabalho do fluxo de eventos no modo de licença de capacidade de malha (ou) no modo de licença de avaliação com permissões de Colaborador ou superior.
Nota
O número máximo de fontes e destinos para um eventstream é 11.
Adicionar um aplicativo personalizado como destino
Se quiser rotear dados de eventos para seu aplicativo, você pode adicionar um aplicativo personalizado como destino do fluxo de eventos:
Selecione Novo destino na faixa de opções ou o sinal de adição (+) na tela principal do editor e, em seguida, selecione Aplicativo personalizado.
No painel Aplicativo Personalizado, insira um nome de destino para o aplicativo personalizado e selecione Adicionar.
Obter detalhes do ponto de extremidade no painel Detalhes para consumir eventos
Depois de criar com êxito o aplicativo personalizado como um destino, 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 tem três páginas: Noções básicas, Chaves e Código de exemplo. 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 aplicativo personalizado.
Chaves fornece informações sobre chaves de conexão. O código de exemplo fornece 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 nestas páginas variam de acordo com o protocolo.
Hub de eventos
A página Chaves na guia 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 e Cadeia de conexão-chave primária.
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:
Ponto de extremidade=sb://eventstream-xxxxxxxx.servicebus.windows.net/; SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxxxxx;EntityPath=es_xxxxxxx
A página de código de exemplo na guia Hub de Eventos oferece 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.
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 código Chaves e Exemplo para o formato de protocolo Kafka para se conectar ao fluxo de eventos e consumir os eventos.
A página de código de exemplo na guia Kafka fornece código pronto, incluindo as chaves de conexão necessárias no formato Kafka. Basta copiá-lo para seu uso.
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.
A página de código de exemplo na guia AMQP fornece código pronto para uso com informações de chave de conexão no formato AMQP.
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.
Gerir um destino
Você pode editar (por meio do comando Editar ) ou remover (por meio do comando Remover ) um destino de fluxo de eventos por meio do painel Dados 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.
Conteúdos relacionados
Para saber como adicionar outros destinos a um fluxo de eventos, consulte os seguintes artigos: