Adapter hub eventi in BizTalk

Panoramica

A partire da BizTalk Server Feature Pack 2016, è 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

• Creare uno spazio dei nomi e un hub eventi di Hub eventi di Azure
• Creare un account di archiviazione BLOB di Azure con un contenitore
• Installare Feature Pack 2 nel BizTalk Server

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

Inviare messaggi all'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	Per
   Accesso	Accedere all'account Azure
   Sottoscrizione	Selezionare la sottoscrizione con lo spazio dei nomi EventHubs
   Gruppo di risorse	Selezionare il gruppo di risorse con lo spazio dei nomi EventHubs

4. Configurare le proprietà dell'endpoint :

   Usare	Per
   Spazio dei nomi	Selezionare lo spazio dei nomi di Hub eventi, che è simile a sb:// youreventhubnamespace.servicebus.windows.net/
   Nome	Selezionare il nome dell'hub eventi (creato nello spazio dei nomi di Hub eventi)
   Chiave di partizione predefinita	facoltativo. 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 RootManageSharedAccessKey creato quando si crea uno spazio dei nomi di Hub eventi. La firma di accesso alle entità è il criterio di firma di accesso condiviso che è possibile creare a livello di hub eventi (non a livello di spazio dei nomi di Hub eventi). La panoramica delle funzionalità di Hub eventi illustra di più.

   Al termine, le proprietà sono simili alle seguenti:

   

5. facoltativo. 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 Hub eventi. 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 di file su *.xml.

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

3. Incollare quanto segue 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. Avviare il percorso di ricezione file e la porta di trasmissione dell'hub eventi.

5. Copiare EventHubMessage.xmlmessaggio di esempio nella cartella di 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 Porta di ricezione unidirezionale.

   La creazione di 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 nell'elenco a discesa Tipo e quindi selezionare Configura.

4. Configurare le proprietà dell'account Azure :

   Usare	Per
   Accesso	Accedere all'account Azure
   Sottoscrizione	Selezionare la sottoscrizione con lo spazio dei nomi EventHubs
   Gruppo di risorse	Selezionare il gruppo di risorse con lo spazio dei nomi EventHubs

5. Configurare le proprietà dell'endpoint :

   Usare	Per
   Spazio dei nomi	Selezionare lo spazio dei nomi di Hub eventi, che è simile a sb:// youreventhubnamespace.servicebus.windows.net/
   Nome	Selezionare il nome dell'hub eventi (creato nello 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 usa automaticamente RootManageSharedAccessKey creato quando si crea uno spazio dei nomi di Hub eventi. La firma di accesso alle entità è il criterio di firma di accesso condiviso che è possibile creare a livello di hub eventi (non a livello di spazio dei nomi di Hub eventi). La panoramica delle funzionalità di Hub eventi illustra di più.

   Al termine, le proprietà sono simili alle seguenti:

   

6. Configurare le proprietà checkpoint . Questa scheda usa un account di archiviazione BLOB di Azure per leggere in modo affidabile gli eventi usando un checkpoint e riprendere da un riavvio.

   Autenticazione dell'archiviazione
   Selezionare un metodo di autenticazione. In genere, è consigliabile usare una firma di accesso condiviso. I collegamenti seguenti sono risorse utili per decidere quale sia la scelta più adatta allo scenario:
   
   Informazioni sugli account di archiviazione di Azure
   Uso delle firme di accesso condiviso

   Al termine, le proprietà sono simili alle seguenti:

   

7. Configurare le proprietà del messaggio :

   Usare	Per
   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 messaggio BizTalk mappato alle proprietà del messaggio di Hub eventi.
   Alzare di livello le proprietà definite dall'utente	facoltativo. È possibile alzare di livello queste proprietà se si preferisce. 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. All'interno delle proprietà della porta di trasmissione impostare la cartella Destination su C:\Temp\Out\e impostare e Nome file su %MessageID%.xml.
2. Nelle proprietà della porta di trasmissione file impostare Filtri su BTS.ReceivePortName == EHReceivePort.
3. Avviare 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 il "frontdoor" di 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?