- 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
- 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
O PlayFab Insights Management será desativado em 31/03/2026. Recomendamos usar Data Connections 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.
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.