consulta

Esta página se refere ao parâmetro query, que faz parte de uma análise detalhada.

query também pode ser usado como parte de uma tabela agregada, conforme descrito na página de documentação do parâmetro aggregate_table.

Uso

explore: explore_name {
  query: query_name {
    dimensions: [dimension1, dimension2, ... ]
    measures: [measure1, measure2, ... ]
    label: "Display Name in Field Picker"
    description: "Information about this query"
    pivots: [dimension1, dimension2, ... ]
    sorts: [field1: asc, field2: desc, ... ]
    filters: [field1: "value1", field2: "value2", ... ]
    limit: 100
  }
  ...
}
Hierarquia
explore
query
Valor padrão
Nenhum

Aceita
O nome da consulta e os subparâmetros para definir a consulta

Definição

Use o parâmetro query para criar análises modeladas para uma análise detalhada. As análises estimadas são listadas na seção Início rápido de uma análise detalhada em branco ou no pop-up "Início rápido" depois que uma análise detalhada já foi executada. Consulte a seção Exemplo nesta página para saber como funciona.

As análises modeladas são úteis para usuários iniciantes do Looker, já que é possível especificar elementos como dimensões, medidas, filtros e tabelas dinâmicas que podem ser mais relevantes e úteis.

Definir uma consulta em LookML

Em vez de criar a LookML da consulta do zero, você pode usar uma Análise para criar a LookML básica da consulta. Para mais detalhes, consulte a próxima seção, Como extrair a LookML de consulta de uma análise detalhada.

O parâmetro query tem os seguintes subparâmetros:

Nome do parâmetro Descrição Exemplo
label Opcionalmente, adiciona um rótulo ao query. O rótulo é o que aparece no seletor de campos do recurso Detalhar para a consulta. label: "Weekly Sales Totals"
description Opcional: adicione uma descrição sobre essa consulta para informar os usuários. Na seção "Explorar", todas as consultas com uma descrição têm um ícone de informações. O texto da descrição é exibido quando um usuário passa o cursor sobre o ícone de informações. description: "Total value of all sales per day"
dimensions Uma lista separada por vírgulas das dimensões da análise detalhada que serão incluídas na sua consulta. O campo dimensions usa esta sintaxe:

dimensions: [dimension1, dimension2, ...] 		dimensions:

  [orders.created_month, orders.country]
measures Uma lista separada por vírgulas das métricas da análise detalhada que serão incluídas na sua consulta. O campo measures usa esta sintaxe:

measures: [measure1, measure2, ...] 		measures:

  [orders.count]
filters Opcionalmente, adiciona filtros a um query. Os filtros são adicionados à cláusula WHERE do SQL que gera a consulta.

O campo filters usa esta sintaxe:

filters: [field_name_1: "value1", field_name_2: "value2", ...] 		filters: [orders.country: "United States", orders.state: "California"]
limit Especifica o limite de linhas da consulta (opcional). limit: 10
sorts Especifica opcionalmente os campos e a direção de classificação (crescente ou decrescente) para o query.

O campo sorts usa esta sintaxe:

sorts: [field1: asc|desc, field2: asc|desc, ...] 		sorts: [order_items.total_sales: asc]
pivots Se quiser, faça a rotação dos resultados nas dimensões especificadas da consulta. O campo pivots usa esta sintaxe:

pivots: [dimension1, dimension2, ...]

NOTE: os campos especificados no parâmetro pivots também precisam ser especificados no parâmetro dimensions da consulta. 		pivots: [created_quarter]
timezone Não compatível: o parâmetro timezone não é compatível com o parâmetro query, que é um subparâmetro de explore. Um query em explore usa o mesmo fuso horário de explore.

Como extrair o LookML de consulta de uma Análise

Como um atalho, os desenvolvedores do Looker podem usar a funcionalidade usada para gerar o LookML aggregate_table em uma Análise de dados e copiar a consulta da tabela agregada do LookML para usar como ponto de partida para o LookML de análise modelada.

Ao copiar a LookML de uma tabela de agregação, você também copia alguns parâmetros que não quer para a LookML de consulta modelada. Especificamente, depois de copiar a LookML da tabela agregada, exclua os parâmetros aggregate_table e materialization, já que eles se aplicam apenas a tabelas agregadas. Consulte a página de documentação do parâmetro aggregate_table para mais informações sobre eles.

Além disso, o parâmetro query da tabela agregada só é compatível com um subconjunto dos parâmetros aceitos pelas consultas do recurso Detalhar modeladas. Isso significa que, depois de copiar a LookML da tabela agregada query, você pode usar outros parâmetros na consulta modelada. Consulte a seção Definir uma consulta em LookML nesta página para conferir uma lista completa dos parâmetros compatíveis com consultas modeladas.

Para usar uma Análise e ter uma base para sua consulta modelada em LookML:

  1. No seu Explore, selecione todos os campos e filtros que você quer incluir na consulta modelada.
  2. Selecione Executar para receber os resultados.

  3. Selecione Acessar o LookML no menu de ações da análise detalhada. Essa opção está disponível apenas para desenvolvedores do Looker.

  4. Selecione a guia Tabela de agregação.

  5. O Looker fornece o LookML para um refinamento de análise detalhada para uma tabela de agregação. Podemos usar a LookML query da tabela agregada e modificar isso para uma consulta de Análise modelada. Copie o LookML e cole no arquivo de modelo associado, indicado no comentário antes do refinamento do recurso "Explorar". Se a Análise for definida em um arquivo separado, e não em um arquivo de modelo, adicione o refinamento ao arquivo da Análise em vez do arquivo de modelo.

    Aqui, você pode modificar a LookML da tabela agregada para usar em uma consulta modelada:

  6. Mantenha apenas o parâmetro query e os subparâmetros dele. Exclua os parâmetros aggregate_table e materialization, já que eles se aplicam apenas a tabelas de agregação.

  7. Adicione um nome para a consulta. Como mostrado na seção Exemplo desta página, a sintaxe é:

    query: query_name

  8. Se quiser, preencha outros parâmetros para a consulta modelada. Consulte a seção Definir uma consulta em LookML nesta página para conferir uma lista completa de parâmetros compatíveis com consultas modeladas.

Exemplo

Este exemplo cria uma consulta modelada order_count_by_month para a análise detalhada order_items:


explore: +order_items {
  query: order_count_by_month {
     description: "Number of orders placed by month in 2019"
     dimensions: [orders.created_month]
      measures: [orders.count]
     filters: [orders.created_date: "2019"]
    }
  }

Os usuários podem executar a análise de início rápido na seção Início rápido da análise detalhada Itens do pedido.