Condividi tramite

Hub eventi adapter in BizTalk

Informazioni generali

A partire da BizTalk Server 2016 Feature Pack 2, è possibile inviare e ricevere messaggi tra BizTalk Server e Hub eventi di Azure.

Hub eventi di Azure è una piattaforma di streaming di dati altamente scalabile e può ricevere ed elaborare milioni di eventi al secondo. Che cos'è Hub eventi? fornisce altri dettagli.

Prerequisiti

L'hub eventi viene ora creato e sono disponibili le stringhe di connessione necessarie per inviare e ricevere eventi.

Inviare messaggi a Hub eventi

  1. Nella console di amministrazione di BizTalk Server fare clic con il pulsante destro del mouse su Porte di trasmissione, scegliere Nuovo e selezionare Porta di trasmissione statica unidirezionale.

    La creazione di una porta di trasmissione fornisce alcune indicazioni.

  2. Immettere un nome. In Trasporto impostare Tipo su EventHub e selezionare Configura.

  3. Configurare le proprietà dell'account Azure :

    Usare questo Per farlo
    Accesso Accedi al tuo account Azure
    Abbonamento Selezionare l'abbonamento che include il namespace di EventHubs
    Gruppo di risorse Seleziona il gruppo di risorse che ha il tuo spazio dei nomi di EventHubs

  4. Configurare le proprietà endpoint :

    Usare questo Per farlo
    spazio dei nomi Seleziona il tuo namespace di Event Hubs, ad esempio sb://youreventhubnamespace.servicebus.windows.net/
    Nome Selezionare il nome dell'hub eventi (creato all'interno dello spazio dei nomi di Hub eventi)
    Chiave di partizione predefinita Opzionale. La guida alla programmazione di Hub eventi fornisce altri dettagli su questa chiave.
    Autenticazione La firma di accesso allo spazio dei nomi è l'impostazione predefinita e usa automaticamente il RootManageSharedAccessKey creato quando si crea uno spazio dei nomi di Event Hubs.

    Entity Access Signature è la politica di firma di accesso condiviso che è possibile creare a livello di Hub eventi (non a livello di spazio dei nomi di Hub eventi).

    Panoramica delle funzionalità di Hub eventi illustra di più.

    Al termine, le proprietà appariranno simili a quanto segue:

    Proprietà di esempio dello spazio dei nomi, del nome, della chiave di partizione e dell'autenticazione nelle proprietà dell'endpoint della porta di invio dell'adattatore dell'hub eventi in BizTalk Server

  5. Opzionale. Configurare le proprietà del messaggio . Il valore Namespace for User Defined Message Properties rappresenta lo spazio dei nomi per le proprietà del contesto mappate alle proprietà del messaggio di Event Hubs. A tale scopo, è possibile usare uno schema di proprietà.

  6. Selezionare OK per salvare le modifiche.

Testare la porta di trasmissione

È possibile usare una semplice porta di ricezione file e un percorso per inviare messaggi all'hub eventi di Azure.

  1. Creare una porta di ricezione usando l'adattatore File. All'interno del percorso di ricezione impostare la cartella Receive su C:\Temp\In\e impostare la maschera file su *.xml.

  2. Nelle proprietà della porta di trasmissione dell'hub eventi, impostare i Filtri su BTS.ReceivePortName == FileReceivePort.

  3. Incollare il codice seguente in un editor di testo e salvare il file come EventHubMessage.xml. Questo è il messaggio di esempio.

    <Data>
  <DataID>DataID_0</DataID>
  <DataDetails>DataDetails_0</DataDetails>
</Data>

  4. Avvia il percorso di ricezione dei file e la porta di invio dell'Event Hub.

  5. Copiare il messaggio di esempio EventHubMessage.xml nella cartella Ricezione (C:\Temp\In). La porta di trasmissione invia il file XML all'hub eventi.

Ricevere messaggi da Hub eventi

  1. Nella console di amministrazione di BizTalk Server fare clic con il pulsante destro del mouse su Porte di ricezione, scegliere Nuovo e selezionare One-Way porta di ricezione.

    Creare una porta di ricezione fornisce alcune indicazioni.

  2. Immettere un nome e selezionare Località di ricezione.

  3. Selezionare Nuovo e assegnare un nome al percorso di ricezione. In Trasporto selezionare EventHub dall'elenco a discesa Tipo e quindi selezionare Configura.

  4. Configurare le proprietà dell'account Azure :

    Usare questo Per farlo
    Accesso Accedi al tuo account Azure
    Abbonamento Selezionare l'abbonamento con il namespace EventHubs
    Gruppo di risorse Selezionare il gruppo di risorse che contiene il namespace EventHubs

  5. Configurare le proprietà endpoint :

    Usare questo Per farlo
    spazio dei nomi Seleziona il tuo spazio dei nomi di Event Hubs, che è simile a sb://youreventhubnamespace.servicebus.windows.net/
    Nome Selezionare il nome del tuo Hub Eventi (che è stato creato all'interno dello spazio dei nomi di Hub Eventi)
    Gruppo di consumer Selezionare il gruppo Consumer all'interno dell'hub eventi. Viene creato automaticamente un gruppo predefinito.

    La panoramica delle funzionalità di Hub eventi offre altri dettagli.
    Autenticazione La firma di accesso allo spazio dei nomi è l'impostazione predefinita e utilizza automaticamente la chiave RootManageSharedAccessKey che viene creata quando si crea un Hub di eventi.

    Entity Access Signature è la politica SAS che è possibile creare a livello di singolo hub eventi (non a livello del namespace di Hub eventi).

    Panoramica delle funzionalità di Hub eventi illustra di più.

    Al termine, le proprietà appariranno simili a quanto segue:

    Spazio dei nomi, nome, gruppo di consumatori e proprietà di autenticazione di esempio nelle proprietà dell'endpoint di ricezione dell'adapter di Event Hub in BizTalk Server

  6. Configurare le proprietà del Checkpoint. Questo adattatore utilizza un account di archiviazione Blob di Azure per leggere gli eventi in modo affidabile usando un checkpoint e riprendere dopo un riavvio.

    Autenticazione di memoria
    Selezionare un metodo di autenticazione. In genere, è consigliabile usare una firma di accesso condiviso. I collegamenti seguenti sono risorse valide che consentono di decidere quale sia il giusto per lo scenario:

    Informazioni sugli account di archiviazione di Azure
    Uso delle firme di accesso condiviso

    Al termine, le proprietà appariranno simili a quanto segue:

    Proprietà del checkpoint

  7. Configurare le proprietà del messaggio :

    Usare questo Per farlo
    Spazio dei nomi per le proprietà dei messaggi definiti dall'utente http://schemas.microsoft.com/BizTalk/EventHubAdapter/EventData/User è lo schema predefinito, ma è possibile immettere un altro schema. Questo valore rappresenta uno schema di messaggi BizTalk mappato alle proprietà dei messaggi di Hub eventi.
    Alzare di livello le proprietà definite dall'utente Opzionale. Se si preferisce, è possibile promuovere queste proprietà.

    NOTA:
    Le proprietà che devono essere alzate di livello devono avere uno schema di proprietà distribuito prima di ricevere eventi.

  8. Selezionare OK per salvare le modifiche.

Testare le impostazioni di ricezione

È possibile usare una semplice porta di trasmissione file per ricevere messaggi dall'hub eventi di Azure.

  1. Creare una porta di trasmissione usando l'adapter File. Nelle proprietà della porta di trasmissione, impostare la cartella Destinazione su C:\Temp\Out\, e impostare il Nome file su %MessageID%.xml.
  2. Nelle proprietà della porta di trasmissione file impostare Filtri su BTS.ReceivePortName == EHReceivePort.
  3. Avvia il percorso di ricezione dell'hub eventi e la porta di trasmissione file.
  4. Cercare i messaggi nella cartella di destinazione (c:\temp\out).

Fare di più

Hub eventi è considerato "frontdoor" per molti altri servizi di Azure, tra cui Azure Data Lake, HD Insight e altro ancora. È progettato per elaborare molti messaggi ed elaborarli rapidamente. Altre informazioni su Hub eventi e sulle relative funzionalità:

Panoramica delle funzionalità di Hub eventi
Che cos'è Hub eventi?