Introdução ao modo básico do Data Explorer

e otimizando para o uso dos clientes. O modo básico do Data Explorer foi projetado para permitir que você descubra rapidamente insights nos seus dados de eventos sem exigir conhecimento de linguagem de consulta. Essa experiência não técnica de criação de consultas permite que os usuários explorem seus dados rapidamente. Para aprender a escrever consultas mais complexas, confira o tutorial Introdução ao Data Explorer (avançado).

​

Criando consultas personalizadas

Para começar a criar suas próprias consultas no modo básico, é importante primeiro entender a estrutura dos dados que você está acessando.

​

A tabela events.all

A tabela events.all é o destino padrão de todos os eventos recebidos. É uma única tabela semiestruturada com colunas para valores comuns, como hora e nome do evento. Você logo se familiarizará com a coluna EventData, que contém o payload JSON original completo e é útil em quase todas as consultas. Você pode ler a seguinte documentação sobre a tabela events.all.

​

Consulta

Uma consulta é composta por uma ou mais Condições que são combinadas por meio do operador lógico ‘OR’. Uma condição é composta por um Evento da tabela event.all. Condições complexas podem ser criadas adicionando a uma condição uma ou mais Cláusulas, que são instruções lógicas compostas por uma Variável, um Operador e um Valor. As cláusulas são combinadas por meio do operador lógico ‘AND’. As Variáveis listadas no menu suspenso são preenchidas com base no Evento selecionado ao criar a Condição. O período da consulta pode ser ajustado modificando a Data de início e a Data de término. A saída da consulta pode ser modificada ainda mais adicionando Agrupar Por e Tipo de Agregação. Agrupar Por modifica como as linhas de saída são agrupadas, enquanto Tipo de Agregação modifica como as linhas são contadas, somadas ou distinguidas. Você pode criar consultas no painel Consulta. Observe que as consultas do Data Explorer (básico) referenciam apenas os 100 principais eventos. Para ver todos os eventos, execute a consulta no Data Explorer (avançado).

​

Saída da consulta

Depois de executar uma consulta, você pode ver a saída abaixo, no painel Saída da Consulta. A saída é apresentada no formato de um gráfico de barras e de uma tabela. O gráfico mostra os resultados dos cinco maiores grupos. Você pode ver os outros grupos clicando no menu suspenso na parte inferior do gráfico. A tabela mostra o Nome do Evento, o Carimbo de Data/Hora (UTC), a ID do Jogador e os Dados do Evento (via JSON) de cada linha.

​

Consultas de exemplo

​

Consultas com uma única condição

​

De quais regiões os jogadores estão fazendo login nesta semana?

​

De quais dispositivos os jogadores estão fazendo login nesta semana?

​

Qual é a soma dos totais de pedidos nesta semana?

​

Os limites do PlayFab estão sendo excedidos?

​

Consultas com várias condições

​

Quais jogadores e entidades estão fazendo login nesta semana?

​

Quais itens estão sendo comprados ou adicionados ao inventário nesta semana?

​

Consultas com condições complexas e cláusulas

​

Quantos itens “sword” foram comprados nesta semana?

​

Quantos itens com valor entre US$1 e US$ 5 foram comprados nesta semana?

Consultas de exemplo podem ser carregadas no Data Explorer básico selecionando “What’s This” e selecionando uma consulta de exemplo.

​

Limites

Há dois limites que regem o uso de consultas do Data Explorer:

1. Tempo máximo de execução da consulta: uma consulta individual não pode ser executada por mais de 30 segundos. Se esse limite for excedido, a consulta será encerrada e você receberá uma mensagem de erro.
2. Uso por intervalo: cada título tem permissão para um tempo total de execução cumulativo de três minutos em qualquer intervalo de 10 minutos. Se esse limite for excedido, você receberá uma mensagem de erro e precisará aguardar antes de executar consultas adicionais.

​

Retenção de dados

Por padrão, as consultas do Explorer são executadas no armazenamento dinâmico (hot storage), que pode ser configurado na ferramenta de Gerenciamento. Consultas que pesquisam além dos dados armazenados no armazenamento dinâmico terão tempos de execução significativamente mais longos e podem atingir o tempo limite.