- Gestion - Ces commandes permettent aux utilisateurs d’afficher davantage d’informations 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 cloud, et de purger des données de leur base de données
La gestion de PlayFab Insights sera mise hors service le 31/03/2026. Nous vous recommandons d’utiliser les Data Connections pour gérer vos performances et vos coûts à l’avenir. Si votre titre utilise toujours Insights, continuez à consulter cet article pour obtenir des détails sur les bonnes pratiques. Pour plus d’informations, consultez le blog sur la mise hors service d’Insights.
Gestion
.show queries Renvoie 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
Renvoie une table contenant les commandes d’administration et les requêtes ayant 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 ayant é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 utilisant le modèle de tarification à la consommation)
Remplace la stratégie de rétention actuelle d’une ou plusieurs tables par <retention_policy>
Utilisation : .alter tables (<table_name> [, ...]) policy retention <retention_policy>
Exemple : .alter table ['events.all'] policy retention softdelete = 90d
Cette commande configure la suppression des données de la table « events.all » au bout de 90 jours.
Contrôle des données
.create table (réservée au niveau de performances 2 et supérieur) Crée une nouvelle table vide. La commande doit s’exécuter dans le contexte d’une base de données spécifique. Si la table existe déjà, la commande renvoie 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 » avec quatre colonnes. IMPORTANT : les tables personnalisées doivent commencer par « custom. ».
.drop table (réservée au niveau de performances 2 et supérieur)
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 performances 2 et supérieur)
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 performances 2 et supérieur)
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 performances 2 et supérieur)
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 performances 2 et supérieur)
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 encore. 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 d’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 la requête ci-dessus.
.ingest into (réservée au niveau de performances 2 et supérieur)
Ingère des données dans une table en « tirant » les données d’un ou plusieurs artefacts de stockage cloud.
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 cloud indiqué dans l’URL.
.purge table (réservée au niveau de performances 2 et supérieur)
Supprime définitivement les données de la 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 », en les supprimant définitivement de votre système de données.