Ricevere eventi da Event Hubs di Azure nell'hub Real-Time

Questo articolo descrive come ottenere eventi da un hub eventi di Azure in Real-Time hub.

Prerequisites

  • Accesso a un'area di lavoro nella modalità di licenza di capacità Fabric o in modalità di licenza di prova con autorizzazioni di Collaboratore o superiore.
  • Autorizzazione appropriata per ottenere le chiavi di accesso di un hub eventi. Se l'hub eventi si trova all'interno di una rete protetta, connettersi a esso usando un endpoint privato gestito. In caso contrario, assicurarsi che l'hub eventi sia accessibile pubblicamente e non dietro un firewall.
  1. Accedi a Microsoft Fabric.

  2. Se vedi Power BI in basso a sinistra nella pagina, passa al carico di lavoro Fabric scegliendo Power BI e quindi scegliendo Fabric.

    Screenshot che mostra come passare al workload di Fabric.

  3. Selezionare Tempo Reale sulla barra di navigazione a sinistra.

    Screenshot che mostra come avviare l'esperienza Connetti all'Origine Dati.

  4. Per impostazione predefinita, viene visualizzata la pagina Streaming data (Dati di streaming ). Fare clic sul pulsante Aggiungi dati per passare alla pagina Aggiungi dati .

    Screenshot che mostra la pagina Aggiungi dati nell'hub Real-Time.

    È anche possibile accedere direttamente alla pagina Aggiungi dati selezionando l'opzione Aggiungi dati nella barra di spostamento a sinistra.

    Screenshot che mostra il pulsante Connetti origine dati.

Nella scheda Aggiungi dati è possibile connettersi a un hub eventi Azure usando la scheda Tutte le origini o la scheda Azure (scelta consigliata). Questo articolo illustra entrambi i modi per connettersi a un hub eventi Azure.

  1. Nella pagina Aggiungi dati passare alla scheda Azure.

    Screenshot che illustra come passare alla scheda Azure nella pagina Aggiungi dati.

  2. Passare il puntatore del mouse sullo spazio dei nomi Hub eventi di Azure nell'elenco e selezionare il pulsante Connect visualizzato. In alternativa, è possibile selezionare ... e quindi Connetti dal menu a discesa.

    Usa la barra di ricerca per trovare rapidamente lo spazio dei nomi di Event Hubs se hai molte risorse di Azure (o) usa i filtri per filtrare l'elenco in base al tipo di origine (spazio dei nomi di Hub eventi di Azure), alla sottoscrizione, al gruppo di risorse o all'area.

    Screenshot che illustra come connettersi a uno spazio dei nomi Hub eventi di Azure dalla pagina Aggiungi dati.

  3. Nella procedura guidata Connetti origine dati, nella pagina Configura, seguire questi passaggi:

    1. Selezionare un hub eventi dall'elenco a discesa. L'elenco a discesa viene popolato con gli hub di eventi del namespace di Hub eventi di Azure selezionato.

    2. Selezionare il nome della chiave dall'elenco a discesa. Il menu a discesa viene popolato con i nomi delle chiavi dell'hub eventi selezionato.

      Schermata che mostra come selezionare un hub di eventi dal menu a discesa nella procedura guidata Connetti origine dati.

    3. Per Gruppo di consumer, selezionare $Default o immettere il nome di un gruppo di consumer personalizzato creato per questo hub di eventi.

    4. Per Formato dati selezionare il formato degli eventi nell'hub eventi, ad esempio JSON, Avro e così via.

    5. Nella sezione Dettagli flusso a destra seguire questa procedura:

      1. Selezionare l'area di lavoro Fabric in cui si vuole creare il flusso di eventi.

      2. Per Nome flusso di eventi, selezionare il pulsante Matita e immettere un nome per il flusso di eventi.

      3. Il valore del nome stream viene generato automaticamente aggiungendo -stream al nome del flusso di eventi. Questo flusso viene visualizzato nella pagina Tutti i flussi di dati dell'hub in tempo reale al termine della procedura guidata.

        Schermata che mostra la sezione Dettagli del flusso.

  4. Selezionare Rivedi e connetti nella parte inferiore della pagina Configura .

  5. Esaminare i dettagli nella pagina Rivedi e connetti e quindi selezionare Connetti.

    Screenshot che mostra la pagina Rivedi e connetti.

  1. Nella pagina Aggiungi dati passare alla scheda Azure.

    Screenshot che illustra come passare alla scheda Azure nella pagina Aggiungi dati.

  2. Passare il puntatore del mouse sullo spazio dei nomi Hub eventi di Azure nell'elenco e selezionare il pulsante Connect visualizzato. In alternativa, è possibile selezionare ... e quindi Connetti dal menu a discesa.

    Usa la barra di ricerca per trovare rapidamente il namespace di Event Hubs se hai molte risorse di Azure (o) usa i filtri per filtrare l'elenco in base al tipo di origine (namespace di Hub eventi di Azure), alla sottoscrizione, al gruppo di risorse o all'area geografica.

    Screenshot che illustra come connettersi a uno spazio dei nomi Hub eventi di Azure dalla pagina Aggiungi dati.

  3. Nella procedura guidata Connetti origine dati, nella pagina Configura, seguire questi passaggi:

    1. Selezionare un hub eventi dall'elenco a discesa. L'elenco a discesa si popola con gli hub di eventi dello spazio dei nomi di Hub eventi di Azure selezionato.

    2. Selezionare il nome della chiave dall'elenco a discesa. L'elenco a discesa viene popolato con i nomi delle chiavi dell'hub eventi selezionato.

      Schermata che mostra come selezionare un hub eventi dal menu a discesa nella procedura guidata Connetti origine dati.

    3. In Livello di funzionalità selezionare Funzionalità estese.

      1. Per Gruppo di consumer, selezionare un gruppo di consumer dall'elenco a discesa. L'elenco a discesa viene popolato con i gruppi di utenti dell'hub di eventi selezionato.
      2. Per Posizione di partenza, seleziona il punto da cui vuoi iniziare l'acquisizione degli eventi. È possibile scegliere di iniziare dal primo evento disponibile, dall'evento più recente o da un punto specifico nel tempo.
    4. Nella sezione Dettagli flusso a destra seguire questa procedura:

      1. Selezionare l'area di lavoro Fabric in cui si vuole creare il flusso di eventi.

      2. Per Nome flusso di eventi, selezionare il pulsante Matita e immettere un nome per il flusso di eventi.

      3. Il valore del nome stream viene generato automaticamente aggiungendo -stream al nome del flusso di eventi. Questo flusso viene visualizzato nella pagina Tutti i flussi di dati dell'hub in tempo reale al termine della procedura guidata.

        Schermata che mostra la sezione Dettagli del flusso.

    5. Selezionare Avanti nella parte inferiore della pagina Configura .

Pagina di gestione dello schema

  1. Nella pagina Gestione dello schema specificare le regole per gestire gli eventi ricevuti dall'hub eventi selezionato, in modo che il flusso di eventi possa applicarli correttamente. Le regole di mapping dipendono dalla modalità di modellazione degli eventi.

    Se si dispone di uno schema che regola tutti gli eventi, selezionare Schema fisso.

    Se sono presenti più schemi che rappresentano i vari eventi in ingresso, definire le regole di corrispondenza per applicare gli schemi. Per scegliere questa modalità, selezionare Schema dinamico tramite intestazioni. Specificare quindi le regole usando coppie intestazione/valore per selezionare ogni schema. L'intestazione è una proprietà di intestazione Kafka personalizzata che fa parte dei metadati dell'evento. Il valore è il valore previsto per tale proprietà.

    Screenshot che mostra la pagina per la gestione dello schema, con l'opzione per le funzionalità estese selezionate.

  2. Scegliere gli schemi selezionando il menu a discesa Aggiungi altri schemi e quindi scegliendo uno o più schemi esistenti dal Registro di sistema dello schema eventi. Se non si hanno schemi tra cui scegliere, è possibile creare nuovi schemi da questa vista. Per informazioni su come definire un nuovo schema di eventi, vedere Creare e gestire schemi di eventi nei set di schemi.

    Screenshot che mostra l'area per l'aggiunta di schemi, con l'opzione dello schema fisso selezionata.

    Se è stata selezionata l'opzione Scegli dal registro degli schemi eventi, viene visualizzato il riquadro Associa uno schema eventi. Selezionare uno o più schemi dal Registro di sistema, a seconda della modalità di corrispondenza dello schema e quindi selezionare Scegli nella parte inferiore del riquadro.

    Screenshot che mostra il riquadro per l'associazione di uno schema di eventi.

  3. Se è stata selezionata l'opzione Schema fisso , non è necessario specificare altre regole in modo che corrispondano allo schema. È possibile continuare con il passaggio successivo.

    Se è stata selezionata l'opzione Schema dinamico tramite intestazioni, specificare la proprietà dell'intestazione Kafka e il valore previsto che corrisponde allo schema. Aggiungere altri schemi e specificare proprietà dell'intestazione e / o valori diversi per eseguire il mapping a tali schemi.

    Annotazioni

    Quando si definiscono le regole di mapping, ogni valore dell'intestazione deve essere univoco. Se si tenta di riutilizzare uno schema, viene visualizzato un messaggio di avviso che indica che è possibile interrompere i flussi esistenti. Purché le regole di mapping siano le stesse, è possibile riutilizzare uno schema. Se questa limitazione influisce sull'uso, contattare il rappresentante Microsoft per condividere il feedback. Microsoft sta lavorando attivamente per rimuovere questa limitazione.

    Screenshot che mostra una proprietà e un valore mappato a uno schema.

  4. Dopo aver eseguito il mapping degli schemi per tutti gli eventi previsti, selezionare Avanti nella parte inferiore della pagina Gestione dello schema .

    Screenshot che mostra il pulsante Avanti nella pagina per la gestione dello schema.

  5. Selezionare Rivedi e connetti nella parte inferiore della pagina Configura .

  6. Esaminare i dettagli nella pagina Rivedi e connetti e quindi selezionare Connetti.

Visualizzare i dettagli del flusso dei dati

  1. Nella pagina Rivedi e connetti , se si seleziona Apri eventstream, la procedura guidata apre il flusso di eventi creato automaticamente con l'hub eventi selezionato come origine. Per chiudere la procedura guidata, selezionare Fine nella parte inferiore della pagina.

    Screenshot che mostra la pagina Review + Connect con collegamenti per aprire Eventstream e chiudere la procedura guidata.

  2. Il flusso viene visualizzato nella sezione Dati di streaming recenti della home page dell'hub Real-Time. Per i passaggi dettagliati, vedere Visualizzare i dettagli dei flussi dei dati nell'Hub in tempo reale di Fabric.

    Screenshot che mostra la pagina di tutti i flussi di dati dell’hub Real-Time con il flusso appena creato.

Usare la scheda Tutte le origini per connettersi a un hub eventi

È anche possibile usare la scheda Tutte le origini nella pagina Aggiungi dati per connettersi a un hub eventi Azure. Tuttavia, è consigliabile usare la scheda Azure perché è più semplice connettersi a un hub eventi.

Nella pagina Aggiungi dati selezionare la categoria Microsoft nella parte superiore e quindi selezionare Hub eventi di Azure.

Screenshot che mostra la selezione di Hub eventi di Azure come tipo di origine nella pagina Aggiungi dati.

Seguire ora le istruzioni nella sezione Connettersi a un hub eventi di Azure .

Configurare e connettersi all'hub eventi di Azure

  1. In Configura impostazioni di connessione verificare che Sia selezionato Basic per il livello di funzionalità e quindi selezionare Nuova connessione.

    Screenshot che mostra la pagina per la configurazione di un'impostazione di connessione, con il collegamento per una nuova connessione evidenziata.

    Se è presente una connessione esistente all'hub eventi, selezionare la connessione esistente. Passare quindi alla configurazione del formato dati nei passaggi seguenti.

    Screenshot che mostra la pagina Connetti con una connessione esistente a un hub eventi di Azure.

  2. Nella sezione Impostazioni di connessione, seguire questi passaggi:

    1. Inserire il nome dello spazio dei nomi dell'Hub Eventi.
    2. Inserire il nome dell’Hub eventi.

    Screenshot che mostra le impostazioni di connessione con l'namespace di hub eventi e l'hub eventi specificato.

  3. Nella sezione Credenziali di connessione seguire questa procedura:

    1. In Nome connessione, immettere un nome per la connessione all'hub eventi.
    2. Per Tipo di autenticazione, verificare che sia selezionata l'opzione Chiave di accesso condiviso.
    3. In Nome chiave di accesso condiviso, immettere il nome della chiave di accesso condiviso. Per istruzioni su come ottenere una chiave di accesso, vedere Ottenere una stringa di connessione di Hub eventi di Azure.
    4. Per Chiave di accesso condiviso, immettere il valore della chiave di accesso condiviso.
    5. Selezionare Connetti.

    Screenshot che mostra le credenziali immesse per un connettore di Hub eventi di Azure.

  4. Per gruppo di consumatori, immettere il nome del gruppo di consumatori. Il gruppo di consumer predefinito per l'hub eventi è $Default.

  5. Per Formato dati selezionare un formato dati per gli eventi in tempo reale in ingresso che si desidera ottenere dall'hub eventi di Azure. È possibile selezionare i formati di dati JSON, Avro e CSV (con intestazione).

    Screenshot che mostra l'area per l'inserimento di un gruppo di consumatori e di un formato di dati.

  6. Nel riquadro Dettagli origine a destra selezionare l'icona a forma di matita accanto al nome dell'origine e quindi immettere un nome per l'origine. Questo passaggio è facoltativo.

    Screenshot che mostra l'icona a forma di matita per il nome della sorgente nel pannello per i dettagli della sorgente.

  7. Nella parte inferiore della pagina, selezionare Avanti.

    Screenshot che mostra il pulsante Avanti nella pagina per la configurazione delle impostazioni di connessione.

  8. Nella pagina Rivedi e connetti esaminare le impostazioni e quindi selezionare Aggiungi.

    Screenshot che mostra la pagina per esaminare le impostazioni e creare un connettore di Hub eventi di Azure.

  1. In Configura impostazioni di connessione selezionareFunzionalità estese per Scegliere il livello di funzionalità.

    Screenshot che mostra la pagina per la configurazione delle impostazioni di connessione, con l'opzione per le funzionalità estese selezionate.

    Se è presente una connessione esistente all'hub eventi, selezionare la connessione esistente. Passare quindi alla configurazione del formato dati nei passaggi seguenti.

  2. Nella sezione Impostazioni di connessione, seguire questi passaggi:

    1. Inserire il nome dello spazio dei nomi dell'Hub Eventi.

    2. Inserire il nome dell’Hub eventi.

      Screenshot che mostra le impostazioni di connessione con lo spazio dei nomi di Hub eventi e l'hub eventi specificato.

  3. Nella sezione Credenziali di connessione seguire questa procedura:

    1. In Nome connessione, immettere un nome per la connessione all'hub eventi.

    2. Per Tipo di autenticazione, verificare che sia selezionata l'opzione Chiave di accesso condiviso.

    3. In Nome chiave di accesso condiviso, immettere il nome della chiave di accesso condiviso. Per istruzioni su come ottenere una chiave di accesso, vedere Ottenere una stringa di connessione di Hub eventi di Azure.

    4. Per Chiave di accesso condiviso, immettere il valore della chiave di accesso condiviso.

    5. Selezionare Connetti.

      Screenshot che mostra le credenziali immesse per un connettore di Event Hubs.

  4. Per gruppo di consumatori, immettere il nome del gruppo di consumatori. Il gruppo di consumer predefinito per l'hub eventi è $Default.

    Screenshot che mostra l'area per l'immissione di un gruppo di consumatori per le funzionalità estese.

Dettagli del flusso o della sorgente

  1. Nella pagina Connetti seguire uno di questi passaggi in base al fatto che si usi Eventstream o Real-Time hub.

    • Eventstream:

      Nel riquadro Dettagli origine a destra seguire questa procedura:

      1. In Nome origine, selezionare il pulsante icona della matita per modificare il nome.

      2. Si noti che Eventstream name e il Stream name sono di sola lettura.

    • Hub in tempo reale:

      Nella sezione Dettagli flusso a destra seguire questa procedura:

      1. Selezionare l'area di lavoro Fabric in cui si vuole creare il flusso di eventi.

      2. Per Nome flusso di eventi, selezionare il pulsante Matita e immettere un nome per il flusso di eventi.

      3. Il valore del nome stream viene generato automaticamente aggiungendo -stream al nome del flusso di eventi. Questo flusso viene visualizzato nella pagina Tutti i flussi di dati dell'hub in tempo reale al termine della procedura guidata.

  2. Selezionare Avanti nella parte inferiore della pagina Configura .

Pagina di gestione dello schema

  1. Nella pagina Gestione dello schema specificare le regole per gestire gli eventi ricevuti dall'hub eventi selezionato, in modo che il flusso di eventi possa applicarli correttamente. Le regole di mapping dipendono dalla modalità di modellazione degli eventi.

    Se si dispone di uno schema che regola tutti gli eventi, selezionare Schema fisso.

    Se sono presenti più schemi che rappresentano i vari eventi in ingresso, definire le regole di corrispondenza per applicare gli schemi. Per scegliere questa modalità, selezionare Schema dinamico tramite intestazioni. Specificare quindi le regole usando coppie intestazione/valore per selezionare ogni schema. L'intestazione è una proprietà di intestazione Kafka personalizzata che fa parte dei metadati dell'evento. Il valore è il valore previsto per tale proprietà.

    Screenshot che mostra la pagina per la gestione dello schema, con l'opzione per le funzionalità estese selezionate.

  2. Scegliere gli schemi selezionando il menu a discesa Aggiungi altri schemi e quindi scegliendo uno o più schemi esistenti dal Registro di sistema dello schema eventi. Se non si hanno schemi tra cui scegliere, è possibile creare nuovi schemi da questa vista. Per informazioni su come definire un nuovo schema di eventi, vedere Creare e gestire schemi di eventi nei set di schemi.

    Screenshot che mostra l'area per l'aggiunta di schemi, con l'opzione dello schema fisso selezionata.

    Se è stata selezionata l'opzione Scegli dal registro degli schemi eventi, viene visualizzato il riquadro Associa uno schema eventi. Selezionare uno o più schemi dal Registro di sistema, a seconda della modalità di corrispondenza dello schema e quindi selezionare Scegli nella parte inferiore del riquadro.

    Screenshot che mostra il riquadro per l'associazione di uno schema di eventi.

  3. Se è stata selezionata l'opzione Schema fisso , non è necessario specificare altre regole in modo che corrispondano allo schema. È possibile continuare con il passaggio successivo.

    Se è stata selezionata l'opzione Schema dinamico tramite intestazioni, specificare la proprietà dell'intestazione Kafka e il valore previsto che corrisponde allo schema. Aggiungere altri schemi e specificare proprietà dell'intestazione e / o valori diversi per eseguire il mapping a tali schemi.

    Annotazioni

    Quando si definiscono le regole di mapping, ogni valore dell'intestazione deve essere univoco. Se si tenta di riutilizzare uno schema, viene visualizzato un messaggio di avviso che indica che è possibile interrompere i flussi esistenti. Purché le regole di mapping siano le stesse, è possibile riutilizzare uno schema. Se questa limitazione influisce sull'uso, contattare il rappresentante Microsoft per condividere il feedback. Microsoft sta lavorando attivamente per rimuovere questa limitazione.

    Screenshot che mostra una proprietà e un valore mappato a uno schema.

  4. Dopo aver eseguito il mapping degli schemi per tutti gli eventi previsti, selezionare Avanti nella parte inferiore della pagina Gestione dello schema .

    Screenshot che mostra il pulsante Avanti nella pagina per la gestione dello schema.

Verificare e connettere

  1. Nella pagina Rivedi e connetti esaminare le impostazioni e quindi selezionare Connetti.

    Screenshot che mostra la pagina per esaminare le impostazioni e creare un connettore di Hub eventi di Azure quando le funzionalità estese sono abilitate.

  2. Nella pagina Rivedi e connetti selezionare Aggiungi (Eventstream) o Connetti (Real-Time hub).

    Screenshot che mostra la pagina per la revisione delle impostazioni e la creazione di un connettore dopo la creazione corretta delle risorse.

Per informazioni sull'utilizzo dei flussi di dati, vedere gli articoli seguenti: