Adaptateur Event Hub dans BizTalk

Vue d’ensemble

À compter de BizTalk Server 2016 Feature Pack 2, vous pouvez envoyer et recevoir des messages entre BizTalk Server et Azure Event Hubs.

Azure Event Hubs est une plateforme de streaming de données hautement évolutive qui peut recevoir et traiter des millions d’événements par seconde. Qu’est-ce qu’Event Hubs ? fournit plus de détails.

Prérequis

• Créer un espace de noms et un hub d’événements Azure Event Hubs
• Créer un compte de stockage d’objets blob Azure avec un conteneur
• Installer Feature Pack 2 sur votre BizTalk Server

Votre concentrateur d’événements est désormais créé et vous disposez des chaînes de connexion dont vous avez besoin pour envoyer et recevoir des événements.

Envoi de messages vers Event Hubs

1. Dans la console d’administration BizTalk Server, cliquez avec le bouton droit sur Envoyer des ports, sélectionnez Nouveau, puis sélectionnez Port d’envoi unidirectionnel statique.

   Créer un port d’envoi fournit des conseils.

2. Saisissez un Nom. Dans Transport, définissez type sur EventHub, puis sélectionnez Configurer.

3. Configurez les propriétés du compte Azure :

   Propriété	Pour
   Connexion	Connectez-vous à votre compte Azure
   Abonnement	Sélectionnez l’abonnement qui a votre espace de noms EventHubs
   Groupe de ressources	Sélectionnez votre groupe de ressources qui a votre espace de noms EventHubs

4. Configurez les propriétés du point de terminaison :

   Propriété	Pour
   Espace de noms	Sélectionnez votre espace de noms Event Hubs, ce qui est quelque chose comme sb:// youreventhubnamespace.servicebus.windows.net/
   Nom	Sélectionnez le nom de votre hub d’événements (qui a été créé dans votre espace de noms Event Hubs)
   Clé de partition par défaut	facultatif. Le guide de programmation Event Hubs fournit plus d’informations sur cette clé.
   Authentification	La signature d’accès à l’espace de noms est la valeur par défaut et utilise automatiquement rootManageSharedAccessKey qui est créée lorsque vous créez un espace de noms Event Hubs. La signature d’accès d’entité est la stratégie SAP que vous pouvez créer au niveau du hub d’événements (et non au niveau de l’espace de noms Event Hubs). Vue d’ensemble des fonctionnalités d’Event Hubs en explique plus.

   Lorsque vous avez terminé, vos propriétés ressemblent à ce qui suit :

   

5. facultatif. Configurez les propriétés message . La valeur Espace de noms pour propriétés de message définies par l’utilisateur représente l’espace de noms pour les propriétés de contexte mappées aux propriétés de message Event Hubs. Cela peut être réalisé à l’aide d’un schéma de propriété.

6. Sélectionnez OK pour enregistrer vos modifications.

Tester votre port d’envoi

Vous pouvez utiliser un port et un emplacement de réception de fichiers simples pour envoyer des messages à votre hub d’événements Azure.

1. Créez un port de réception à l’aide de l’adaptateur File. Dans votre emplacement de réception, définissez le dossier Réception sur C :\Temp\In\, puis définissez le masque de fichier sur *.xml.

2. Dans les propriétés du port d’envoi de votre hub d’événements, définissez filtres sur BTS.ReceivePortName == FileReceivePort.

3. Collez ce qui suit dans un éditeur de texte, puis enregistrez le fichier en tant que EventHubMessage.xml. Il s’agit de votre exemple de message.

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

4. Démarrez l’emplacement de réception de fichiers et le port d’envoi Event Hub.

5. Copiez EventHubMessage.xml exemple de message dans le dossier de réception (C :\Temp\In). Le port d’envoi envoie le fichier XML au hub d’événements.

Recevoir des messages à partir d’Event Hubs

1. Dans la console d’administration BizTalk Server, cliquez avec le bouton droit sur Ports de réception, sélectionnez Nouveau, puis port de réception unidirectionnel.

   Créer un port de réception fournit des conseils.

2. Entrez un nom, puis sélectionnez Emplacements de réception.

3. Sélectionnez Nouveau, puis Nommez l’emplacement de réception. Dans Transport, sélectionnez EventHub dans la liste déroulante Type , puis sélectionnez Configurer.

4. Configurez les propriétés du compte Azure :

   Propriété	Pour
   Connexion	Connectez-vous à votre compte Azure
   Abonnement	Sélectionnez l’abonnement qui a votre espace de noms EventHubs
   Groupe de ressources	Sélectionnez votre groupe de ressources qui a votre espace de noms EventHubs

5. Configurez les propriétés du point de terminaison :

   Propriété	Pour
   Espace de noms	Sélectionnez votre espace de noms Event Hubs, ce qui est quelque chose comme sb:// youreventhubnamespace.servicebus.windows.net/
   Nom	Sélectionnez le nom de votre hub d’événements (qui a été créé dans votre espace de noms Event Hubs)
   Groupe de consommateurs	Sélectionnez le groupe Consommateur dans votre hub d’événements. Un groupe par défaut est créé automatiquement. Vue d’ensemble des fonctionnalités Event Hubs fournit plus de détails.
   Authentification	La signature d’accès à l’espace de noms est la valeur par défaut et utilise automatiquement rootManageSharedAccessKey qui est créée lorsque vous créez un espace de noms Event Hubs. La signature d’accès d’entité est la stratégie SAP que vous pouvez créer au niveau du hub d’événements (et non au niveau de l’espace de noms Event Hubs). Vue d’ensemble des fonctionnalités d’Event Hubs en explique plus.

   Lorsque vous avez terminé, vos propriétés ressemblent à ce qui suit :

   

6. Configurez les propriétés du point de contrôle . Cet adaptateur utilise un compte de stockage d’objets blob Azure pour lire de manière fiable les événements à l’aide d’un point de contrôle et reprendre à partir d’un redémarrage.

   Authentification du stockage
   Sélectionnez une méthode d’authentification. En règle générale, il est recommandé d’utiliser une signature d’accès partagé. Les liens suivants sont de bonnes ressources pour vous aider à décider qui convient à votre scénario :
   
   À propos des comptes de stockage Azure
   Utilisation des signatures d’accès partagé (SAP)

   Lorsque vous avez terminé, vos propriétés ressemblent à ce qui suit :

   

7. Configurez les propriétés message :

   Propriété	Pour
   Espace de noms pour les propriétés des messages définis par l’utilisateur	http://schemas.microsoft.com/BizTalk/EventHubAdapter/EventData/User est le schéma par défaut, mais vous pouvez entrer un autre schéma. Cette valeur représente un schéma de message BizTalk mappé aux propriétés de message Event Hubs.
   Promouvoir les propriétés définies par l’utilisateur	facultatif. Vous pouvez promouvoir ces propriétés si vous préférez. REMARQUE Les propriétés qui doivent être promues doivent avoir un schéma de propriété déployé avant de recevoir des événements.

8. Sélectionnez OK pour enregistrer vos modifications.

Tester vos paramètres de réception

Vous pouvez utiliser un port d’envoi de fichiers simple pour recevoir des messages de votre hub d’événements Azure.

1. Créez un port d’envoi à l’aide de l’adaptateur de fichier. Dans vos propriétés de port d’envoi, définissez le dossier Destination sur C :\Temp\Out\, puis définissez le nom de fichier et sur %MessageID%.xml.
2. Dans vos propriétés de port d’envoi de fichier, définissez filtres sur BTS.ReceivePortName == EHReceivePort.
3. Démarrez l’emplacement de réception Event Hub et le port d’envoi du fichier.
4. Recherchez les messages dans le dossier de destination (c :\temp\out).

En faire plus

Event Hubs est considéré comme la « porte d’entrée » d’un grand nombre d’autres services Azure, notamment Azure Data Lake, HD Insight, etc. Il est conçu pour traiter un grand nombre de messages et les traiter rapidement. En savoir plus sur Event Hubs et ses fonctionnalités :

Vue d’ensemble des fonctionnalités des concentrateurs d’événements
Qu’est-ce qu’Event Hubs ?