Obtenir des données à partir d’Eventstream

Dans cet article, vous allez apprendre à obtenir des données d’un flux d’événements existant dans une table nouvelle ou existante.

Vous pouvez ingérer des données à partir de flux par défaut ou dérivés. Un flux dérivé est créé en ajoutant une série d’opérations de flux au flux d’événements, telles que Filtrer ou Gérer des champs. Pour plus d'informations, consultez Eventstream concepts.

Pour obtenir des données à partir d’un nouveau flux d’événements, consultez Obtenir des données à partir d’un nouveau flux d’événements.

Conditions préalables

• Un espace de travail avec une capacité activée par Microsoft Fabric.
• Une base de données KQL avec des autorisations d’édition.
• Flux d’événements avec une source de données.

Étape 1 : Source

Pour obtenir des données à partir d’un flux d’événements, sélectionnez le flux d’événements comme source de données. Sélectionnez un flux d’événements de la manière suivante :

Dans le ruban de la base de données KQL, soit :

• Dans l’option Obtenir des données du ruban, sélectionnez la vignette Eventstream .

• Dans le menu déroulant Obtenir des données, sélectionnez Eventstream>Eventstream existant.

• Dans le menu déroulant Obtenir des données , sélectionnez Real-Time hub de données, puis sélectionnez un flux d’événements dans la liste.

Étape 2 : Configurer

1. Sélectionnez une table cible. Pour ingérer des données dans une nouvelle table, sélectionnez + Nouvelle table et entrez un nom de table.

   Remarque

   Les noms de tables peuvent comporter jusqu’à 1 024 caractères, y compris des espaces, des caractères alphanumériques, des traits d’union et des tirets bas. Les caractères spéciaux ne sont pas pris en charge.

2. Sous Configurer la source de données, renseignez les paramètres à l’aide des informations contenues dans le tableau suivant :

   • Lorsque vous sélectionnez Eventstream comme source, spécifiez l’espace de travail, Eventstream et le flux dérivé par défaut.

   Important

   La fonctionnalité permettant d’obtenir des données à partir de flux dérivés est en préversion.

   

   • Lorsque vous sélectionnez Real-Time hub comme source, vous choisissez un flux par défaut ou dérivé dans la liste, et l’espace de travail, Eventstream et Stream sont automatiquement renseignés et ne nécessitent pas de configuration.

   

   Paramètre	Description
   Espace de travail	Emplacement de votre espace de travail Eventstream. Sélectionnez un espace de travail dans la liste déroulante.
   Flux d’événements	Nom de votre flux d’événements. Sélectionnez un flux d’événements dans la liste déroulante.
   Streaming	Nom du flux par défaut ou dérivé. Sélectionnez un flux dans la liste déroulante. * Pour les flux par défaut, le format de nom de flux est Eventstream-stream. * Pour les flux dérivés, le nom a été défini lors de la création du flux.
   Traiter l’événement avant l’ingestion dans Eventstream	Cette option vous permet de configurer le traitement des données avant l’ingestion des données dans la table de destination. Si cette option est sélectionnée, vous poursuivez le processus d’ingestion des données dans Eventstream. Pour plus d’informations, consultez Processus des événements avant l’ingestion dans Eventstream.
   Nom de la connexion de données	Nom utilisé pour référencer et gérer votre connexion de données dans votre espace de travail. Le nom de la connexion de données est automatiquement renseigné et vous pouvez modifier le nom pour simplifier la gestion de la connexion de données dans l’espace de travail. Le nom ne peut contenir que des caractères alphanumériques, tirets et points, et comporter jusqu’à 40 caractères.

3. Sélectionnez Suivant pour continuer.

Traiter l’événement avant l’ingestion dans Eventstream

L’événement Process avant l’ingestion dans Eventstream vous permet de traiter les données avant d’être ingérées dans la table de destination. Avec cette option, le processus d’obtention des données continue en toute transparence dans Eventstream, avec les détails de la table de destination et de la source de données automatiquement renseignés.

Pour traiter l’événement avant l’ingestion dans Eventstream :

1. Sous l’onglet Configuration, sélectionnez Traiter l'événement avant l'ingestion dans Eventstream.

2. Dans la boîte de dialogue Traiter les événements dans Eventstream, sélectionnez Continuer dans eventstream.

   Important

   La sélection de Continuer dans Eventstream met fin au processus d’obtention des données dans Real-Time Intelligence et continue dans Eventstream avec les détails de la table de destination et de la source de données automatiquement renseignés.

   

3. Dans Eventstream, sélectionnez le nœud de destination base de données KQL et, dans le volet base de données KQL, vérifiez que traitement des événements avant l’ingestion est sélectionné et que les détails de destination sont corrects.

   

4. Sélectionnez Ouvrir le processeur d’événements pour configurer le traitement des données, puis sélectionnez Enregistrer. Pour plus d’informations, consultez Traiter les données d’événement avec l’éditeur de processeur d’événements.

5. De retour dans le volet base de données KQL, sélectionnez Ajouter pour terminer la configuration du nœud de destination de la base de données KQL .

6. Vérifiez que les données sont ingérées dans la table de destination.

Étape 3 : Inspecter

L’onglet Inspecter affiche un aperçu des données.

Sélectionnez Terminer pour terminer le processus d’ingestion.

capture d’écran

Facultatif :

• Utilisez la liste déroulante type de fichier pour explorer les options avancées en fonction du type de données.

• Utilisez la liste déroulante Table_mapping pour définir un nouveau mappage.

• Sélectionnez </> pour ouvrir la visionneuse de commandes pour afficher et copier les commandes automatiques générées à partir de vos entrées. Vous pouvez également ouvrir les commandes dans un ensemble de requêtes.

• Sélectionnez l’icône de crayon pour modifier les colonnes.

Modifier les colonnes

Les modifications que vous pouvez apporter dans une table dépendent des paramètres suivants :

• Si le type de la table est nouveau ou existant
• Si le type du mappage est nouveau ou existant

Mappage des transformations

Certaines correspondances de formats de données (Parquet, JSON et Avro) prennent en charge des transformations simples au moment de l'ingestion. Pour appliquer des transformations de mappage, créez ou mettez à jour une colonne dans la fenêtre Modifier les colonnes.

Les transformations de mappage peuvent être effectuées sur une colonne de type chaîne ou datetime, avec la source ayant un type de données int ou long. Pour plus d’informations, consultez la liste complète des transformations de mappage prises en charge.

Options avancées basées sur le type de données

Tabulaire (CSV, TSV et PSV) :

• Si vous ingérez des formats tabulaires dans une table existante, vous pouvez sélectionner Table_mapping>Utiliser le mappage existant. Les données tabulaires n’incluent pas toujours les noms de colonnes utilisés pour mapper les données sources aux colonnes existantes. Lorsque cette option est cochée, le mappage est effectué par ordre et le schéma de table reste le même. Si cette option n’est pas cochée, de nouvelles colonnes sont créées pour les données entrantes, quelle que soit la structure des données.

JSON :

• Sélectionnez les niveaux imbriqués pour déterminer la division de colonnes des données JSON, de 1 à 100.

Étape 4 : Résumé

Dans la fenêtre Résumé , toutes les étapes sont marquées comme terminées lorsque l’ingestion des données se termine correctement. Sélectionnez une carte pour explorer les données, supprimer les données ingérées ou créer un tableau de bord avec des métriques clés. Sélectionnez Fermer pour fermer la fenêtre.

Contenu connexe

• Pour gérer votre base de données, consultez Gérer les données.
• Pour créer, stocker et exporter des requêtes, consultez Données de requête dans un ensemble de requêtes KQL.