Ajouter une destination de base de données KQL à un eventstream

Cet article vous montre comment ajouter une base de données KQL en tant que destination à un Eventstream Microsoft 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.
• 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.
• La conservation des données d’événement dans un flux d’événements est de 1 jour, avec la possibilité de l’étendre et de la rendre configurable à l’avenir.

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.

   

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.

      

   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.

      

      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.

      

      

   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.

      

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.

   

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.

   

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

   

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.

   

   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.

   

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.

   

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.

Contenu connexe

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

• Lakehouse
• Système Reflex
• Application personnalisée

Pour ajouter une destination à un Eventstream, consultez les articles suivants :

• Ajouter des sources à un flux d’événements et les gérer
• Créer et gérer un flux d’événements