Condividi tramite

Aggiungere un endpoint personalizzato o un'origine app personalizzata a un flusso di eventi

Se si vuole connettere la propria applicazione a un flusso di eventi, è possibile aggiungere un endpoint personalizzato o un'app personalizzata come origine. È quindi possibile inviare eventi in tempo reale al flusso di eventi dalla propria applicazione con l'endpoint di connessione esposto nell'endpoint personalizzato o nell'app personalizzata. Inoltre, con il protocollo Apache Kafka disponibile come opzione per endpoint personalizzati o app personalizzate, è possibile inviare eventi in tempo reale usando il protocollo Apache Kafka.

Questo articolo illustra come aggiungere un'origine endpoint personalizzata o un'origine app personalizzata a un eventstream nei flussi di eventi di Microsoft Fabric.

Nota

Le funzionalità avanzate sono abilitate per impostazione predefinita quando si creano flussi di eventi. Se sono stati creati flussi di eventi che usano funzionalità standard, tali flussi di eventi continueranno a funzionare. È comunque possibile modificarli e usarli come di consueto. È consigliabile creare un nuovo flusso di eventi per sostituire i flussi di eventi standard in modo da poter sfruttare funzionalità aggiuntive e vantaggi dei flussi di eventi avanzati.

Prerequisiti

Prima di iniziare, assicurarsi di avere accesso all'area di lavoro in cui si trova il flusso di eventi. L'area di lavoro deve essere in modalità Capacità Fabric o Modalità di prova.

  • Per modificare il flusso di eventi e aggiungere un'origine endpoint personalizzata sono necessarie autorizzazioni di Collaboratore o di livello superiore.
  • Se si vuole usare l'autenticazione Entra ID per connettere l'applicazione, sono necessarie autorizzazioni membro o superiore.

Se si usa l'autenticazione Entra ID, è anche necessario assicurarsi che l'identità gestita dell'endpoint personalizzato disponga delle autorizzazioni necessarie. A tale scopo, configurare le impostazioni necessarie nel portale di amministrazione:

  1. Selezionare Impostazioni (icona a forma di ingranaggio) nell'angolo superiore destro.

  2. Selezionare Portale di amministrazione nella sezione Governance e informazioni dettagliate .

    Screenshot che mostra la selezione del collegamento al portale di amministrazione nella sezione Governance e informazioni dettagliate.

  3. Attivare la seguente impostazione del tenant per concedere all'entità servizio l'accesso alle Fabric API per la creazione di aree di lavoro, connessioni o pipeline di distribuzione.

    • Nella pagina Impostazioni tenant, nella sezione Impostazioni sviluppatore, espandere l'opzione Service principal can use Fabric API.
    • Passa a Abilitato.
    • Applicare all'intera organizzazione.
    • Selezionare Applica.

    Screenshot che mostra le impostazioni dello sviluppatore.

  4. Abilitare questa opzione per accedere a tutte le altre API (abilitate per impostazione predefinita per i nuovi tenant):

    • Sempre nella pagina delle Impostazioni tenant, espandete l'opzione Consenti alle entità servizio di creare e usare i profili.
    • Passa a Abilitato.
    • Applicare all'intera organizzazione.
    • Selezionare Applica.

Nota

Un flusso di eventi può supportare fino a 11 origini e destinazioni combinate quando si usano i tipi seguenti:

  • Origini: Hub eventi di Azure, hub IoT ed endpoint personalizzati.
  • Destinazioni: Endpoint personalizzati e Eventhouse con inserimento diretto.

Le origini o le destinazioni non incluse nell'elenco precedente e le destinazioni non aggiunte al flusso predefinito non vengono conteggiate per questo limite.

Aggiungere dati endpoint personalizzati come origine

  1. Per aggiungere un'origine endpoint personalizzata, nella pagina di avvio selezionare Usa endpoint personalizzato. In alternativa, se si dispone già di un flusso di eventi pubblicato e si desidera aggiungere dati endpoint personalizzati come origine, passare alla modalità di modifica. Sulla barra multifunzione, selezionare Aggiungi origine>Endpoint personalizzato.

    Screenshot dell'opzione per l'uso di un endpoint personalizzato.

  2. Nella finestra di dialogo Custom endpoint immettere un nome per l'origine personalizzata in Nome origine e quindi selezionare Aggiungi.

    Screenshot della finestra di dialogo per l'aggiunta di un endpoint personalizzato.

  3. Dopo aver creato l'origine endpoint personalizzata, questa viene aggiunta al flusso di eventi che si trova sull'area di disegno in modalità di modifica. Per implementare i dati appena aggiunti dall'origine dell'app personalizzata, selezionare Pubblica.

    Screenshot che mostra il flusso di eventi in modalità di modifica, con il pulsante Pubblica evidenziato.

Nota

Un flusso di eventi può supportare fino a 11 origini e destinazioni combinate quando si usano i tipi seguenti:

  • Origini: Hub eventi di Azure, hub IoT ed endpoint personalizzati.
  • Destinazioni: Endpoint personalizzati e Eventhouse con inserimento diretto.

Le origini o le destinazioni non incluse nell'elenco precedente e le destinazioni non aggiunte al flusso predefinito non vengono conteggiate per questo limite.

Ottenere i dettagli dell'endpoint nel riquadro Dettagli

Dopo aver creato un'origine endpoint personalizzata, i relativi dati sono disponibili per la visualizzazione nella visualizzazione dinamica.

Screenshot che mostra il flusso di eventi nella visualizzazione live.

Il riquadro Dettagli include tre schede di protocollo: Hub eventi, AMQP e Kafka. Ogni scheda del protocollo ha tre pagine: Base e Autenticazione chiave SAS. Queste pagine offrono i dettagli dell'endpoint con il protocollo corrispondente per la connessione.

Basic mostra il nome, il tipo e lo stato dell'endpoint personalizzato.

Screenshot che mostra le informazioni di base nel riquadro Dettagli della visualizzazione live eventstream.

La pagina di autenticazione con chiave SAS fornisce informazioni sulle chiavi di connessione e un collegamento al codice di esempio, con le chiavi corrispondenti incorporate, che è possibile utilizzare per inviare gli eventi al flusso di eventi. Le informazioni nella pagina Chiavi variano in base al protocollo.

Hub eventi

La pagina Autenticazione della chiave SAS nella scheda Hub eventi contiene informazioni relative alla stringa di connessione di un hub eventi. Le informazioni includono il nome dell'hub eventi, il nome della chiave di accesso condivisa, la chiave primaria, la chiave secondaria, stringa di connessione-chiave primaria, stringa di connessione-chiave secondaria.

Screenshot che mostra le informazioni chiave nel riquadro Dettagli del flusso di eventi.

Il formato di Event Hub è l'impostazione predefinita per la stringa di connessione e funziona con l'SDK di Azure Event Hubs. Questo formato consente di connettersi al flusso di eventi tramite il protocollo di Hub eventi.

L'esempio seguente mostra l'aspetto della stringa di connessione nel formato hub eventi.

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

Se si seleziona il pulsante Mostra codice di esempio, viene visualizzato il codice Java pronto per l'uso che include le informazioni necessarie sulle chiavi di connessione nell'hub eventi. Copiare e incollarlo nell'applicazione per l'uso.

Screenshot che mostra il codice di esempio nel riquadro Dettagli della visualizzazione live eventstream.

Protocollo AMQP (Advanced Message Queuing Protocol)

Il formato AMQP è compatibile con il protocollo AMQP 1.0, ovvero un protocollo di messaggistica standard che supporta l'interoperabilità tra diverse piattaforme e linguaggi. È possibile usare questo formato per connettersi al flusso di eventi usando il protocollo AMQP.

Screenshot che mostra le chiavi AMQP nel riquadro Dettagli della visualizzazione live del flusso di eventi.

Quando si seleziona Il pulsante Mostra codice di esempio, viene visualizzato il codice Java pronto per l'uso con le informazioni sulla chiave di connessione in formato AMQP.

Screenshot che mostra il codice di esempio AMQP nel riquadro Dettagli della visualizzazione live eventstream.

Kafka

Il formato Kafka è compatibile con il protocollo Apache Kafka, una piattaforma di streaming distribuita comune che supporta l'elaborazione dei dati ad alta produttività e bassa latenza. È possibile usare le informazioni di autenticazione con chiave SAS per il protocollo Kafka per connettersi al flusso di eventi e trasmettere gli eventi.

Screenshot che mostra le chiavi Kafka nel riquadro Dettagli della vista live del flusso di eventi.

Quando si seleziona il pulsante Mostra codice di esempio, viene visualizzato il codice Java pronto per l'uso, incluse le chiavi di connessione necessarie in formato Kafka. Copia per il tuo uso personale.

Screenshot che mostra il codice di esempio Kafka nel riquadro Dettagli della visualizzazione live eventstream.

Per una guida chiara sull'uso dell'endpoint personalizzato con il protocollo Kafka, fare riferimento a questo tutorial. Fornisce passaggi dettagliati per lo streaming e l'utilizzo di eventi usando l'endpoint personalizzato con il protocollo Kafka.

Nota

  • È possibile scegliere il formato di protocollo adatto alle esigenze e alle preferenze dell'applicazione, quindi copiare e incollare il stringa di connessione nell'applicazione. È anche possibile fare riferimento o copiare il codice di esempio, che illustra come inviare o ricevere eventi usando diversi protocolli.
  • Per uscire dalla visualizzazione codice di esempio, selezionare Nascondi codice di esempio.

Contenuto correlato

Per un elenco delle origini supportate, vedere Aggiungere un'origine evento in un flusso di eventi

Prerequisiti

  • Accesso a un'area di lavoro in modalità di licenza capacità di Fabric o modalità di licenza di prova, con permessi di Collaboratore o superiori.
  • Se non si dispone di un flusso di eventi, creare un flusso di eventi.

Aggiungere un'app personalizzata come origine

Se si vuole connettere un'applicazione personalizzata a un eventstream, è possibile aggiungere un’origine app personalizzata. Inviare quindi i dati al flusso di eventi dalla propria applicazione con l'endpoint di connessione esposto nell'app personalizzata.

Per aggiungere un'origine app personalizzata:

  1. Seleziona Nuova origine sulla barra multifunzione o il simbolo del più (+) nell'area di lavoro dell'editor principale, quindi seleziona Personalizza App.

  2. Nel riquadro App personalizzata immettere un nome di origine per l'app personalizzata e quindi selezionare Aggiungi.

    Screenshot che mostra il riquadro per la configurazione di un'app personalizzata come origine.

Ottenere i dettagli dell'endpoint nel riquadro Dettagli per inviare eventi

Dopo aver creato l'applicazione personalizzata come origine, è possibile visualizzare le informazioni nel riquadro Dettagli .

Il riquadro Dettagli include tre schede di protocollo: Hub eventi, AMQP e Kafka. Ogni scheda del protocollo contiene tre pagine: Basic, SAS Key Authentication e Entra ID Authentication.Each protocol tab contains three pages: Basic, SAS Key Authentication, and Entra ID Authentication. Queste pagine forniscono informazioni sull'endpoint specifiche del protocollo selezionato. Screenshot che mostra una sorgente personalizzata dell'app.

  • La pagina Basic mostra il nome, il tipo e lo stato dell'endpoint personalizzato.

Screenshot che mostra le informazioni di base per un'app personalizzata nel riquadro Dettagli di un flusso di eventi.

  • Autenticazione con chiave SAS e Autenticazione Entra ID sono due metodi di autenticazione supportati per la connessione alla tua applicazione:
    • L'autenticazione con chiave di firma di accesso condiviso fornisce le informazioni necessarie per produrre e utilizzare dati Eventstream usando chiavi di firma di accesso condiviso.
    • L'autenticazione ENTRA ID consente a un'entità di sicurezza ,ad esempio un utente o un'entità servizio, di utilizzare i dati Eventstream usando l'autenticazione dell'ID Entra di Microsoft.

Per i passaggi per utilizzare dell'autenticazione di Entra ID, vedere Abilitare l'autenticazione di Entra ID per un'applicazione in Eventstream.
La sezione seguente descrive come connettersi a una destinazione endpoint personalizzata utilizzando l'autenticazione con chiave SAS.

Hub eventi

La pagina Chiavi nella scheda Hub eventi contiene informazioni correlate alla stringa di connessione di un hub eventi. Le informazioni includono il nome dell'hub eventi, il nome della chiave di accesso condivisa, la chiave primaria e la chiave primaria della stringa di connessione.

Screenshot che mostra le informazioni chiave nel riquadro Dettagli del flusso di eventi.

Il formato di Event Hub è l'impostazione predefinita per la stringa di connessione e funziona con l'SDK di Azure Event Hubs. Questo formato consente di connettersi al flusso di eventi tramite il protocollo di Hub eventi.

L'esempio seguente mostra l'aspetto della stringa di connessione nel formato hub eventi.

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

Selezionare Il pulsante Mostra codice di esempio nella pagina Hub eventi per ottenere il codice pronto all'uso che include le informazioni necessarie sulle chiavi di connessione nell'hub eventi. È sufficiente copiarlo e incollarlo nell'applicazione per l'uso.

Screenshot che mostra il codice di esempio nel riquadro Dettagli del flusso di eventi.

Kafka

Il formato Kafka è compatibile con il protocollo Apache Kafka, una piattaforma di streaming distribuita comune che supporta l'elaborazione dei dati ad alta produttività e bassa latenza. È possibile usare le informazioni relative a chiavi e codice di esempio per il formato del protocollo Kafka per connettersi al flusso di eventi e trasmettere gli eventi.

Screenshot che mostra le chiavi Kafka nel riquadro Dettagli del flusso di eventi.

Selezionare Il pulsante Mostra codice di esempio nella pagina Kafka per ottenere codice pronto, incluse le chiavi di connessione necessarie in formato Kafka. È sufficiente copiarlo per l'uso.

Screenshot che mostra il codice di esempio Kafka nel riquadro Dettagli del flusso di eventi.

AMQP

Il formato AMQP è compatibile con il protocollo AMQP 1.0, ovvero un protocollo di messaggistica standard che supporta l'interoperabilità tra diverse piattaforme e linguaggi. È possibile usare questo formato per connettersi al flusso di eventi usando il protocollo AMQP.

Screenshot che mostra le chiavi AMQP nel riquadro Dettagli del flusso di eventi.

Selezionare Il pulsante Mostra codice di esempio nella pagina AMQP per prepararsi all'uso con le informazioni sulla chiave di connessione in formato AMQP .

Screenshot che mostra il codice di esempio AMQP nel riquadro Dettagli del flusso di eventi.

È possibile scegliere il formato di protocollo adatto alle esigenze e alle preferenze dell'applicazione, quindi copiare e incollare il stringa di connessione nell'applicazione. È anche possibile fare riferimento o copiare il codice di esempio nella tabella codici di esempio, che illustra come inviare o ricevere eventi usando diversi protocolli.

Contenuto correlato

Per imparare ad aggiungere altre origini a un eventstream, vedere gli articoli seguenti: