Adicionar uma origem de ponto de extremidade personalizado ou aplicativo personalizado a um eventstream

Artigo
11/19/2024

Se quiser conectar seu próprio aplicativo a um eventstream, você poderá adicionar um ponto de extremidade personalizado ou um aplicativo personalizado como origem. Em seguida, você pode enviar eventos em tempo real para o eventstream a partir do seu próprio aplicativo com o ponto de extremidade de conexão exposto no ponto de extremidade personalizado ou aplicativo personalizado. Além disso, com o protocolo do Apache Kafka disponível como uma opção para pontos de extremidade personalizados ou aplicativos personalizados, você poderá enviar eventos em tempo real usando o protocolo do Apache Kafka.

Este artigo mostra como adicionar uma origem de ponto de extremidade personalizada ou uma origem de aplicativo personalizada a um eventstream em um fluxo de eventos do Microsoft Fabric.

Observação

Agora, os recursos aprimorados estão habilitados por padrão ao criar os Eventstreams. Caso tenha os Eventstreams que foram criados usando recursos padrão, esses Eventstreams continuarão a funcionar. Você ainda pode editá-los e usá-los como de costume. Recomendamos que você crie um novo Eventstream para substituir os Eventstreams padrão para que você possa usufruir de recursos adicionais e benefícios de Eventstreams aprimorados.

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 Avaliação com permissões de Colaborador ou superior.
Se você não tiver um Eventstream, crie um Eventstream.

Adicionar dados de pontos de extremidade personalizados como uma origem

Para adicionar uma origem de ponto de extremidade personalizada, na página de introdução, selecione Usar ponto de extremidade personalizado. Ou, se você já tiver um eventstream publicado e quiser adicionar dados de um ponto de extremidade personalizado como uma origem, alterne para o modo de edição. Na faixa de opções, selecione Adicionar origem>Ponto de extremidade personalizado.
Na caixa de diálogo Ponto de extremidade personalizado, insira um nome para a origem personalizada em Nome da origem e, a seguir, selecione Adicionar.
Após ser criada, a origem de ponto de extremidade personalizada será adicionada ao seu eventstream na tela do modo de edição. Para implementar os dados recém-adicionados a partir da origem de aplicativo personalizada, selecione Publicar.

Observação

O número máximo de origens e destinos para um fluxo de eventos é 11.

Obter detalhes do ponto de extremidade no painel Detalhes

Após você criar uma origem de ponto de extremidade personalizada, seus dados estarão disponíveis para visualização no modo de exibição ao vivo.

Captura de tela mostrando o eventstream no modo de exibiçã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. Essas páginas oferecem os detalhes do ponto de extremidade com o protocolo correspondente para se conectar.

Noções básicas mostra o nome, tipo e status do seu ponto de extremidade personalizado.

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

Hub de eventos

A página Autenticação de Chave SAS 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, Chave secundária, Chave primária da cadeia de conexão, Chave secundária da cadeia de conexão.

Captura de tela mostrando informações de chaves no painel Detalhes do eventstream.

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

O exemplo a seguir mostra a aparência da cadeia de conexão no formato do 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 as chaves de conexão no hub de eventos. Copie e cole-o no seu aplicativo para usá-lo.

Captura de tela mostrando a amostra de código do painel Detalhes do modo de exibição ao vivo do eventstream.

Advanced Message Queuing Protocol (AMQP)

O formato AMQP é compatível com o protocolo AMQP 1.0, que é um protocolo de mensagens padrão que facilita a interoperabilidade entre diferentes plataformas e linguagens. Você pode usar esse formato para se conectar ao seu eventstream usando o protocolo AMQP.

Captura de tela mostrando as chaves do AMQP no painel Detalhes do modo de exibição ao vivo do eventstream.

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

Captura de tela mostrando a amostra de código do AMQP no painel Detalhes do modo de exibição ao vivo do eventstream.

Kafka

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

Captura de tela mostrando as chaves do Kafka no painel Detalhes do modo de exibição ao vivo do eventstream.

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

Captura de tela mostrando a amostra de código do Kafka no painel Detalhes do modo de exibição ao vivo do eventstream.

Observação

Você pode escolher o formato de protocolo que atender às necessidades e preferências do seu aplicativo e, a seguir, copiar e colar a cadeia de conexão no seu aplicativo. Você também pode mencionar ou copiar o código de exemplo, que mostra como enviar ou receber eventos usando vários protocolos.

Para sair do modo de exibição de código de exemplo, selecione Ocultar código de exemplo.

Para obter uma lista de fontes com suporte, confira Adicionar uma origem do evento em um Eventstream

Pré-requisitos

Antes de começar, você precisa obter acesso a um workspace com permissão de Colaborador ou superior, no qual seu fluxo de eventos está localizado.

Observação

O número máximo de origens e destinos para um fluxo de eventos é 11.

Adicionar um aplicativo personalizado como uma origem

Se você quiser conectar seu próprio aplicativo a um fluxo de eventos, poderá adicionar uma fonte de aplicativo personalizada. Em seguida, envie dados para o eventstream a partir do seu próprio aplicativo com o ponto de extremidade de conexão exposto no aplicativo personalizado.

Para adicionar uma origem de aplicativo personalizada:

Selecione Nova fonte na faixa de opções ou o sinal de mais (+) na tela principal do editor e, em seguida, selecione Aplicativo personalizado.
No painel Aplicativo Personalizado, insira um nome de origem para o aplicativo personalizado e, a seguir, selecione Adicionar.

Obter detalhes do ponto de extremidade no painel Detalhes para enviar eventos

Após criar com sucesso o aplicativo personalizado como origem, você poderá ver 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: Básico, Chaves e Código de exemplo. Essas páginas oferecem os detalhes do ponto de extremidade com o protocolo correspondente para se conectar.

Noções básicas mostra o nome, tipo e status do seu aplicativo personalizado.

Captura de tela mostrando informações básicas de um aplicativo personalizado no painel Detalhes de um eventstream.

Chaves fornece informações sobre chaves de conexão. Amostra de código fornece a amostra de código, com as respectivas chaves incorporadas, que você pode usar para transmitir os eventos para o seu eventstream. As informações contidas nessas páginas variam de acordo com o protocolo.