Partager via

Ajouter une destination Eventhouse à un flux d’évènement

  • Article

Cet article vous montre comment ajouter un Eventhouse en tant que destination à un flux d’évènement dans les flux d’évènements Microsoft Fabric.

Remarque

Si vous souhaitez utiliser des fonctionnalités améliorées en préversion, sélectionnez Fonctionnalités améliorées en haut. Sinon, sélectionnez Fonctionnalité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

  • Accédez à un espace de travail Premium de Fabric où se trouve votre Eventstream avec les autorisations Contributeur ou supérieures.
  • Accédez à un Eventhouse créé dans un espace de travail premium Fabric dans lequel vous disposez d’autorisations Contributeur ou supérieures.

Remarque

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

Ajouter un Eventhouse en tant que destination

Pour ajouter un Eventhouse comme destination, vous avez le choix entre deux modes d'ingestion : Ingestion directe ou Traitement des évènements avant l'ingestion.

Mode ingestion directe

Le mode d’ingestion directe permet d'ingérer vos données d'évènement directement dans l’Eventhouse sans aucun traitement. Vous pouvez utiliser le mode d’ingestion directe pour ajouter une destination Eventhouse à votre flux par défaut.

Important

Vous pouvez utiliser l’ingestion directe uniquement pour votre flux par défaut. L’ingestion directe ne peut pas suivre les opérateurs de traitement ou les flux dérivés. Si vous souhaitez ajouter une destination Eventhouse après les opérateurs de traitement ou les flux dérivés, utilisez Traitement des évènements avant l’ingestion à la place.

  1. Dans le Mode édition de votre flux d’évènement, sélectionnez Ajouter une destination dans le ruban ou sélectionnez la carte Transformer les évènements ou ajouter une destination sur le canevas, puis sélectionnez Eventhouse.

    Capture d’écran de la sélection de Eventhouse dans la liste déroulante Ajouter une destination.

  2. Dans l’écran Eventhouse, sélectionnez Ingestion directe.

  3. Entrez un Nom de destination, un Espace de travail et un Eventhouse depuis l’espace de travail sélectionné.

  4. Cliquez sur Enregistrer.

    Capture d’écran de l’écran de configuration Eventhouse.

  5. Connecter la nouvelle carte de destination Eventhouse à la sortie de votre flux d’évènement si ce n’est pas déjà le cas, puis sélectionnez Publier.

    Capture d’écran du flux d'événements avec le bouton Publier en surbrillance.

  6. En affichage en direct, sélectionnez Configurer dans le nœud de destination de la base de données KQL.

    Capture d’écran du Eventstreams publié avec le bouton Configurer dans la destination de base de données KQL mise en surbrillance.

  7. Votre base de données KQL s’ouvre dans l’écran Obtenir des données. Sélectionnez une table existante de la base de données KQL, ou sélectionnez Nouvelle table pour en créer une pour acheminer et ingérer les données.

  8. Fournissez un nom de connexion de données ou conservez le nom fourni, puis sélectionnez Suivant. L’extraction de données à partir du Eventstreams peut prendre quelques minutes.

    Capture d’écran de l’écran Obtenir des données pour la destination de la base de données KQL, avec le bouton Suivant mis en surbrillance.

  9. Dans l’écran Inspecter les données, vous pouvez :

    • Sélectionnez un Format pour avoir un aperçu de la manière dont les données sont envoyées à votre base de données KQL.
    • Sélectionnez Modifier les colonnes pour configurer les colonnes de vos données.
    • Sélectionnez Avancé pour sélectionner des événements à inclure ou choisir des options de mappage.

    Capture d’écran montrant les formats de données et les options Avancés sur l’écran Inspecter les données.

  10. Si vous sélectionnez Modifier des colonnes, dans l’écran Modifier les colonnes, vous pouvez :

    • Pour ajouter une colonne, sélectionnez Ajouter une colonne.
    • Sélectionnez les colonnes sources à mapper.
    • Appliquer la transformation de mappage aux colonnes.
    • Modifier les valeurs des exemples de données.

    Ensuite, sélectionnez Appliquer.

    Capture d’écran de l'écran Modifier les colonnes.

  11. Une fois que vous avez terminé de configurer les données, sélectionnez Terminer dans l’écran Inspecter les données.

  12. Sur l'écran Résumé, passez en revue les détails et l'état de votre ingestion de données, y compris la table avec le schéma que vous avez défini et la connexion entre le flux d'événements et la base de données KQL. Sélectionnez Fermer pour finaliser la configuration de la base de données KQL.

    Capture d’écran de l'écran Résumé avec le bouton Fermer en surbrillance.

Vous pouvez maintenant voir la destination de la base de données KQL sur le canevas en affichage en direct.

Capture d’écran de la destination de base de données KQL configurée en affichage en direct.

Traitement des événements avant l’ingestion

Le mode de traitement des événements avant l’ingestion traite vos données d’événement avant de les ingérer dans la base de données KQL. Utilisez ce mode si vous appliquez des opérateurs tels que le filtrage ou l’agrégation pour traiter les données avant l’ingestion ou après un flux dérivé.

  1. En mode Édition pour votre Eventstreams, pointez sur un opérateur ou un flux dérivé, sélectionnez +, puis sélectionnez base de données KQL.

    Capture d’écran de la sélection du symbole + pour la sortie de l’opérateur et de la sélection de la base de données KQL.

  2. Dans l’écran base de données KQL, le traitement des événements avant l’ingestion doit déjà être sélectionné. Renseignez le reste des informations sur votre base de données KQL, puis sélectionnez Enregistrer.

    Capture d’écran de l’écran de configuration de la base de données KQL pour le traitement des événements avant l’ingestion.

  3. Pour implémenter la destination de base de données KQL nouvellement ajoutée, sélectionnez Publier.

    Capture d’écran du Eventstreams en mode Édition avec la destination de base de données KQL ajoutée.

Une fois ces étapes terminées, le Eventstreams avec la destination de base de données KQL est disponible pour la visualisation en affichage en direct.

Capture d’écran du flux de traitement des événements de base de données KQL configuré dans affichage en direct.

Contenu connexe

Pour savoir comment ajouter d’autres destinations à 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.
  • Accès à un espace de travail Premium avec les autorisations Contributeur ou supérieures où se trouve votre base de données KQL.

Remarque

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

Ajouter une base de données KQL comme destination

Pour ajouter une base de données KQL en tant que destination, vous devez disposer d’une base de données KQL créée dans l’espace de travail et choisir entre deux modes d’ingestion : l’ingestion directe et le traitement des événements avant l’ingestion.

Ingestion directe

Ce mode ingère vos données d’événement directement dans la base de données KQL sans traitement. Vous pouvez utiliser ce mode si vous souhaitez ingérer vos données d’événement en l’état et effectuer tout traitement ou transformation ultérieurement dans la base de données KQL à l’aide de requêtes KQL.

  1. Sélectionnez Nouvelle destination dans le ruban ou « + » dans le canevas de l’éditeur principal, puis sélectionnez Base de données KQL. L’écran de configuration de la destination Base de données KQL s’affiche.

  2. Sélectionnez Ingestion directe, entrez un nom de destination, sélectionnez un espace de travail, choisissez une base de données KQL dans l’espace de travail sélectionné, puis sélectionnez Ajouter et configurer.

    Remarque

    Vous ne pouvez sélectionner que des espaces de travail qui ont la même capacité Fabric régionale que le flux d’événements.

    Capture d’écran de l’écran de configuration du mode récupérer de la destination Base de données KQL.

  3. Sur la page Obtenir des données, parcourez les onglets pour terminer la configuration :

    1. Configurer : utilisez une table existante de votre base de données KQL ou créez-en une pour acheminer et ingérer les données. Renseignez les champs obligatoires, puis sélectionnez Suivant.

      Capture d’écran montrant l’onglet Destination de l’écran Ingérer des données pour la création d’une destination Base de données KQL.

    2. Inspecter : sélectionnez un format de données, puis affichez un aperçu de la façon dont les données sont envoyées à votre base de données KQL.

      Capture d’écran montrant le format de données de l’écran Ingérer des données pour la création d’une destination Base de données KQL.

      Vous pouvez également modifier le nom de la colonne, le type de données ou la colonne de mise à jour en cliquant sur la flèche dans l’en-tête de la table. Renseignez les champs obligatoires, puis sélectionnez Terminer.

      Capture d’écran montrant comment changer la colonne de l’écran Ingérer des données pour la création d’une destination Base de données KQL.

      Capture d’écran montrant le changement du nom de la colonne, du type de données de l’écran Ingérer des données pour la création d’une destination de base de données KQL.

    3. Résumé : passez en revue l’état de votre ingestion de données, y compris la table créée avec le schéma que vous avez défini, ainsi que la connexion entre le flux d’événements et la base de données KQL.

      Capture d’écran montrant l’onglet Résumé de l’écran Ingérer des données pour la création d’une destination Base de données KQL.

  4. Après que vous avez tout configuré et sélectionné Fermer, une destination de base de données KQL s’affiche sur le canevas, connectée à votre eventstream.

    Capture d'écran montrant la nouvelle destination du mode récupérer de la base de données KQL.

Traitement des événements avant l’ingestion

Ce mode traite vos données d’événement avant de les ingérer dans la base de données KQL. Vous pouvez utiliser ce mode si vous souhaitez appliquer un traitement ou une transformation à vos données d’événement avant de les ingérer, telles que le filtrage, l’agrégation ou le développement. Vous pouvez concevoir la logique de traitement à l’aide du processeur d’événements.

  1. Sélectionnez Traitement des événements avant l’ingestion, renseignez les informations sur votre base de données KQL, puis sélectionnez Ouvrir le processeur d’événements.

    Capture d’écran de l’écran de configuration du mode envoyer de la destination Base de données KQL.

  2. Concevez le traitement des événements avec le processeur d’événements, puis sélectionnez Enregistrer

    Capture d’écran de l’écran du processeur d’événements en mode Envoi.

  3. Lorsque vous choisissez une table Kusto existante, la validation de schéma entre le schéma actuel dans cet eventstream et la table KQL cible est effectuée. Si les deux schémas ne sont pas mis en correspondance, un message d’erreur s’affiche et vous rappelle d’ouvrir le processeur d’événements pour ajuster le schéma dans cet eventstream en conséquence.

    Capture d’écran de l’écran d’erreur du processeur d’événements en mode Envoi.

    Lorsque vous ouvrez le processeur d’événements, les informations détaillées sur l’incompatibilité s’affichent sous l’onglet Création d’erreurs.

    Capture d’écran de l’écran des informations sur l’incompatibilité du processeur d’événements en mode Envoi.

  4. Après avoir configuré tout et sélectionné Enregistrer, une destination de base de données KQL apparaît sur le canevas, connectée à votre eventstream, et vous pouvez vérifier les métriques dans les Data insights et les journaux dans les journaux runtime.

    Capture d'écran montrant la nouvelle destination du mode envoyer de la base de données KQL.

Gérer une destination

Modifier/supprimer : vous pouvez modifier ou supprimer une destination de flux d’événements via le volet de navigation ou le canevas.

Quand vous sélectionnez Modifier, le volet Modifier s’ouvre à droite de l’éditeur principal. Vous pouvez modifier la configuration comme vous le souhaitez, y compris la logique de transformation des événements via l’éditeur du processeur d’événements.

Capture d’écran montrant l’emplacement de sélection des options de modification et de suppression pour les destinations sur le canevas.

Contenu connexe

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