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-lhe como adicionar uma fonte de endpoint personalizada ou uma fonte de aplicação personalizada a um fluxo de eventos no Microsoft Fabric.

Pré-requisitos

  • Acesso ao espaço de trabalho onde o seu fluxo de eventos está localizado. O espaço de trabalho deve estar em capacidade do Fabric ou modo experimental.

  • Permissões de contribuidor ou superiores para editar o eventstream e adicionar um endpoint personalizado como fonte.

Permissões para autenticação Microsoft Entra

Se quiser usar a autenticação Microsoft Entra para conectar a sua aplicação, precisa de permissões de Membro ou superiores.

Também tens de garantir que a identidade gerida do endpoint personalizado tem as permissões necessárias. Configurar as definições no portal administrativo:

  1. No canto superior direito, selecione Definições (ícone de engrenagem).

  2. Em Governação e insights, selecione Portal de Administração.

    Captura de ecrã que mostra o link do portal de administração na secção para governação e insights nas definiçõ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.

    1. Na página Definições de Locatário, na secção Definições de Programador, expanda a opção Princípios de Serviço podem usar as APIs do Fabric.
    2. Defina a alternância como Habilitado.
    3. Para Candidatar-se, selecione A organização inteira.
    4. Selecione Aplicar.

    Captura de ecrã que mostra as definições do programador.

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

    1. Ainda na página Configurações do Inquilino, expanda a opção Permitir que principais de serviço criem e usem perfis.
    2. Defina a alternância como Habilitado.
    3. Para Candidatar-se, selecione A organização inteira.
    4. Selecione Aplicar.

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 apenas quando utiliza os seguintes tipos:

  • Fonte: Ponto de extremidade personalizado.
  • Destinos: endpoint personalizado e casa de eventos com ingestão direta.

Quaisquer fontes ou destinos não incluídos na lista anterior, e destinos não anexados ao fluxo padrão, não contam para este 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 ecrã que mostra a opção de usar um endpoint personalizado.

  2. Na página Adicionar origem , selecione Ativar para associação de esquema e, em seguida, selecione Adicionar.

    Captura de ecrã de uma fonte de endpoint personalizada com opção para associar esquemas.

  3. No editor, para associar a um novo esquema ou a um esquema existente a partir de um registro de esquema, selecione Associar esquema de eventos na faixa de opções.

    Captura de ecrã do editor de eventstream com o botão para associar um esquema de eventos selecionado no friso.

  4. Para usar um esquema existente, selecione Escolher do registo do esquema de eventos e siga estes passos:

    1. No diálogo Associar um esquema de eventos , selecione um esquema do registo de esquemas. O esquema de dados de eventos aparece no painel direito.

    2. Selecione Escolher para associar o esquema de eventos ao ponto de extremidade personalizado.

      Captura de ecrã do diálogo para associar um esquema de evento a um esquema selecionado do registo de esquemas.

    3. No editor de eventstream, selecione o bloco eventstream . No painel inferior, mude para o separador Esquema Associado . Confirme que o esquema está associado ao fluxo de eventos.

      Captura de ecrã do editor de eventstream com um eventstream selecionado e o separador para um esquema associado destacado.

  5. Use uma das seguintes opções para criar um esquema:

    • Se você tiver um arquivo JSON de esquema, selecione Carregar para carregar o arquivo. Para um ficheiro de exemplo, consulte Descarregar um esquema de evento.

      Captura de tela que mostra a opção de upload para criar um esquema.

    • Comece a criar um esquema manualmente selecionando Adicionar linha. Para cada linha, selecione o tipo de campo, selecione o nome do campo e, opcionalmente, introduza uma descrição.

      Captura de tela que mostra a maneira manual de criar um esquema.

    • Para construir um esquema introduzindo código JSON, selecione a opção de editor de código . Se aparecer a mensagem Se optar por usar o editor de código para criar o seu esquema, note que não conseguirá voltar ao construtor de interface (UI builder ), selecione Editar.

      Captura de tela que mostra o editor de código para criar um esquema.

      Insira o código JSON no editor.

      Captura de ecrã que mostra código JSON no editor de código para construir um esquema.

Nota

Um fluxo de eventos pode suportar até 11 fontes e destinos combinados apenas quando utiliza os seguintes tipos:

  • Fonte: Ponto de extremidade personalizado.
  • Destinos: endpoint personalizado e casa de eventos com ingestão direta.

Quaisquer fontes ou destinos não incluídos na lista anterior, e destinos não anexados ao fluxo padrão, não contam para este 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 separador de protocolo tem duas páginas que oferecem os detalhes do endpoint com o protocolo correspondente para ligaçã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 Autenticação de Chaves SAS fornece informações sobre chaves de ligação. Também fornece um link para o código de exemplo, com as chaves correspondentes incorporadas, que pode usar para transmitir os eventos para o seu fluxo de eventos. A informação nesta página varia consoante o protocolo.

Hub de eventos

O separador SAS Key Authentication para o protocolo Event Hub contém informações relacionadas com a cadeia de ligação de um event hub. A informação inclui o nome do hub de eventos, nome da chave de acesso partilhada, chave primária, chave secundária, cadeia de ligação - chave primária e cadeia de ligaçã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 selecionar o botão Mostrar código de exemplo , verá o código Java pronto a usar que inclui a informação necessária sobre as chaves de ligação no hub de eventos. Copie e cole-o em seu aplicativo para uso.

Captura de ecrã que mostra o botão para mostrar código de exemplo no painel de Detalhes da visualização em direto do eventostream.

AMQP

O formato Advanced Message Queuing Protocol (AMQP) é compatível com o AMQP 1.0, que é um protocolo padrão de mensagens que suporta a interoperabilidade entre várias plataformas e línguas. 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.

Quando seleciona o botão Mostrar código de exemplo , vê o código Java pronto a usar com a informação da chave de ligação em formato AMQP.

Captura de ecrã que mostra o botão para mostrar código de exemplo AMQP no painel de Detalhes da visualização ao vivo do eventostream.

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 ecrã que mostra o botão para o código de exemplo do Kafka no painel de Detalhes da visualização ao vivo do eventostream.

Para obter um guia claro sobre como usar o endpoint personalizado com o protocolo Kafka, consulte este tutorial. Fornece passos detalhados para transmitir e consumir eventos.

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. Também pode consultar ou copiar o código de exemplo, que mostra como enviar ou receber eventos usando vários protocolos.
  • Para fechar a vista de código de exemplo, selecione Ocultar código de exemplo.

Configurar destinos de fluxo de eventos para usar esquemas

Atualmente, apenas o eventhouse, endpoint personalizado e destinos de stream derivados são suportados para eventstreams com as funcionalidades estendidas ativadas. Esta secção mostra-lhe como adicionar e configurar um destino de casa de eventos quando funcionalidades estendidas (como suporte a esquemas) estão ativadas para o fluxo de eventos.

Configure um esquema para um destino de endpoint personalizado

  1. Selecione Transformar eventos ou adicionar destino, e depois selecione CustomEndpoint.

  2. No painel Endpoint Personalizado, especifique um nome para o destino.

  3. Em Esquema de entrada, selecione o esquema para eventos. Faz uma seleção nesta caixa ao ativar o suporte para esquemas para um stream de eventos.

Captura de ecrã que mostra o painel para configurar um endpoint personalizado.

Para obter etapas detalhadas sobre como configurar um destino de ponto de extremidade personalizado, consulte Adicionar um ponto de extremidade personalizado ou um destino de aplicativo personalizado a um fluxo de eventos.

Configurar esquemas para um destino de eventos

  1. Selecione Transformar eventos ou adicionar destino e, em seguida, selecione Casa de eventos.

  2. No painel do Eventohouse , configure as seguintes definições relacionadas com o esquema:

    1. Para o esquema de entrada, selecione um ou mais esquemas da lista suspensa.

      Captura de ecrã que mostra o painel de configuração do Eventhouse com um esquema de entrada selecionado.

      Nota

      Se selecionou a opção Esquema Dinâmico via cabeçalhos ao configurar uma fonte de Event Hubs, pode ter configurado múltiplos esquemas para a fonte e mapeado-os para várias propriedades e seus valores.

    2. Para o método de criação de tabelas, selecione uma única tabela com todos os esquemas combinados ou tabelas separadas para cada esquema, dependendo das suas necessidades.

      Captura de ecrã que mostra o painel de configuração do Eventhouse com métodos de criação de tabelas.

    3. Em Gravar dados com, selecione uma das seguintes opções:

      • Payload apenas: Inserir os dados extraídos do payload na tabela. Se houver vários esquemas de entrada, os dados serão enviados para várias tabelas.
      • Metadados e carga útil: escreva metadados e dados de carga útil em uma única tabela. Colunas de exemplo incluem source , subject, type, e data.

      Captura de ecrã que mostra o painel de configuração da casa do evento com as opções para escrever dados.

Para passos detalhados na configuração de um destino de casa de eventos, consulte Adicionar um destino de casa de eventos a um fluxo de eventos.

Conteúdos relacionados

  • Last updated on