> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Prise en main du mode avancé de Data Explorer > Apprenez à écrire des requêtes personnalisées dans le mode avancé de PlayFab Data Explorer à l'aide du langage de requête Kusto sur la table events.all pour des analyses plus approfondies. La fonctionnalité Data Explorer est en préversion publique. Nous prévoyons y apporter des changements continus à 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 analyses plus approfondies à l'aide du [langage de requête Azure Data Explorer](https://learn.microsoft.com/en-us/azure/data-explorer/write-queries), un langage semblable à SQL optimisé pour l'exploration de données ad hoc. Pour apprendre à écrire des requêtes non techniques, consultez le tutoriel [Prise en main du mode de base de Data Explorer](/fr-CA/services/playfab/data-analytics/learn-data/data-explorer/getting-started-with-data-explorer-basic). ## 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 originale complète et qui est utile dans presque toutes les requêtes. Vous pouvez lire la documentation suivante sur la [table events.all](/fr-CA/services/playfab/data-analytics/acting-data/schemas-events-all). ### L'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 votre préférence, 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 fait aucune différence pour la requête elle-même. Volet Requête Le volet Requête peut contenir plus d'une requête. 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 exécuter uniquement cette expression. Exécuter ### Création de votre première requête Créons maintenant votre première requête à partir de zéro. Vous pouvez taper le nom de la table dans le volet Requête. Mais nous allons utiliser un petit raccourci. Trouvez la table `events.all` dans le volet Ressources. 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 la table `events.all` repérée, double-cliquez sur le nom de la table. Vous remarquerez que cette expression a été ajoutée au volet Requête. En préversion, vous devrez ajouter manuellement les crochets et les guillemets simples autour du nom de la table. Une correction de cet inconvénient est en cours. ```json theme={null} ['events.all'] | ``` Notez les crochets et les guillemets simples autour du nom. Ils sont requis chaque fois que le nom de la table ou de la colonne comprend un « . ». Votre curseur est maintenant à la bonne position pour créer votre premier opérateur. Commençons par utiliser l'opérateur take. ```json theme={null} ['events.all'] | take 100 ``` Exécutez cette requête. Notez que le volet Résultats affiche maintenant 100 lignes de données brutes. Dans le volet Résultats, sélectionnez la première ligne. À l'aide de la flèche droite, déplacez-vous jusqu'à la colonne FullName\_Name. Il s'agit du nom de l'événement. Descendez avec la flèche jusqu'à ce que vous trouviez 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 maintenant en modifiant votre requête pour qu'elle retourne uniquement 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 votre requête à jour comme suit et insérez le GUID que vous avez copié : ```json theme={null} ['events.all'] | where FullName_Name == 'player_logged_in' | where Entity_Id == 'paste from clipboard here' ``` Les doubles signes d'égalité servent à évaluer l'équivalence de chaînes. Les guillemets simples au début et à la fin délimitent une chaîne. Exécutez la requête et vous verrez que le volet Résultats 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. ```json theme={null} //Player logins by platform ``` Encore une fois, double-cliquez sur la table events.all dans le volet Ressources. Cette fois, ajoutons un délimiteur temporel à notre expression pour limiter notre requête aux trois derniers jours seulement. ```json theme={null} //Player logins by platform ['events.all'] | where Timestamp > ago(30d) | where FullName_Name == 'player_logged_in' ``` 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 utiliserons l'opérateur distinct sur l'ID d'entité. ```json theme={null} ['events.all'] | where Timestamp > ago(3d) | where FullName_Name == 'player_logged_in' | distinct Entity_Id ``` Cette requête retourne la liste des ID d'entité qui se sont connectés au cours des trois derniers jours. Le volet Résultats affiche le nombre d'enregistrements, ce qui nous permet de voir le nombre total. Enregistrements Obtenons maintenant le nombre de joueurs qui se sont connectés à partir de chaque plateforme. Pour ce faire, nous aurons besoin du nombre distinct d'ID d'entité regroupés par la propriété de plateforme du JSON EventData. Cela nécessite l'opérateur `summarize`. Comme `summarize` ne prend pas en charge les types dynamiques, nous devrons également convertir la plateforme en chaîne. ```json theme={null} ['events.all'] | where Timestamp > ago(3d) | where FullName_Name == 'player_logged_in' | summarize dcount(Entity_Id) by tostring(EventData.Platform) ``` Terminons en beauté. En ajoutant une seule expression supplémentaire, nous pouvons afficher nos résultats sous forme de graphique à colonnes. ```json theme={null} ['events.all'] | where Timestamp > ago(3d) | where FullName_Name == 'player_logged_in' | summarize dcount(Entity_Id) by tostring(EventData.Platform) | render columnchart ``` Requêtes ## Exemples de requêtes Nous n'avons fait qu'effleurer la surface des types de requêtes pouvant être créées dans Explorer. D'autres exemples de requêtes peuvent être chargés à partir de la page Explorer en appuyant sur « What's This ». Chacun de ces exemples de requêtes est choisi pour illustrer certains des divers opérateurs disponibles et la façon dont ils peuvent s'appliquer à 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 qu'il s'exécute 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 pendant 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 totale cumulative de trois minutes par 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. ## Conservation 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 de gestion. Les requêtes qui cherchent au-delà des données conservées dans le stockage à chaud ont des durées d'exécution considérablement plus longues et peuvent expirer. ## Related topics - [Démarrage rapide de Data Explorer](/fr-CA/services/playfab/data-analytics/learn-data/data-explorer/quickstart.md) - [Prise en main de PlayFab Explorer](/fr-CA/services/playfab/data-analytics/acting-data/schemas-events-all.md) - [Data Explorer](/fr-CA/services/playfab/data-analytics/learn-data/data-explorer/index.md) - [Prise en main de l'interaction tactile](/fr-CA/build/core-features/common/game-streaming/game-streaming-getting-started-with-touch.md) - [Prise en main de l'empaquetage MSIXVC2 pour PC](/fr-CA/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC-msixvc2.md)