Créer un jeu de données de référence pour votre environnement Azure Time Series Insights Gen1 à l’aide du portail Azure

Remarque

Le service Time Series Insights va être mis hors service le 7 juillet 2024. Prévoyez de migrer les environnements existants vers des solutions alternatives dès que possible. Pour plus d’informations sur la dépréciation et la migration, consultez notre documentation.

Attention

Il s’agit d’un article Gen1.

Cet article décrit comment ajouter un jeu de données de référence à votre environnement Azure Time Series Insights. Les données de référence sont utiles, joignez-les à votre source de données pour augmenter les valeurs.

Un jeu de données de référence est une collection d’éléments qui augmente les événements issus de votre source d’événements. Le moteur d’entrée Azure Time Series Insights associe chaque événement de votre source d’événements à la ligne de données correspondante dans votre jeu de données de référence. Cet événement ajouté est ensuite disponible pour la requête. Cette jointure repose sur les colonnes de clé privée définies dans votre jeu de données de référence.

Les données de référence ne sont pas jointes rétroactivement. Cela signifie que seules les données d’entrée actuelles et futures sont mises en correspondance et jointes à l’ensemble de données de référence, après configuration et téléchargement.

Vidéo

Découvrez le modèle de données de référence de Time Series Insight.

Ajouter un jeu de données de référence

1. Connectez-vous au portail Azure.

2. Recherchez votre environnement Azure Time Series Insights existant. Sélectionnez Toutes les ressources dans le menu de gauche du portail Azure. Sélectionnez votre environnement Azure Time Series Insights.

3. Sélectionnez la page Vue d’ensemble. Développez la section Éléments principaux près du haut de la page pour localiser l’URL de l’Explorateur Azure Time Series Insights et ouvrir le lien.

   

   Affichez l’Explorateur pour votre environnement Azure Time Series Insights.

4. Développez le sélecteur d’environnement dans l’Explorateur Azure Time Series Insights. Choisissez l’environnement actif. Sur la page de l’Explorateur, sélectionnez l’icône des données de référence en haut à droite.

   

5. Cliquez sur le bouton + Ajouter un jeu de données pour ajouter un nouveau jeu de données.

   

6. Sur la page Nouveau jeu de données de référence, choisissez le format des données :

   • Choisissez CSV pour des données délimitées par des virgules. La première ligne est traitée comme une ligne d’en-tête.
   • Choisissez Tableau JSON pour des données au format JSON.

   

7. Fournissez les données via l’une des deux méthodes suivantes :

   • Collez les données dans l’éditeur de texte. Ensuite, cliquez sur le bouton Analyser les données de référence.
   • Cliquez sur le bouton Choisir un fichier pour ajouter des données à partir d’un fichier texte local.

   Par exemple, collez des données CSV :

   Par exemple, collez les données d’un tableau JSON :

   En cas d’erreur lors de l’analyse des valeurs de données, l’erreur s’affiche en rouge au bas de la page : CSV parsing error, no rows extracted.

8. Une fois que les données ont été analysées correctement, une grille de données est affichée. Elle contient les colonnes et les lignes qui représentent les données. Passez en revue la grille de données pour garantir son exactitude.

   

9. Passez en revue chaque colonne pour comprendre le type de données pris par défaut et le modifier si nécessaire. Sélectionnez le symbole de type de données dans l’en-tête de colonne : # pour double (données numériques), T|F pour booléen ou Abc pour une chaîne.

   

10. Renommez les en-têtes de colonnes si nécessaire. Le nom de la colonne de clé est nécessaire pour joindre à la propriété correspondante dans votre source d’événements.

    Important

    Assurez-vous que les noms de colonne de clé de données de référence correspondent exactement au nom d’événement pour vos données entrantes, y compris la casse. Les noms des colonnes ne contenant pas de clés sont utilisés pour augmenter les données entrantes avec les valeurs de données de référence correspondantes.

11. Saisissez une valeur dans le champ Filtrer les lignes... pour passer en revue des lignes spécifiques en fonction des besoins. Ce filtre est utile pour l’examen des données, mais il n’est pas appliqué lors du chargement des données.

12. Nommez le jeu de données en renseignant le champ Nom du jeu de données au-dessus de la grille de données.

    

13. Indiquez la colonne de clé primaire du jeu de données en sélectionnant la liste déroulante au-dessus de la grille de données.

    

    (Facultatif) Sélectionnez le bouton + pour ajouter une colonne de clé secondaire, comme une clé primaire composite. Si vous devez annuler la sélection, choisissez la valeur vide de la liste déroulante pour supprimer la clé secondaire.

14. Pour télécharger les données, cliquez sur le bouton Télécharger les lignes.

    

    La page confirme la fin du téléchargement et affiche le message Jeu de données chargé.

    Avertissement

    Les colonnes ou propriétés partagées entre les jeux de données de référence affichent une erreur de chargement Nom de propriété dupliqué. L’erreur n’empêche pas la réussite du chargement des jeux de données de référence. Elle peut être supprimé en combinant les lignes partageant le nom de propriété dupliqué.

15. Sélectionnez Ajouter une ligne, Importer des lignes en bloc ou Ajouter une colonne pour ajouter plusieurs valeurs de données de référence, si nécessaire.

    

    Important

    Toute ligne qui partage une clé unique avec une autre ligne voit ses colonnes remplacées par la dernière ligne ajoutée qui partage cette clé unique.

    Remarque

    Il n’est pas nécessaire que les lignes ajoutées soient rectangulaires ; elles peuvent avoir moins de colonnes, plus de colonnes ou différentes colonnes par rapport aux autres entrées du jeu de données de référence.

Étapes suivantes

• Gérez les données de référence par programme.

• Pour obtenir des informations de référence d’API complètes, lisez le document API de données de référence.