- Gestion - Ces commandes permettent aux utilisateurs d’afficher plus d’information sur les requêtes, les commandes et la rétention, et de modifier la rétention
- Contrôle des données - Ces commandes permettent aux utilisateurs de créer et de supprimer des tables personnalisées, d’ingérer des données locales et infonuagiques, et de purger des données de leur base de données
PlayFab Insights Management sera mis hors service le 31/03/2026. Nous recommandons d’utiliser les connexions de données pour gérer vos performances et vos coûts à l’avenir. Si votre titre utilise encore Insights, continuez à consulter cet article pour obtenir des détails sur les pratiques exemplaires. Pour plus d’information, consultez le blogue sur la mise hors service d’Insights.
Gestion
.show queries Retourne la liste des requêtes en cours d’exécution par l’utilisateur, par un autre utilisateur ou par tous les utilisateurs. Utilisation :.show queries
Exemple : .show queries | where StartedOn > ago(1d)
Cette commande affiche toutes les requêtes exécutées au cours de la dernière journée
.show running queries
Affiche toutes les requêtes en cours d’exécution
Utilisation : .show running queries
Exemple : .show running queries
Cette commande affiche toutes les requêtes en cours d’exécution.
.show database policy caching
Affiche la stratégie de mise en cache actuelle de la base de données
Utilisation : .show database DatabaseName policy caching
Exemple : .show database myDatabase policy caching
Cette commande affiche la stratégie de mise en cache actuelle de la base de données spécifiée.
.show table policy caching
Affiche la stratégie de mise en cache actuelle de la table
Utilisation : .show database DatabaseName.TableName policy caching
Exemple : .show database myDatabase.myTable policy caching
Cette commande affiche la stratégie de mise en cache actuelle de la table spécifiée.
.show commands-and-queries
Retourne une table contenant les commandes d’administration et les requêtes qui ont atteint un état final. Ces commandes et requêtes peuvent être interrogées pendant 30 jours.
Utilisation : .show commands-and-queries
Exemple : .show commands-and-queries | where StartedOn > ago(1d) | where State != "Completed"
Cette commande affiche toutes les commandes et requêtes qui ont échoué au cours de la dernière journée
.show table policy retention
Affiche la stratégie de rétention effective des tables en tenant compte des règles du cluster et de la base de données
Utilisation : .show table(s) (<table_name> [, ...]) policy retention
Exemple : .show table ['events.all'] policy retention
Cette commande affiche la stratégie de rétention actuelle de la table « events.all ».
.alter table policy retention (réservée aux comptes avec le modèle de tarification à la consommation)
Modifie la stratégie de rétention actuelle d’une ou de plusieurs tables en <retention_policy>
Utilisation : .alter tables (<table_name> [, ...]) policy retention <retention_policy>
Exemple : .alter table ['events.all'] policy retention softdelete = 90d
Cette commande fait en sorte que les données de la table « events.all » soient retirées de la table après 90 jours.
Contrôle des données
.create table (réservée au niveau de performance 2 et plus) Crée une nouvelle table vide. La commande doit s’exécuter dans le contexte d’une base de données précise. Si la table existe déjà, la commande retourne un succès. Utilisation :.create table TableName ([columnName:columnType], ...)
Exemple : .create table ['custom.logs'] (Level:string, Timestamp:datetime, Id:string, Message:string)
Cette commande crée une nouvelle table appelée « custom.logs » comportant quatre colonnes. IMPORTANT : le nom des tables personnalisées doit commencer par « custom. ».
.drop table (réservée au niveau de performance 2 et plus)
Supprime la table spécifiée. Remarque : cette action est irréversible.
Utilisation : .drop table TableName [ifexists]
Exemple : .drop table ['custom.logs']
Cette commande supprime la table nommée « custom.logs ».
.set (réservée au niveau de performance 2 et plus)
Crée une table avec les résultats de QueryOrCommand
Utilisation : .set TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
Exemple : .set [‘custom.recentEvents’] <| [‘events.all’] | where Timestamp > now() – time(1h)
Cette commande crée une table « custom.recentEvents » contenant les résultats de la requête ci-dessus
.append (réservée au niveau de performance 2 et plus)
Ajoute les résultats de QueryOrCommand à une table existante
Utilisation : .append TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
Exemple : .append [‘custom.recentEvents’] <| [‘events.all’] | where Timestamp > now() – time(1h)
Cette commande ajoute les résultats de la requête ci-dessus à la table existante « custom.recentEvents »
.set-or-append (réservée au niveau de performance 2 et plus)
Crée une table ou y ajoute les résultats de QueryOrCommand
Utilisation : .set-or-append TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
Exemple : .set-or-append [‘custom.weekEvents’] <| [‘events.all’] | where Timestamp > now() – time(7d)
Cette commande ajoute les données de la requête ci-dessus à la table « custom.weekEvents ». Si la table n’existe pas, elle est créée.
.set-or-replace (réservée au niveau de performance 2 et plus)
Remplace les données de la table si elle existe (supprime les partitions de données existantes), ou crée la table cible si elle n’existe pas déjà. Le schéma de la table est conservé, sauf si l’une des propriétés d’ingestion extend_schema ou recreate_schema est définie sur true. Si le schéma est modifié, la modification a lieu avant l’ingestion réelle des données, dans sa propre transaction; un échec de l’ingestion des données ne signifie donc pas que le schéma n’a pas été modifié.
Utilisation : .set-or-replace TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
Exemple : .set-or-replace [‘custom.dayEvents’] <| [‘events.all’] | where Timestamp > now() – time(1d)
Cette commande remplace les données de la table « custom.dayEvents » par celles de la requête ci-dessus.
.ingest into (réservée au niveau de performance 2 et plus)
Ingère des données dans une table en « tirant » les données d’un ou de plusieurs artefacts de stockage infonuagique.
Utilisation : .ingest into table TableName SourceDataLocator [with ( IngestionPropertyName = IngestionPropertyValue [, ...] )]
Exemple : .ingest into table [‘custom.myData’] (h’<your url here>’) with(ignoreFirstRecord=true)
Cette commande envoie des données dans la table « custom.myData » à partir du stockage infonuagique indiqué dans l’URL.
.purge table (réservée au niveau de performance 2 et plus)
Supprime définitivement les données d’une table de la base de données
Utilisation : .purge table [TableName] in database [DatabaseName] allrecords with (noregrets='true')
Exemple : .purge table [‘custom.toPurge’] in database MyDatabase allrecords
Cette commande purge toutes les données de la table « custom.toPurge », les supprimant définitivement de votre système de données.