Ajouter une source Azure Event Hubs à un Eventstream

Article
05/21/2024

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

Remarque

Si vous souhaitez utiliser des fonctionnalités améliorées en aperçu, sélectionnez Fonctionnalités améliorées en haut. Sinon, sélectionnez Capacités standard. Pour plus d’informations sur les fonctionnalités améliorées en aperçu, consultez Présentation des flux d’événements Fabric.

Prérequis

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

Accédez à un espace de travail Premium avec les autorisations Contributeur ou supérieures où se trouve votre flux d’événements.
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.

Important

Les fonctionnalités améliorées des Eventstreams Fabric sont actuellement en préversion.

Remarque

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

Ajouter Azure Event Hubs 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 :

Créez un Eventstream avec des fonctionnalités améliorées.
Si vous n’avez pas encore ajouté de source à votre Eventstreams, sélectionnez Ajouter une source externe dans la page Mise en route.

Si vous ajoutez un hub d’événements Azure en tant que source à un Eventstream déjà publié, basculez vers le mode Édition, sélectionnez Ajouter une source dans le ruban, puis sélectionnez Sources externes.

Configurer le connecteur Azure Event Hubs

Dans la page Sélectionner une source de données, sélectionnez Azure Event Hubs.
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.
Sur la page Connecter, sélectionnez Nouvelle connexion.
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.
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.
  
  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.
À 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.
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).
Sélectionnez Suivant au bas de la page.
Sur la page Réviser et créer, révisez les paramètres et sélectionnez Ajouter.

Vous voyez que la source Event Hubs est ajoutée à votre Eventstreams sur le canevas en mode Édition. 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é.

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 savoir comment ajouter d’autres sources à un Eventstream, consultez les articles suivants :

Prérequis

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

Accédez à un espace de travail Premium avec les autorisations Contributeur ou supérieures où se trouve votre flux d’événements.
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 :

Sélectionnez Nouvelle source dans le ruban ou « + » dans le canevas de l’éditeur principal, puis Azure Event Hubs.
Entrez un nom de source pour la nouvelle source et sélectionnez une connexion cloud à votre Event Hub Azure.
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.
- 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é.
Après avoir créé une connexion cloud, sélectionnez le bouton Actualiser, puis sélectionnez la connexion cloud que vous avez créée.
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

La fonctionnalité de flux d’événements prend 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).
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.