O painel do navegador de objetos no ambiente de desenvolvimento integrado do Looker permite ver todos os objetos do seu projeto em um só lugar, junto com as relações hierárquicas entre esses objetos. 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 explorações, as visualizações e os campos que foram definidos em seu projeto, junto com a hierarquia de objetos e o tipo de cada objeto. Caso seu projeto também inclua arquivos importados, veja mais detalhes sobre como visualizar esses objetos abaixo.
Para usar o painel do navegador de objetos, selecione o ícone do Navegador de objetos, que está abaixo do ícone de pasta 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. Com o painel do navegador de objetos, é possível mostrar ou ocultar as hierarquias de objetos expandindo ou recolhendo objetos.
Você pode recolher e expandir modelos, explorações e visualizações para revelar ou ocultar os objetos que elas contêm. Selecione a seta à esquerda do nome de um objeto no painel do navegador de objetos para recolher ou expandir o objeto. Qualquer modelo em um projeto é expandido por padrão no painel do navegador de objetos, revelando uma lista de explorações definidas no modelo.
Como visualizar o tipo de um objeto
O painel do navegador de objetos lista os seguintes tipos de objeto:
Para visualizar o tipo de um objeto no projeto, passe o cursor sobre o nome desse objeto no painel do navegador de objetos.
O ícone à esquerda do nome de cada objeto também identifica o tipo de objeto:
— Modelo
— Explorar
— Ver
— Dimensão
: grupo de dimensões
: medida
: filtro
: parâmetro
Passar o cursor sobre o nome de um campo no painel do navegador de objetos revela o valor do subparâmetro type do campo. No exemplo abaixo, o ícone à esquerda do objeto id indica que se trata de uma dimensão, e passar o cursor sobre a dimensão id revela que é uma dimensão type: number:
Como navegar até o LookML de um objeto
No IDE do Looker, é possível fazer uma pesquisa rápida para navegar diretamente para objetos LookML e arquivos de projeto usando o recurso Ir para objeto ou arquivo. Clique no ícone Ir para objeto ou arquivo no navegador de objetos ou use o atalho de teclado Command-J (Mac) ou Ctrl+J (Windows):
Consulte a página de documentação Como acessar arquivos de projetos do LookML para saber mais.
Você também pode navegar até um objeto selecionando o nome do objeto no painel do navegador de objetos. Quando você seleciona um objeto, o IDE exibe o arquivo no qual o objeto está definido e posiciona o cursor na primeira linha da declaração do objeto.
Por exemplo, selecionar uma exploração chamada events abre o arquivo de modelo em que essa exploração é definida no ambiente de desenvolvimento integrado e posiciona o cursor na parte superior da declaração explore para events. O painel do navegador de objetos mostra a definição events da exploração, incluindo a visualização users.
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 seu 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 ao seu modelo, inclua essa visualização e crie uma exploração product_facts:
include: "//e_redlook/views/product_facts.view"
explore: product_facts {}
Depois disso, você poderá ver o product_facts no painel do navegador de objetos e expandir esse recurso para mostrar as visualizações e os campos que ele contém.
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 por ser um arquivo de projeto importado.
Como visualizar objetos estendidos no painel do navegador de objetos
Se o projeto incluir uma visualização ou uma exploração que estenda outra visualização ou exploração, você poderá usar o painel do navegador de objetos para ver e navegar até o LookML do objeto em extensão. Quando você expande uma visualização que estende outra, o painel do navegador de objetos mostra os campos da visualização base e os campos adicionados na visualização estendida.
Por exemplo, o arquivo de visualização abaixo 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 básica e os novos campos definidos na visualização user_with_age_extension.
Você pode acessar o LookML para o objeto de extensão selecionando seu nome no painel do navegador de objetos.
Como visualizar objetos refinados no painel do navegador de objetos
Use o painel do navegador de objetos para ver o conteúdo de uma visualização refinada ou de exploração ou navegue até o LookML para ver os refinamentos no projeto.
O painel do navegador de objetos lista os refinamentos e os Explorars ou as visualizações que eles criam como objetos únicos, em vez de exibir refinamentos e seus objetos base separadamente. Se você usar refinamentos para adicionar campos a uma visualização ou unir visualizações a uma exploração, os campos ou as visualizações que você adicionar serão exibidos com o conteúdo da visualização original.
Quando você seleciona o nome de uma visualização refinada ou de exploração no painel do navegador de objetos, o IDE abre a linha no LookML em que o refinamento é definido. Se uma visualização ou uma exploração tiver sido refinada várias vezes, o ambiente de desenvolvimento integrado navegará para o último refinamento do 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 a visualização. 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 junto com os campos originais da visualização.
Ao adicionar refinamentos ao seu projeto, observe a ordem em que eles são aplicados. Os refinamentos são aplicados linha por linha, desce em um único arquivo e pela ordem em que seus arquivos são incluídos, caso um objeto seja refinado várias vezes em vários arquivos. Consulte a página de documentação Refinamentos do LookML para ver informações sobre a ordem em que os refinamentos são aplicados.