Prise en main du mode de base de Data Explorer

et que nous l’optimisons pour l’utilisation par les clients. Le mode de base de Data Explorer est conçu pour vous permettre de découvrir rapidement des informations dans vos données d’événements sans nécessiter de connaissances en langage de requête. Cette expérience de création de requêtes non technique permet aux utilisateurs d’explorer rapidement leurs données. Pour apprendre à écrire des requêtes plus complexes, consultez le tutoriel Prise en main de Data Explorer (avancé).

​

Création de requêtes personnalisées

Pour commencer à créer vos propres requêtes en mode de base, 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.

​

Requête

Une requête est composée d’une ou plusieurs conditions combinées via l’opérateur logique « OR ». Une condition est composée d’un événement de la table event.all. Des conditions complexes peuvent être créées en ajoutant à une condition une ou plusieurs clauses, c’est-à-dire des instructions logiques composées d’une variable, d’un opérateur et d’une valeur. Les clauses sont combinées via l’opérateur logique « AND ». Les variables répertoriées dans la liste déroulante sont renseignées en fonction de l’événement sélectionné lors de la création de la condition. La période de la requête peut être ajustée en modifiant Start date et End date. La sortie de la requête peut être modifiée davantage en ajoutant Group By et Aggregate Type. Group By modifie la manière dont les lignes de sortie sont regroupées, tandis qu’Aggregate Type modifie la manière dont les lignes sont comptées, additionnées ou dédoublonnées. Vous pouvez créer des requêtes dans le panneau Query. Notez que les requêtes Data Explorer (de base) ne référencent que les 100 premiers événements. Pour afficher tous les événements, exécutez la requête dans Data Explorer (avancé).

​

Sortie de la requête

Après avoir exécuté une requête, vous pouvez voir la sortie ci-dessous dans le panneau Query Output. La sortie se présente sous la forme d’un graphique à barres ainsi que d’un tableau. Le graphique affiche les résultats des cinq groupes les plus importants. Vous pouvez voir les autres groupes en cliquant sur la liste déroulante en bas du graphique. Le tableau affiche le nom de l’événement, l’horodatage (UTC), l’ID du joueur et les données de l’événement (au format JSON) pour chaque ligne.

​

Exemples de requêtes

​

Requêtes à condition unique

​

Depuis quelles régions les joueurs se connectent-ils cette semaine ?

​

Depuis quels appareils les joueurs se connectent-ils cette semaine ?

​

Quelle est la somme des totaux de commande cette semaine ?

​

Les limites PlayFab sont-elles dépassées ?

​

Requêtes à conditions multiples

​

Quels joueurs et quelles entités se connectent cette semaine ?

​

Quels objets sont achetés ou ajoutés à l’inventaire cette semaine ?

​

Requêtes à conditions complexes avec clauses

​

Combien d’objets « sword » ont été achetés cette semaine ?

​

Combien d’objets d’une valeur comprise entre 1 $et 5$ ont été achetés cette semaine ?

Des exemples de requêtes peuvent être chargés dans Data Explorer (de base) en sélectionnant « What’s This », puis un exemple de requête.

​

Limites

Deux limites régissent l’utilisation des requêtes dans Data 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 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 auront des durées d’exécution nettement plus longues et peuvent expirer.