Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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.
Passa alla pagina Aggiungi dati
Accedi a Microsoft Fabric.
Se vedi Power BI in basso a sinistra nella pagina, passa al carico di lavoro Fabric scegliendo Power BI e quindi scegliendo Fabric.
Selezionare Tempo Reale sulla barra di navigazione a sinistra.
Per impostazione predefinita, viene visualizzata la pagina Streaming data (Dati di streaming ). Fare clic sul pulsante Aggiungi dati per passare alla pagina Aggiungi dati .
È anche possibile accedere direttamente alla pagina Aggiungi dati selezionando l'opzione Aggiungi dati nella barra di spostamento a sinistra.
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.
Usare la scheda Azure per connettersi a un hub eventi (scelta consigliata)
Nella pagina Aggiungi dati passare alla scheda Azure.
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.
Nella procedura guidata Connetti origine dati, nella pagina Configura, seguire questi passaggi:
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.
Selezionare il nome della chiave dall'elenco a discesa. Il menu a discesa viene popolato con i nomi delle chiavi dell'hub eventi selezionato.
Per Gruppo di consumer, selezionare $Default o immettere il nome di un gruppo di consumer personalizzato creato per questo hub di eventi.
Per Formato dati selezionare il formato degli eventi nell'hub eventi, ad esempio JSON, Avro e così via.
Nella sezione Dettagli flusso a destra seguire questa procedura:
Selezionare l'area di lavoro Fabric in cui si vuole creare il flusso di eventi.
Per Nome flusso di eventi, selezionare il pulsante Matita e immettere un nome per il flusso di eventi.
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.
Selezionare Rivedi e connetti nella parte inferiore della pagina Configura .
Esaminare i dettagli nella pagina Rivedi e connetti e quindi selezionare Connetti.
Nella pagina Aggiungi dati passare alla scheda Azure.
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.
Nella procedura guidata Connetti origine dati, nella pagina Configura, seguire questi passaggi:
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.
Selezionare il nome della chiave dall'elenco a discesa. L'elenco a discesa viene popolato con i nomi delle chiavi dell'hub eventi selezionato.
In Livello di funzionalità selezionare Funzionalità estese.
- 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.
- 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.
Nella sezione Dettagli flusso a destra seguire questa procedura:
Selezionare l'area di lavoro Fabric in cui si vuole creare il flusso di eventi.
Per Nome flusso di eventi, selezionare il pulsante Matita e immettere un nome per il flusso di eventi.
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.
Selezionare Avanti nella parte inferiore della pagina Configura .
Pagina di gestione dello schema
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à.
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.
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.
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.
Dopo aver eseguito il mapping degli schemi per tutti gli eventi previsti, selezionare Avanti nella parte inferiore della pagina Gestione dello schema .
Selezionare Rivedi e connetti nella parte inferiore della pagina Configura .
Esaminare i dettagli nella pagina Rivedi e connetti e quindi selezionare Connetti.
Visualizzare i dettagli del flusso dei dati
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.
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.
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.
Seguire ora le istruzioni nella sezione Connettersi a un hub eventi di Azure .
Configurare e connettersi all'hub eventi di Azure
In Configura impostazioni di connessione verificare che Sia selezionato Basic per il livello di funzionalità e quindi selezionare Nuova connessione.
Se è presente una connessione esistente all'hub eventi, selezionare la connessione esistente. Passare quindi alla configurazione del formato dati nei passaggi seguenti.
Nella sezione Impostazioni di connessione, seguire questi passaggi:
- Inserire il nome dello spazio dei nomi dell'Hub Eventi.
- Inserire il nome dell’Hub eventi.
Nella sezione Credenziali di connessione seguire questa procedura:
- In Nome connessione, immettere un nome per la connessione all'hub eventi.
- Per Tipo di autenticazione, verificare che sia selezionata l'opzione Chiave di accesso condiviso.
- 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.
- Per Chiave di accesso condiviso, immettere il valore della chiave di accesso condiviso.
- Selezionare Connetti.
Per gruppo di consumatori, immettere il nome del gruppo di consumatori. Il gruppo di consumer predefinito per l'hub eventi è $Default.
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).
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.
Nella parte inferiore della pagina, selezionare Avanti.
Nella pagina Rivedi e connetti esaminare le impostazioni e quindi selezionare Aggiungi.
In Configura impostazioni di connessione selezionareFunzionalità estese per Scegliere il livello di funzionalità.
Se è presente una connessione esistente all'hub eventi, selezionare la connessione esistente. Passare quindi alla configurazione del formato dati nei passaggi seguenti.
Nella sezione Impostazioni di connessione, seguire questi passaggi:
Nella sezione Credenziali di connessione seguire questa procedura:
In Nome connessione, immettere un nome per la connessione all'hub eventi.
Per Tipo di autenticazione, verificare che sia selezionata l'opzione Chiave di accesso condiviso.
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.
Per Chiave di accesso condiviso, immettere il valore della chiave di accesso condiviso.
Selezionare Connetti.
Per gruppo di consumatori, immettere il nome del gruppo di consumatori. Il gruppo di consumer predefinito per l'hub eventi è $Default.
Dettagli del flusso o della sorgente
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:
In Nome origine, selezionare il pulsante icona della matita per modificare il nome.
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:
Selezionare l'area di lavoro Fabric in cui si vuole creare il flusso di eventi.
Per Nome flusso di eventi, selezionare il pulsante Matita e immettere un nome per il flusso di eventi.
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.
Selezionare Avanti nella parte inferiore della pagina Configura .
Pagina di gestione dello schema
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à.
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.
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.
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.
Dopo aver eseguito il mapping degli schemi per tutti gli eventi previsti, selezionare Avanti nella parte inferiore della pagina Gestione dello schema .
Verificare e connettere
Contenuti correlati
Per informazioni sull'utilizzo dei flussi di dati, vedere gli articoli seguenti: