Pular para o conteúdo principal

Painéis · Ideia-chave

Pergunte aos seus registros com uma consulta

Escreva uma pergunta em poucas palavras, como quilos entregues por comprador neste trimestre, e veja a resposta em um gráfico e uma tabela.

Cada relatório de Análises → Relatórios é uma consulta. Para buscar, salvar, compartilhar ou adicionar relatórios a um painel, veja Biblioteca de relatórios; este artigo explica a consulta em si.

Em Relatórios você faz uma pergunta aos seus próprios registros em uma linguagem curta e simples. Uma consulta diz de onde vêm os dados, o que mostrar e como agrupar:

FROM deliveries
SHOW sum(quantity) IN kg AS delivered
BY recipient
DURING this_quarter
COMPARE TO previous_period

Lê-se assim: das entregas, mostre os quilos entregues a cada comprador neste trimestre, comparados com o trimestre anterior. Sacas e toneladas são convertidas para quilos automaticamente.

Como uma consulta é montada

  • FROM indica um conjunto de dados: lotes, entregas, certificados, locais, trabalho de campo e mais.
  • SHOW diz o que mostrar: totais como count(), sum(quantity) ou avg(moisture), ou campos para obter uma lista de registros.
  • BY agrupa os totais: por um campo (um comprador, um produto) ou por day, week, month, quarter ou year.
  • WHERE mantém só alguns registros: status = "active", product IN ("Café arábica"), NOT HAS certificate.
  • SINCE, DURING e COMPARE TO definem o período e com o que ele é comparado.
  • VISUALIZE escolhe o cartão: bar, line, donut, histogram, table e outros. Na página de um relatório, veja Escolher como é desenhado.

Pressione Ctrl+Espaço para ver sugestões e Ctrl+Enter para executar. Os nomes que você digita, como um comprador, são procurados no seu diretório. Se algo não estiver certo, a consulta diz o quê e como corrigir.

Monte, salve e coloque em um painel

A aba Construtor escreve a mesma consulta com menus: o que mostrar, como agrupar, quais registros e o período. Cada mudança aparece no texto da consulta, e cada mudança no texto aparece no construtor. Salvar guarda a consulta para você, ou para toda a empresa se você administra painéis; ao salvar de novo, as versões anteriores ficam guardadas. Adicionar a um painel coloca a consulta em um dos seus painéis como um cartão que acompanha a consulta salva e usa o período do painel quando a consulta não tem um. Cada pessoa que abre o cartão vê o que o seu próprio papel permite.

Resultados florestais dos seus talhões

O conjunto de dados sites também tem o resultado florestal de cada talhão, o mesmo que o bloco Floresta mostra na aba Origem de um lote. Locais que não são talhões, como armazéns, não têm resultado.

  • forest_result: no_loss (nenhuma perda de floresta detectada após 31 dez 2020), review (perda de floresta detectada: revisar) ou not_enough_data (dados insuficientes).
  • loss_in_forest_ha: os hectares de perda de cobertura arbórea após 2020 em área que era floresta em 2020.
  • forest_computed_at: quando o resultado foi calculado.
  • reviewed: se alguém registrou uma revisão do resultado.
  • review_current: se a última revisão foi feita sobre os números que o talhão tem agora.

Por exemplo, para contar os talhões por resultado:

FROM sites
SHOW count()
BY forest_result

O resultado descreve os dados. A conclusão da due diligence é da empresa.

De onde vêm os números

Cada número vem dos registros da sua empresa, lidos com as permissões do seu papel. As linhas que estão no livro de registro indicam isso; registros do diretório e de revisão dizem "Registros da plataforma". Uma consulta só lê: nunca altera um registro. Quem não vê dados pessoais pelo seu papel também não pode filtrar nem agrupar por eles.