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 de Parâmetros do painel.
explore
também pode ser usado como parte de um elemento do painel. Um exemplo representativo de uso é mostrado na página de documentação Parâmetros do gráfico de colunas para painéis LookML.
Uso
Hierarquia
explore |
Valor padrão
NenhumaAceita
O nome de uma visualização já 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 adição (
+
) na frente do nome do recurso, comoexplore: +orders
, isso é um refinamento dele. Consulte a página de documentação Refinamentos de LookML para mais informações.
explore
adiciona uma visualização atual ao menu "Explorar" do Looker, conforme descrito na página de documentação sobre termos e conceitos do LookML. Como prática recomendada, um Explore deve ser definido dentro de um arquivo de modelo.
Em geral, as explorações têm o nome de uma visualização. No entanto, se você quiser ter várias explorações com base na mesma visualização, adicione um parâmetro from
a elas. Nesse caso, a guia Explorar pode receber qualquer nome válido, que inclua apenas letras minúsculas (a-z), dígitos (0-9) e sublinhados.
explore
desempenha um papel importante no SQL gerado pelo Looker. Suponha que um usuário escolha Clientes no menu "Explorar" e execute uma consulta. Esta exploração customers
é baseada na visualização chamada customers
, que é associada a uma tabela de banco de dados. Essa tabela é colocada na cláusula FROM
da consulta SQL do usuário.
A explore
pode ter vários parâmetros filhos que afetam o comportamento de exibição e filtro e especificam a adição de mesclagens em "Explorar". Se uma exploração inclui uma ou mais mesclagens, essas junções podem ter parâmetros de mesclagem que especificam o comportamento desejado.
Examples
Adicione uma opção ao menu "Explorar" com base na visualização chamada users
:
explore: users {
# additional explore parameters go here
}
Adicione uma opção ao menu "Explorar" com o nome Eventos com base na visualização chamada user_events
:
explore: events {
from: user_events
}
Desafios comuns
explore
precisa referenciar um nome de visualização existente
Não é possível definir a tabela, as dimensões, as medidas e outros campos de banco de dados que fazem parte de uma visualização usando um parâmetro explore
. Em vez disso, primeiro é necessário definir uma visualização usando o parâmetro view
. Em seguida, você pode referenciar o nome dessa visualização na 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 de visualização em que a visualização é definida. Isso não é necessário. O nome e o nome do arquivo da visualização podem ser diferentes.
Por exemplo, você tem uma visualização chamada users
definida dentro de 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 "Explorar" com:
explore: users { ... }
Embora a visualização users
esteja dentro de um arquivo chamado company_users
, o nome do arquivo não importa. Somente o nome da visualização no parâmetro view
é importante.
Quando você usa uma medida de
type: count
em um recurso "Explorar", a visualização rotula os valores resultantes com o nome da visualização em vez da palavra "Contagem". Para evitar confusão, recomendamos que você pluralize o nome da visualização, selecionando Mostrar nome de campo completo em Séries nas configurações de visualização ou usando umview_label
com uma versão pluralizada do nome de visualização.
Informações úteis
explore
normalmente é usado com parâmetros adicionais
É possível usar o explore
sozinho, sem parâmetros adicionais. Na prática, o explore
geralmente é usado com mais opções. Por exemplo, é muito comum join
visualizações adicionais em uma guia "Explorar".
Todos os parâmetros adicionais associados a explore
podem ser encontrados aqui. Os parâmetros que podem ser usados para uma join
em uma exploração são encontrados aqui.