explorar

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

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

Aceita
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, como explore: +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 um view_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.