Adicionar origem de ponto de extremidade personalizado para um Eventstream

Pré-requisitos

• Acesso ao espaço de trabalho premium do Fabric com permissões de Contribuidor ou superiores.

Adicionar dados de pontos de extremidade personalizados como uma origem

Siga essas etapas para adicionar uma origem de ponto de extremidade personalizada:

1. Para criar um eventstream, selecione Eventstream na tela de Início. Verifique se a opção Recursos Avançados (preview) está habilitada.

   

2. Para adicionar uma origem de pontos de extremidade personalizados, na página de introdução, selecione Usar ponto de extremidade personalizado.

   

   Como alternativa, se você já tiver um Eventstream publicado e desejar adicionar dados de pontos de extremidade personalizados como uma origem, realize a comutação para o modo de Edição. Em seguida, selecione Adicionar origem na faixa de opções e escolha Ponto de extremidade personalizado.

   

3. Na tela Ponto de extremidade personalizado, insira um nome para a origem personalizada em Nome de origem e selecione Adicionar.

   

4. Após criar a origem de pontos de extremidade personalizados, você a verá adicionada ao seu Eventstream na tela no Modo de edição. Para implementar os dados de origem de aplicativos personalizados adicionados recentemente, selecione Publicar.

   

Após essas etapas estarem concluídas, os dados de pontos de extremidade personalizados estarão disponíveis para visualização na Exibição ao vivo.

Obter cadeias de conexão e código de exemplo

No painel Detalhes da Exibição ao vivo, é possível visualizar três categorias: Básico, Chaves e Código de exemplo. Além disso, é possível selecionar entre três guias de protocolo: Hub de eventos, AMQP e Kafka. As informações das Chaves e do Código de exemplo variam de acordo com o protocolo.

A categoria Básico mostra o nome, a descrição, o tipo e o status do ponto de extremidade personalizado.

A categoria Chaves mostra as cadeias de conexão para o ponto de extremidade personalizado, que você pode copiar e colar em seu aplicativo.

A cadeia de conexão corresponde a uma sequência de caracteres compatível com o hub de eventos que você pode usar em seu aplicativo para receber eventos deste Eventstream. O formato do Hub de eventos é o formato padrão para a cadeia de conexão e é compatível com o SDK dos Hubs de Eventos do Azure. É possível usar esse formato para efetuar a conexão com Eventstreams ao usar o protocolo Hubs de Eventos.

O exemplo apresentado a seguir mostra como a cadeia de conexão se parece no formato do Hub de eventos:

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

A guia Código de exemplo mostra o código de exemplo que você pode ver ou copiar e colar em seu aplicativo para transmitir ou transferir dados de evento para ou deste Eventstream.

Além do Hub de eventos, as outras duas guias de formato de protocolo que você pode selecionar no painel Detalhes são AMQP e Kafka.

• O formato AMQP é compatível com o protocolo AMQP 1.0, um protocolo de mensagens padrão que oferece suporte à interoperabilidade entre diferentes plataformas e linguagens. É possível usar esse formato para efetuar a conexão com Eventstreams ao usar o protocolo AMQP.

• O formato Kafka é compatível com o protocolo Apache Kafka, uma plataforma popular de streaming distribuído que oferece suporte ao processamento de dados de alta produtividade e baixa latência. É possível usar esse formato para efetuar a conexão com Eventstreams ao usar o protocolo Kafka.

Você pode escolher o formato de protocolo que melhor atende às necessidades e preferências do seu aplicativo. Selecione essas guias no painel Detalhes para obter Chaves e Código de exemplo personalizados. Copie e cole as cadeias de conexão da seção Chaves em seu aplicativo. Veja ou copie e cole o código de exemplo fornecido para enviar ou receber eventos ao usar os diferentes protocolos.

Conteúdo relacionado

Para saber como adicionar outras origens a um Eventstream, consulte os seguintes artigos:

• Amazon Kinesis Data Streams
• Eventos de Armazenamento de Blobs do Azure
• Azure Cosmos DB
• Hubs de eventos do Azure
• Hub IoT do Azure
• Captura de dados de alterações (CDA) com o Banco de Dados SQL do Azure
• Kafka para Confluent
• Evento de espaço de trabalho do Fabric 
• Pub/Sub do Google Cloud
• CDA do Banco de Dados MySQL
• CDA do Banco de dados PostgreSQL
• Dados de amostra

Pré-requisitos

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

• Obtenha acesso a um workspace premium com permissões de Colaborador ou superior no local em que seu fluxo de eventos está localizado.

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 fluxo de eventos com seu próprio aplicativo com o ponto de extremidade de conexão exposto no aplicativo personalizado. Siga essas etapas para adicionar uma fonte de aplicativo personalizada:

1. Selecione Nova fonte na faixa de opções ou "+" na tela do editor principal e, em seguida, Aplicativo Personalizado.

2. Insira um nome de origem para o aplicativo personalizado e selecione Adicionar.

   

3. Depois de criar com sucesso a fonte de aplicativo personalizado, alterne e veja as informações a seguir na guia Detalhes no painel inferior:

   

   • Básico: mostra o nome, a descrição, o tipo e o status do aplicativo personalizado.
   • Chaves: mostra a cadeia de conexão para seu aplicativo personalizado, que você pode copiar e colar em seu aplicativo.
   • Código de exemplo: mostra o código de exemplo, que você pode consultar ou copiar para enviar dados de evento para esse fluxo de eventos ou recuperar dados de evento desse fluxo de eventos.

   Para cada guia (Básico / Chaves / Código de exemplo), também é possível realizar a comutação entre três guias de protocolo: Hub de eventos, AMQP e Kafka para obter acesso às informações de diversos formatos de protocolo:

   A cadeia de conexão uma cadeia de conexão compatível com o hub de eventos e você pode usá-la em seu aplicativo para receber eventos do fluxo de eventos. A cadeia de conexão tem vários formatos de protocolo, que você pode alternar e selecionar na guia Chaves. O seguinte exemplo a mostra como é a cadeia de conexão no formato de Hubs de Eventos:

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

   O formato Hub de eventos é o formato padrão da cadeia de conexão e é compatível com o SDK dos Hubs de Eventos do Azure. Você pode usar esse formato para se conectar ao fluxo de eventos usando o protocolo dos Hubs de Eventos.

   

   Os outros dois formatos de protocolo são AMQP e Kafka, que você pode selecionar clicando nas guias correspondentes na guia Chaves.

   O formato AMQP é compatível com o protocolo AMQP 1.0, um protocolo de mensagens padrão que dá suporte à interoperabilidade entre diferentes plataformas e linguagens. Você pode usar esse formato para se conectar ao fluxo de eventos usando o protocolo AMQP.

   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 esse formato para se conectar ao fluxo de eventos usando o protocolo do Kafka.

   Você pode escolher o formato de protocolo que atende às suas necessidades e preferências do aplicativo, e copiar e colar a cadeia de conexão em seu aplicativo. Você também pode consultar ou copiar o código de exemplo fornecido na guia Código de exemplo, que mostra como enviar ou receber eventos usando protocolos diferentes.

Conteúdo relacionado

Para saber como adicionar outras origens a um Eventstream, consulte os seguintes artigos:

• Hubs de eventos do Azure
• Hub IoT do Azure
• Dados de amostra