> ## 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.

# Commandes de gestion d'Insights

> Référence des commandes Kusto de gestion et de contrôle des données de PlayFab Insights pour inspecter les requêtes, modifier la rétention, créer des tables personnalisées et ingérer ou purger des données.

Les commandes de gestion d'Insights permettent aux utilisateurs d'exercer un plus grand contrôle sur leur système de données ou d'obtenir de l'information supplémentaire à son sujet. Les commandes se divisent en deux catégories principales :

1. 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
2. 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

<Note>
  PlayFab Insights Management sera mis hors service le 31/03/2026. Nous recommandons d'utiliser les [connexions de données](/fr-CA/services/playfab/data-analytics/export-data/data-connection-adx) 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](https://developer.microsoft.com/en-us/games/articles/2025/11/playfab-insights-management-getplayerinsegment-apis-retired-starting-march-31/).
</Note>

Certaines commandes ne sont pas disponibles en mode d'évaluation.

| Catégorie | Commandes |
| - | - |
| Gestion | .show queries<br />.show running queries<br />.show commands-and-queries<br />.show table policy retention<br />.alter table policy retention |
| Contrôle des données | .create table<br />.drop table<br />.set<br />.append<br />.set-or-append<br />.set-or-replace<br />.ingest into table<br />.purge table |

## 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.


## Related topics

- [Pratiques exemplaires d'Insights](/fr-CA/services/playfab/data-analytics/legacy/insights/best-practices.md)
- [Performances et rétention](/fr-CA/services/playfab/data-analytics/legacy/insights/performance-retention.md)
- [Insights](/fr-CA/services/playfab/data-analytics/legacy/insights/overview.md)
- [Tarification d'Insights](/fr-CA/services/playfab/data-analytics/legacy/insights/pricing.md)
- [Connexion de Grafana à Insights](/fr-CA/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)