Partager via


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

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 :

    Exemples de propriétés d’espace de noms, de nom, de clé de partition et d’authentification dans l’adaptateur Event Hub pour envoyer les propriétés du point de terminaison de port dans BizTalk Server

  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 :

    Des exemples de propriétés d’espace de noms, de nom, de groupe de consommateurs et d’authentification dans l’adaptateur Event Hub reçoivent les propriétés du point de terminaison d’emplacement dans BizTalk Server

  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 :

    Propriétés du point de contrôle

  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 ?