Passer au contenu principal
La fonctionnalité Data Explorer est en préversion publique. Nous prévoyons des modifications continues à mesure que nous recueillons des commentaires
et que nous l’optimisons pour l’utilisation par les clients. Le mode avancé de Data Explorer est conçu pour des requêtes plus complexes et des informations plus approfondies à l’aide du langage de requête Azure Data Explorer, un langage de type SQL optimisé pour l’exploration ad hoc des données. Pour apprendre à écrire des requêtes non techniques, consultez le tutoriel Prise en main du mode de base de Data Explorer.

​
Création de requêtes personnalisées

Pour commencer à créer vos propres requêtes en mode avancé, il est important de comprendre d’abord la forme des données auxquelles vous accédez.

​
La table events.all

La table events.all est la destination par défaut de tous les événements entrants. Il s’agit d’une table unique semi-structurée avec des colonnes pour les valeurs courantes, comme l’heure et le nom de l’événement. Vous vous familiariserez rapidement avec la colonne EventData, qui contient la charge utile JSON d’origine complète et qui est utile dans presque toutes les requêtes. Vous pouvez lire la documentation suivante sur la table events.all.

​
Anatomie d’une requête

Une expression de requête commence le plus souvent par le nom de la table. Celui-ci est suivi du délimiteur barre verticale (|). Viennent ensuite un ou plusieurs opérateurs. Chaque opérateur est séparé par le délimiteur barre verticale. Expression Selon vos préférences, une requête peut être exprimée sur une seule ligne ou avec un retour à la ligne avant chaque délimiteur barre verticale. Cela ne change rien à la requête elle-même. Volet de requête Le volet Query peut contenir plusieurs requêtes. Il est ainsi facile de commencer par une expression simple, de vérifier qu’elle s’exécute, puis de la développer. Une ligne vide sépare une requête d’une autre. La position de votre curseur détermine quelle requête s’exécute lorsque vous appuyez sur le bouton « Run ». Vous pouvez également mettre en surbrillance une partie de la requête pour n’exécuter que cette expression. Exécuter

​
Création de votre première requête

Créons maintenant votre première requête de toutes pièces. Vous pouvez taper le nom de la table dans le volet Query. Mais nous allons utiliser un petit raccourci. Recherchez la table events.all dans le volet Resources. Vous devrez peut-être développer la base de données de votre ID de titre en cliquant sur la flèche. Table events.all Une fois que vous avez trouvé la table events.all, double-cliquez sur son nom. Vous remarquerez que cette expression a été ajoutée au volet Query.
En préversion, vous devrez ajouter manuellement les crochets et les guillemets simples autour du nom de la table. Un correctif pour cet inconvénient est en cours.
Notez les crochets et les guillemets simples autour du nom. Ils sont obligatoires chaque fois que le nom de la table ou de la colonne contient un « . ». Votre curseur est maintenant à la bonne position pour créer votre premier opérateur. Commençons par utiliser l’opérateur take.
Exécutez cette requête. Notez que le volet Results affiche maintenant 100 lignes de données brutes. Dans le volet Results, sélectionnez la première ligne. À l’aide de la flèche droite, accédez à la colonne FullName_Name. Il s’agit du nom de l’événement. Descendez avec la flèche jusqu’à trouver un événement player_logged_in. Une fois que vous en avez trouvé un, déplacez-vous avec la flèche droite jusqu’à la colonne EventData et double-cliquez. Vous devriez maintenant voir ceci : Colonne EventData Votre requête peut référencer n’importe quelle propriété du JSON EventData à l’aide de la notation pointée (.). Vous pouvez l’essayer dès maintenant en modifiant votre requête pour ne renvoyer que les événements player_logged_in d’un seul joueur. Double-cliquez sur le GUID EntityID et copiez-le dans le Presse-papiers. Mettez maintenant à jour votre requête comme suit et insérez le GUID que vous avez copié :
Le double signe égal est utilisé pour évaluer l’égalité de chaînes. Les guillemets simples au début et à la fin délimitent une chaîne.
Exécutez la requête : le volet Results affiche les événements player_logged_in uniquement pour le joueur sélectionné. Vous pouvez utiliser la notation pointée pour référencer plusieurs niveaux imbriqués de la hiérarchie JSON en ajoutant simplement un point entre chaque niveau. Créons maintenant une deuxième requête pour regrouper les connexions des joueurs par région. Sans supprimer ce que vous avez écrit, appuyez deux fois sur Entrée. Ajoutons un commentaire à notre prochaine requête à l’aide de « // ». Les commentaires ne sont pas exécutés et sont utiles pour garder une trace de l’intention derrière chaque requête.
Une fois encore, double-cliquez sur la table events.all dans le volet Resources. Cette fois, ajoutons un délimiteur temporel à notre expression pour limiter notre requête aux trois derniers jours.
Exécutez cette requête pour obtenir la liste complète de tous les événements de connexion des trois derniers jours. Cependant, nous voulons savoir combien de joueurs distincts se sont connectés, et non le nombre d’événements. Pour ce faire, nous allons utiliser l’opérateur distinct sur l’ID d’entité.
Cette requête renvoie la liste des ID d’entité qui se sont connectés au cours des trois derniers jours. Le volet Results affiche le nombre d’enregistrements, ce qui nous permet de voir le total. Enregistrements Obtenons maintenant le nombre de joueurs qui se sont connectés depuis chaque plateforme. Pour ce faire, nous avons besoin du nombre distinct d’ID d’entité regroupés par la propriété platform du JSON EventData. Cela nécessite l’opérateur summarize. Comme summarize ne prend pas en charge les types dynamiques, nous devons également convertir platform en chaîne.
Terminons en beauté. En ajoutant une seule expression supplémentaire, nous pouvons afficher nos résultats sous forme d’histogramme.
Requêtes

​
Exemples de requêtes

Nous n’avons fait qu’effleurer la surface des types de requêtes qui peuvent être créées dans Explorer. D’autres exemples de requêtes peuvent être chargés depuis la page Explorer en appuyant sur « What’s This ». Chacun de ces exemples de requêtes est choisi pour illustrer certains des différents opérateurs disponibles et la manière dont ils peuvent être appliqués à des questions concrètes.
Comme la forme de vos données peut différer de celle de notre jeu de données de démonstration, vous devrez peut-être modifier l’exemple de requête pour l’exécuter dans votre scénario.

​
Limites

Deux limites régissent l’utilisation des requêtes dans Explorer :
  1. Durée d’exécution maximale d’une requête : une requête individuelle ne peut pas s’exécuter plus de 30 secondes. Si cette limite est dépassée, la requête est arrêtée et vous recevez un message d’erreur.
  2. Utilisation par intervalle : chaque titre dispose d’une durée d’exécution cumulée totale de trois minutes sur tout intervalle de 10 minutes. Si cette limite est dépassée, vous recevez un message d’erreur et devez attendre avant d’exécuter d’autres requêtes.

​
Rétention des données

Par défaut, les requêtes Data Explorer s’exécutent sur le stockage à chaud, qui peut être configuré dans l’outil Management. Les requêtes qui portent sur des données au-delà de celles stockées dans le stockage à chaud ont des durées d’exécution nettement plus longues et peuvent expirer.
Dernière modification le 6 octobre 2026

Sujets connexes

Démarrage rapide de Data ExplorerPrise en main du mode de base de Data ExplorerPrise en main de PlayFab ExplorerData ExplorerPrise en main de l'entrée tactile