O painel do navegador de objetos no ambiente de desenvolvimento integrado do Looker permite conferir todos os objetos do projeto em um só lugar, além das relações hierárquicas entre eles. Essa pode ser uma alternativa útil para navegar pelo projeto por arquivo ou pasta.
Como visualizar os objetos em um projeto
O painel do navegador de objetos mostra os modelos, as Análises, as visualizações e os campos que foram definidos no projeto, além da hierarquia e do tipo de cada um. Se o projeto também incluir arquivos importados, leia mais detalhes sobre como visualizar esses objetos mais adiante nesta página.
Para usar o painel do navegador de objetos, clique no ícone Navegador de objetos na barra de navegação do ambiente de desenvolvimento integrado.
O painel do navegador de objetos agrupa os objetos por tipo, e os objetos são classificados em ordem alfabética dentro de cada tipo. Usando o painel do navegador de objetos, você pode expandir ou recolher os objetos para exibir ou ocultar as hierarquias de objetos.
É possível recolher e expandir modelos, Análises e visualizações para revelar ou ocultar os objetos que eles contêm. Selecione a seta à esquerda do nome de um objeto no painel do navegador de objetos para recolhê-lo ou expandi-lo. Qualquer modelo em um projeto é expandido por padrão no painel do navegador de objetos, revelando uma lista das Análises definidas no modelo.
Como visualizar o tipo de um objeto
O painel do navegador de objetos lista os seguintes tipos de objetos:
Para ver o tipo de um objeto no projeto, passe o cursor sobre o nome dele no painel do navegador de objetos.
O painel do navegador de objetos exibe um ícone e um rótulo de texto que identificam o tipo de objeto:
- — Modelo
- — Explorar
- : visualização
- : dimensão
- : grupo de dimensão
- : medida
- : filtro
- : parâmetro
Passe o cursor sobre o nome de um campo no painel do navegador de objetos para revelar o valor do subparâmetro type. No exemplo a seguir, o ícone à esquerda do objeto id indica que se trata de uma dimensão. Ao passar o cursor sobre a dimensão id, você descobre que ela é type: number:
Como navegar para o LookML de um objeto
É possível usar um dos seguintes métodos para navegar diretamente para o LookML de um objeto no painel do navegador de objetos:
Clicando no nome do objeto
Para navegar até o LookML de um objeto, siga estas etapas:
- No painel do navegador de objetos, clique no nome do objeto.
- O ambiente de desenvolvimento integrado abre o arquivo em que o objeto está definido e posiciona o cursor na primeira linha da declaração do objeto.
Como pesquisar o objeto
Para pesquisar um objeto ou arquivo, siga estas etapas:
No painel do navegador de objetos, clique no ícone Ir para o objeto ou arquivo .
Você também pode usar o atalho de teclado Command + J (Mac) ou Ctrl + J (Windows).
Digite o termo de pesquisa. O Looker mostra uma lista de objetos e arquivos que correspondem ao seu termo de pesquisa.
Situações especiais
Como visualizar objetos importados no painel do navegador de objetos
Quando você importa arquivos de outro projeto e inclui esses arquivos importados no projeto ativo, também é possível usar o painel do navegador de objetos para ver os objetos importados.
Por exemplo, suponha que você tenha usado o parâmetro local_dependency no arquivo de manifesto do projeto para importar um projeto local chamado e_redlook, que contém uma visualização chamada product_facts:
# Your project
project_name: "e_thelook"
# The project to import
local_dependency: {
project: "e_redlook"
}
Para disponibilizar a visualização product_facts para seu modelo, inclua-a e crie uma Análise product_facts:
include: "//e_redlook/views/product_facts.view"
explore: product_facts {}
Em seguida, você pode conferir a Análise product_facts no painel do navegador de objetos e expandi-la para mostrar as visualizações e os campos contidos nela.
Quando você seleciona um objeto de um projeto importado, o Looker abre o arquivo em que o objeto está definido. O arquivo será somente leitura porque é um arquivo de projeto importado.
Exibir objetos estendidos no painel do navegador de objetos
Se o projeto incluir uma visualização ou um Explore que extends outra visualização ou Explore, você poderá usar o painel do navegador de objetos para visualizar e navegar até o LookML do objeto estendido. Quando você expande uma visualização que estende outra, o painel do navegador de objetos mostra os campos da visualização base junto com todos os campos adicionados na visualização estendida.
Por exemplo, o arquivo de visualização a seguir define uma visualização chamada user_with_age_extension que estende outra visualização chamada users_extended e adiciona novos campos:
include: "/views/users_extended.view"
view: user_with_age_extension {
extends: [users_extended]
dimension: age {
type: number
sql: ${TABLE}.age ;;
}
dimension: zip {
type: zipcode
sql: ${TABLE}.zip ;;
}
}
O painel do navegador de objetos agora mostra os campos definidos na visualização users_extended base e os novos campos definidos na visualização user_with_age_extension.
É possível navegar até o LookML do objeto de extensão selecionando o nome dele no painel do navegador de objetos.
Visualização de objetos refinados no painel do navegador de objetos
É possível usar o painel do navegador de objetos para exibir o conteúdo de uma visualização refinada ou do Explore ou acessar o LookML e ver os refinamentos do seu projeto.
O painel do navegador de objetos lista os refinamentos e as Análises ou visualizações baseadas como objetos únicos, em vez de mostrar os refinamentos e os objetos base deles separadamente. Se você usar refinamentos para adicionar campos a uma visualização ou mesclar visualizações a um Explore, os campos ou visualizações adicionados serão mostrados junto com o conteúdo da visualização original.
Quando você clica no nome de uma visualização ou Análise refinada no painel do navegador de objetos, o ambiente de desenvolvimento integrado é aberto na linha do LookML em que o refinamento está definido. Se uma visualização ou um Explore tiver sido refinado várias vezes, o ambiente de desenvolvimento integrado navegará para o último refinamento desse objeto por ordem de inclusão.
Por exemplo, suponha que você queira adicionar uma nova dimensão, country, à visualização chamada user_with_age_extension sem modificar o LookML original. Para refinar a visualização user_with_age_extension, use o parâmetro view e adicione um sinal de adição (+) na frente do nome da visualização:
view: +user_with_age_extension {
dimension: country {
type: string
map_layer_name: countries
sql: ${TABLE}.country ;;
}
}
Quando você expande a visualização user_with_age_extension no painel do navegador de objetos, o campo country agora é exibido com os campos originais da visualização.
Ao adicionar refinamentos ao projeto, considere a ordem em que eles são aplicados. Os refinamentos são aplicados linha por linha de baixo em um único arquivo, e pela ordem em que seus arquivos são incluídos, se um objeto for refinado várias vezes em vários arquivos. Consulte a página de documentação Refinamentos do LookML para informações sobre a ordem em que os refinamentos são aplicados.