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

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

Les commandes de gestion Insights permettent aux utilisateurs d'exercer davantage de contrôle sur leur système de données ou de recueillir des informations supplémentaires à son sujet. Les commandes se répartissent en deux catégories principales :

1. 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
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 cloud, et de purger des données de leur base de données

<Note>
  La gestion de PlayFab Insights sera mise hors service le 31/03/2026. Nous vous recommandons d'utiliser les [Data Connections](/fr/services/playfab/data-analytics/export-data/data-connection-adx) 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](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 é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**
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.


## Related topics

- [Performances et rétention](/fr/services/playfab/data-analytics/legacy/insights/performance-retention.md)
- [Insights](/fr/services/playfab/data-analytics/legacy/insights/overview.md)
- [Bonnes pratiques Insights](/fr/services/playfab/data-analytics/legacy/insights/best-practices.md)
- [Exportation Insights](/fr/services/playfab/data-analytics/legacy/insights/export.md)
- [Connexion de Grafana à Insights](/fr/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)