Partager via


Ajouter une source Azure Event Hubs à un Eventstream

Cet article vous montre comment ajouter une source Azure Event Hubs à un Eventstream.

Remarque

Les fonctionnalités améliorées sont activées par défaut si vous créez des flux d’événements maintenant. Si des flux d’événements existants ont été créés en utilisant les fonctionnalités standard, ces flux d’événements continueront à fonctionner. Vous pouvez toujours les modifier et les utiliser comme d’habitude. Nous vous recommandons de créer un nouveau flux d’événements pour remplacer les flux d’événements standard afin que vous puissiez tirer parti des fonctionnalités supplémentaires et des avantages des flux d’événements améliorés.

Prérequis

Pour commencer, vous devez remplir les conditions préalables suivantes :

  • Accès à un espace de travail dans en mode de licence de capacité Fabric (ou) en mode de licence Trial avec des autorisations Contributeur ou supérieures.
  • Vous devez disposer de l’autorisation appropriée pour obtenir les clés d’accès de l’Event Hub. L’Event Hub doit être accessible publiquement, et ne pas se trouver derrière un pare-feu ou sécurisé dans un réseau virtuel.
  • Créez un eventstream, si vous n’en avez pas déjà.

Lancer l’assistant Sélectionner une source de données

Si vous n’avez pas encore ajouté de source à votre flux d’événements, sélectionnez la vignette Utiliser une source externe.

Capture d’écran montrant la sélection de la vignette Utiliser une source externe.

Si vous ajoutez la source à un flux d’événements déjà publié, basculez vers le mode Édition, sélectionnez Ajouter une source dans le ruban, puis sélectionnez Sources externes.

Capture d’écran montrant la sélection du menu Ajouter une source à des sources externes.

Sur la page Sélectionner une source de données, recherchez et sélectionnez Se connecter dans la vignette Azure Event Hubs.

Capture d’écran montrant la sélection d’Azure Event Hubs comme type de source dans l’Assistant Obtenir les événements.

Configurer le connecteur Azure Event Hubs

  1. Sur la page Connecter, sélectionnez Nouvelle connexion.

    Capture d’écran montrant la page Connecter le lien Nouvelle connexion mis en surbrillance.

    S’il existe une connexion existante à votre Azure Event Hub, vous sélectionnez cette connexion existante comme indiqué dans l’image suivante, puis passez à l’étape pour configurer le format de données dans les étapes suivantes.

    Capture d’écran montrant la page Connecter avec une connexion existante à un hub d’événements Azure.

  2. Dans la section Paramètres de connexion, procédez comme suit :

    1. Saisissez le nom de l’espace de noms Event Hubs.

    2. Saisissez le nom de l’event hub.

      Capture d’écran montrant les paramètres de connexion avec l’espace de noms Event Hubs et l’event hub spécifié.

  3. Dans la section Identifiants de connexion, procédez comme suit :

    1. Pour le Nom de connexion de l’événement, saisissez un nom pour la connexion au event hub.

    2. Pour le type d’authentification, confirmez que la clé d’accès partagé est sélectionnée.

    3. Pour Nom de la clé d’accès partagé, saisissez le nom de la clé d’accès partagé.

    4. Pour la clé d’accès partagé,saisissez la valeur de la clé d’accès partagé.

    5. Sélectionnez Connecter au bas de la page.

      Capture d’écran montrant la première page Connecter pour le connecteur Azure Event Hubs.

      Pour obtenir le nom et la valeur de la clé d'accès, procédez comme suit :

      1. Accédez à la page de votre espace de noms Azure Event Hubs dans le portail Azure.

      2. Sur la page Espace de noms des Event Hubs, sélectionnez Stratégies d’accès partagées dans le menu de navigation de gauche.

      3. Sélectionnez la clé d’accès dans la liste. Notez le nom de la clé d’accès.

      4. Sélectionnez le bouton de copie à côté de la clé primaire.

        Capture d’écran montrant la clé d'accès pour un espace de noms Azure Event Hubs.

  4. À présent, dans la page Connecter de l’Assistant, pour le groupe de consommateurs, entrez le nom du groupe de consommateurs. Par défaut, $Default est sélectionné, qui est le groupe de consommateurs par défaut pour l’event hub.

  5. Pour Format de données, sélectionnez un format de données pour les événements en temps réel entrants que vous souhaitez obtenir à partir de votre Azure Event Hub. Vous pouvez sélectionner des formats de données JSON, Avro et CSV (avec en-tête).

  6. Dans le volet Détails du flux à droite, sélectionnez l'icône Crayon à côté du nom de la source et entrez un nom pour la source. Cette étape est facultative.

    Capture d’écran montrant le nom de la source dans la section Détails du flux.

  7. Sélectionnez Suivant au bas de la page.

    Capture d’écran montrant la seconde page Connecter pour le connecteur Azure Event Hubs.

  8. Sur la page Réviser et créer, révisez les paramètres et sélectionnez Ajouter.

    Capture d’écran montrant la page Vérifier et créer pour le connecteur Azure Event Hubs.

Remarque

Le nombre maximal de sources et de destinations pour un flux d’événements est de 11.

Afficher le flux d’événements mis à jour

  1. Vous voyez que la source Event Hubs est ajoutée à votre Eventstreams sur le canevas en mode Édition. Sélectionnez Actualiser dans le volet inférieur, qui vous montre l’aperçu des données dans Event Hub. Pour implémenter ce hub d’événements Azure nouvellement ajouté, sélectionnez Publier sur le ruban.

    Capture d’écran montrant l’éditeur avec le bouton Publier sélectionné.

  2. Une fois ces étapes terminées, le hub d’événements Azure est disponible pour la visualisation dans l’affichage en direct. Sélectionnez la vignette Event Hub dans le diagramme pour voir la page semblable à celle suivante.

    Capture d’écran montrant l’éditeur dans l’affichage en direct.

Pour une liste des sources prises en charge, consultez Ajouter une source de l’événement dans un eventstream

Prérequis

Pour commencer, vous devez remplir les conditions préalables suivantes :

  • Accès à un espace de travail dans en mode de licence de capacité Fabric (ou) en mode de licence Trial avec des autorisations Contributeur ou supérieures.
  • Vous devez disposer de l’autorisation appropriée pour obtenir les clés d’accès de l’Event Hub. L’Event Hub doit être accessible publiquement, et ne pas se trouver derrière un pare-feu ou sécurisé dans un réseau virtuel.

Remarque

Le nombre maximal de sources et de destinations pour un flux d’événements est de 11.

Ajouter un Event Hub Azure en tant que source

Si vous avez créé un Event Hub Azure avec des données de streaming, procédez comme suit pour ajouter un Event Hub Azure en tant que source de flux d’événements :

  1. Sélectionnez Nouvelle source dans le ruban ou « + » dans le canevas de l’éditeur principal, puis Azure Event Hubs.

  2. Entrez un nom de source pour la nouvelle source et sélectionnez une connexion cloud à votre Event Hub Azure.

    Capture d’écran de la configuration de source Azure Event Hubs.

  3. Si vous n’avez pas de connexion cloud, sélectionnez Créer une connexion pour en créer une. Pour créer une nouvelle connexion, renseignez les paramètres de connexion et les informations d’identification de connexion de votre Azure Event Hub, puis sélectionnez Créer.

    Capture d'écran de la connexion au cloud dans la source Event Hub.

    • Espace de noms Event Hub : entrez le nom de votre espace de noms Event Hub Azure.

    • Event Hub : entrez le nom de votre Event Hub Azure dans le portail Azure.

    • Nom de la connexion : entrez un nom pour la connexion cloud.

    • Nom de clé d'accès partagée et Clé d'accès partagée : accédez à votre Event Hub Azure et créez une stratégie avec l’autorisation Manage ou Listen sous Stratégies d’accès de partage. Utilisez ensuite le nom de la stratégie et la clé primaire comme Nom de la clé d’accès partagé et Clé d’accès partagé.

      Capture d’écran montrant la clé de stratégie Azure Event Hub.

  4. Après avoir créé une connexion cloud, sélectionnez le bouton Actualiser, puis sélectionnez la connexion cloud que vous avez créée.

    Capture d'écran de l’actualisation de la connexion cloud.

  5. Sélectionnez un Format de données des événements entrants en temps réel que vous souhaitez obtenir à partir de votre Event Hub Azure.

    Remarque

    Les flux d’événements prennent en charge l’ingestion d’événements à partir d’Azure Event Hubs dans les formats de données JSON, Avro et CSV (avec en-tête).

  6. Sélectionnez un groupe de consommateurs qui peut lire les données d’événement à partir de votre Event Hub Azure, puis sélectionnez Ajouter.

Une fois que vous avez créé la source Event Hub, vous voyez qu’elle est ajoutée à votre flux d’événements sur le canevas.

Capture d'écran de la source Event Hub.

Pour savoir comment ajouter d’autres sources à un Eventstream, consultez les articles suivants :