explore

Esta página se refere ao parâmetro explore, que faz parte de um modelo.

explore também pode ser usado como parte de um filtro do painel, descrito na página de documentação Parâmetros do painel.

explore também pode ser usado como parte de um elemento do painel. Um exemplo representativo do uso está disponível na página de documentação Parâmetros de gráfico de colunas para painéis do LookML.

Uso

explore: explore_name { . . . }
Hierarquia
explore
Valor padrão
Nenhum

Aceita
O nome de uma visualização existente ou um nome para o explore ao usar from

Regras especiais
Os nomes de explore precisam ser exclusivos em um determinado modelo

Definição

Se houver um sinal de mais (+) na frente do nome da Análise, como explore: +orders, isso é um refinamento de uma Análise. Consulte a página de documentação Refinamentos da LookML para mais informações.

explore adiciona uma visualização ao menu de Análises do Looker, conforme descrito na página de documentação Termos e conceitos do LookML. Como prática recomendada, uma Análise deve ser definida em um arquivo de modelo.

As análises detalhadas geralmente recebem o nome de uma visualização existente. No entanto, se você quiser ter várias análises detalhadas com base na mesma visualização, adicione um parâmetro from à análise. Nesse caso, a análise detalhada pode receber qualquer nome válido, que inclui apenas letras minúsculas (a-z), dígitos (0-9) e sublinhados.

explore tem um papel importante no SQL gerado pelo Looker. Suponha que um usuário escolha Clientes no menu "Explorar" e execute uma consulta. Esta Análise customers é baseada na visualização chamada customers, que está associada a uma tabela de banco de dados. Essa tabela é colocada na cláusula FROM da consulta SQL do usuário.

explore pode ter muitos parâmetros secundários que afetam o comportamento de exibição e filtragem e especificam a adição de junções para a análise detalhada. Se uma análise detalhada incluir uma ou mais junções, elas poderão ter parâmetros de junção que especificam o comportamento de junção preferido.

Exemplos

Adicione uma opção ao menu "Analisar" com base na visualização chamada users:

explore: users {
  # additional explore parameters go here
}

Adicione uma opção ao menu "Analisar" chamada Eventos com base na visualização user_events:

explore: events {
  from: user_events
}

Desafios comuns

explore precisa fazer referência a um nome de visualização existente

Não é possível usar o parâmetro explore para definir a tabela de banco de dados, as dimensões, as métricas e outros campos que fazem parte de uma visualização. Em vez disso, primeiro defina uma visualização usando o parâmetro view. Em seguida, você pode fazer referência ao nome dessa visualização em explore.

explore precisa fazer referência ao nome da visualização, não ao nome do arquivo

Normalmente, o nome de uma visualização é o mesmo do arquivo em que ela está definida. Isso não é obrigatório. O nome e o nome do arquivo da visualização podem ser diferentes.

Por exemplo, você tem uma visualização chamada users definida em um arquivo chamado company_users. O arquivo de visualização company_users tem esta aparência:

view: users { ... }

Em seguida, adicione a visualização users ao menu "Analisar" com:

explore: users { ... }

Embora a visualização users esteja dentro de um arquivo chamado company_users, o nome do arquivo não importa. Apenas o nome da visualização no parâmetro view é importante.

Quando você usa uma métrica de type: count em uma análise detalhada, a visualização rotula os valores resultantes com o nome da visualização em vez da palavra "Contagem". Para evitar confusão, recomendamos usar o plural no nome da visualização, selecionar Mostrar nome completo do campo em Série nas configurações de visualização ou usar um view_label com uma versão no plural do nome da visualização.

Informações importantes

explore geralmente é usado com outros parâmetros

É possível usar explore sozinho, sem parâmetros adicionais. Na prática, explore geralmente é usado com outras opções. Por exemplo, é muito comum join outras visualizações em uma Análise.

Todos os parâmetros adicionais associados a explore são mostrados na página Parâmetros de análise detalhada. Os parâmetros que podem ser usados para uma join em uma Análise são mostrados na página Parâmetros de junção.