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

# Comandos de gerenciamento do Insights

> Referência para os comandos Kusto de gerenciamento e controle de dados do PlayFab Insights para inspecionar consultas, alterar a retenção, criar tabelas personalizadas e ingerir ou limpar dados.

Os comandos de gerenciamento do Insights permitem que os usuários tenham mais controle sobre seu sistema de dados ou coletem informações adicionais sobre ele. Os comandos se enquadram em duas categorias principais:

1. Gerenciamento - Esses comandos permitem que os usuários vejam mais informações sobre consultas, comandos e retenção, além de alterar a retenção
2. Controle de dados - Esses comandos permitem que os usuários criem e descartem tabelas personalizadas, ingiram dados locais e da nuvem e limpem dados do banco de dados

<Note>
  O PlayFab Insights Management será desativado em 31/03/2026. Recomendamos usar [Data Connections](/pt-BR/services/playfab/data-analytics/export-data/data-connection-adx) para gerenciar seu desempenho e custo daqui em diante. Se o seu título ainda usa o **Insights**, continue consultando este artigo para obter detalhes sobre práticas recomendadas. Para obter mais informações, consulte o [Blog sobre a desativação do Insights](https://developer.microsoft.com/en-us/games/articles/2025/11/playfab-insights-management-getplayerinsegment-apis-retired-starting-march-31/).
</Note>

Alguns comandos não estão disponíveis no modo de avaliação.

| Categoria | Comandos |
| - | - |
| Gerenciamento | .show queries<br />.show running queries<br />.show commands-and-queries<br />.show table policy retention<br />.alter table policy retention |
| Controle de dados | .create table<br />.drop table<br />.set<br />.append<br />.set-or-append<br />.set-or-replace<br />.ingest into table<br />.purge table |

## Gerenciamento

**.show queries**
Retorna uma lista das consultas em execução no momento pelo usuário, por outro usuário ou por todos os usuários.
Uso: `.show  queries`
Exemplo: `.show queries | where StartedOn > ago(1d)`
Esse comando mostra todas as consultas executadas no último dia
**.show running queries**
Mostra todas as consultas em execução no momento
Uso: `.show running queries`
Exemplo: `.show running queries`
Esse comando mostra todas as consultas em execução no momento.
**.show database policy caching**
Mostra a política de cache atual do banco de dados
Uso: `.show database DatabaseName policy caching`
Exemplo: `.show database myDatabase policy caching`
Esse comando mostra a política de cache atual do banco de dados especificado.
**.show table policy caching**
Mostra a política de cache atual da tabela
Uso: `.show database DatabaseName.TableName policy caching`
Exemplo: `.show database myDatabase.myTable policy caching`
Esse comando mostra a política de cache atual da tabela especificada.
**.show commands-and-queries**
Retorna uma tabela com comandos de administração e consultas que atingiram um estado final. Esses comandos e consultas ficam disponíveis para consulta por 30 dias.
Uso: `.show commands-and-queries`
Exemplo: `.show commands-and-queries | where StartedOn > ago(1d) | where State != "Completed"`
Esse comando mostra todos os comandos e consultas que falharam no último dia
**.show table policy retention**
Mostra a política de retenção efetiva das tabelas, levando em conta as regras do cluster e do banco de dados
Uso: `.show table(s) (<table_name> [, ...]) policy retention`
Exemplo: `.show table ['events.all'] policy retention`
Esse comando mostra a política de retenção atual da tabela "events.all".

**.alter table policy retention** (restrito a contas no modelo de preços por consumo)
Altera a política de retenção atual de uma ou mais tabelas para \<retention\_policy>
Uso: `.alter tables (<table_name> [, ...]) policy retention <retention_policy>`
Exemplo: `.alter table ['events.all'] policy retention softdelete = 90d`
Esse comando define que os dados da tabela "events.all" sejam removidos da tabela após 90 dias.

## Controle de dados

**.create table** (restrito ao nível de desempenho 2 e superiores)
Cria uma nova tabela vazia. O comando deve ser executado no contexto de um banco de dados específico. Se a tabela já existir, o comando retornará sucesso.
Uso: `.create table TableName ([columnName:columnType], ...)`
Exemplo: `.create table ['custom.logs'] (Level:string, Timestamp:datetime, Id:string, Message:string)`
Esse comando cria uma nova tabela chamada "custom.logs" com quatro colunas. **IMPORTANTE: os nomes de tabelas personalizadas devem começar com "custom.".**

**.drop table** (restrito ao nível de desempenho 2 e superiores)
Descarta a tabela especificada. Observação: essa ação não pode ser desfeita.
Uso: `.drop table TableName [ifexists]`
Exemplo: `.drop table ['custom.logs']`
Esse comando descarta a tabela chamada "custom.logs".

**.set** (restrito ao nível de desempenho 2 e superiores)
Cria uma tabela com os resultados de QueryOrCommand
Uso: `.set  TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand`
Exemplo: `.set [‘custom.recentEvents’] <| [‘events.all’] | where Timestamp > now() – time(1h)`
Esse comando cria uma tabela "custom.recentEvents" contendo os resultados da consulta acima

**.append** (restrito ao nível de desempenho 2 e superiores)
Acrescenta a uma tabela existente os resultados de QueryOrCommand
Uso: `.append  TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand`
Exemplo: `.append [‘custom.recentEvents’] <| [‘events.all’] | where Timestamp > now() – time(1h)`
Esse comando acrescenta à tabela existente "custom.recentEvents" os resultados da consulta acima

**.set-or-append** (restrito ao nível de desempenho 2 e superiores)
Cria uma tabela ou acrescenta a ela os resultados de QueryOrCommand
Uso: `.set-or-append  TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand`
Exemplo: `.set-or-append [‘custom.weekEvents’] <| [‘events.all’] | where Timestamp > now() – time(7d)`
Esse comando acrescenta os dados da consulta acima à tabela "custom.weekEvents". Se a tabela não existir, ela será criada.

**.set-or-replace** (restrito ao nível de desempenho 2 e superiores)
Substitui os dados da tabela, se ela existir (descartando os fragmentos de dados existentes), ou cria a tabela de destino, se ela ainda não existir. O esquema da tabela é preservado, a menos que uma das propriedades de ingestão extend\_schema ou recreate\_schema esteja definida como true. Se o esquema for modificado, a modificação ocorrerá antes da ingestão real dos dados, em sua própria transação; portanto, uma falha na ingestão dos dados não significa que o esquema não foi modificado.
Uso: `.set-or-replace  TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand`
Exemplo: `.set-or-replace [‘custom.dayEvents’] <| [‘events.all’] | where Timestamp > now() – time(1d)`
Esse comando substitui os dados da tabela "custom.dayEvents" pelos da consulta acima.

**.ingest into** (restrito ao nível de desempenho 2 e superiores)
Ingere dados em uma tabela "extraindo" os dados de um ou mais artefatos de armazenamento em nuvem.
Uso: `.ingest  into table TableName SourceDataLocator [with ( IngestionPropertyName = IngestionPropertyValue [, ...] )]`
Exemplo: `.ingest into table [‘custom.myData’] (h’<your url here>’) with(ignoreFirstRecord=true)`
Esse comando envia dados para a tabela "custom.myData" a partir do armazenamento em nuvem indicado na URL.

**.purge table** (restrito ao nível de desempenho 2 e superiores)
Exclui permanentemente os dados da tabela do banco de dados
Uso: `.purge table [TableName] in database [DatabaseName] allrecords with (noregrets='true')`
Exemplo: `.purge table [‘custom.toPurge’] in database MyDatabase allrecords`
Esse comando limpa todos os dados da tabela "custom.toPurge", excluindo-os permanentemente do seu sistema de dados.


## Related topics

- [Práticas recomendadas do Insights](/pt-BR/services/playfab/data-analytics/legacy/insights/best-practices.md)
- [Desempenho e retenção](/pt-BR/services/playfab/data-analytics/legacy/insights/performance-retention.md)
- [Insights](/pt-BR/services/playfab/data-analytics/legacy/insights/overview.md)
- [Criar um aplicativo do Microsoft Entra ID para o PlayFab Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/creating-AAD-app-for-insights.md)
- [Comando serve](/pt-BR/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md)