Como navegar pelos projetos com o painel do navegador de objetos

O painel do navegador de objetos no ambiente de desenvolvimento integrado do Looker permite acessar todos os objetos do seu projeto em um só lugar, além das relações hierárquicas entre eles. Essa pode ser uma alternativa útil para navegar no projeto por arquivo ou pasta.

Como visualizar objetos em um projeto

O painel do navegador de objetos mostra os modelos, análises detalhadas, visualizações e campos definidos no projeto, além da hierarquia de objetos e o tipo de cada um deles. Caso seu projeto também inclua arquivos importados, saiba mais sobre como visualizar esses objetos mais adiante nesta página.

Para usar o painel do navegador de objetos, clique no ícone do Navegador de objetos na barra de navegação do ambiente de desenvolvimento integrado.

O painel "Navegador de objetos" agrupa os objetos por tipo, que são classificados em ordem alfabética dentro de cada tipo. Usando o painel do navegador de objetos, é possível expandir ou recolher os objetos para mostrar ou ocultar as hierarquias.

Você pode recolher e expandir modelos, Análises e visualizações para revelar ou ocultar os objetos que eles contêm. Selecione a seta para a esquerda do nome de um objeto no painel do navegador de objetos para recolhê-lo ou expandi-lo. Por padrão, qualquer modelo em um projeto é aberto no painel do navegador de objetos, revelando uma lista das análises detalhadas definidas no modelo.

Como conferir o tipo de um objeto

O painel do navegador de objetos lista os seguintes tipos de objetos:

Para conferir o tipo de um objeto no projeto, passe o cursor sobre o nome dele no painel do navegador de objetos.

O painel do navegador do objeto exibe um ícone e um rótulo de texto que identificam o tipo de objeto:

  • : modelo
  • — Explorar
  • : visualização
  • : dimensão
  • : grupo de dimensões
  • — Medir
  • — Filtro
  • : parâmetro

Passe o cursor sobre o nome de um campo no painel do navegador de objetos para ver o valor do subparâmetro type do campo. No exemplo abaixo, o ícone à esquerda do objeto id indica que ele é uma dimensão, e passar o cursor sobre a dimensão id revela que ela é uma dimensão type: number:

O navegador de objetos mostra o ícone da dimensão ao lado do nome do campo de ID de amostra, e o tipo de número é indicado ao passar o cursor.

Use um dos métodos a seguir para navegar diretamente ao LookML de um objeto no painel do navegador de objetos:

Clicar no nome do objeto

Para navegar até o LookML de um objeto, siga estas etapas:

  1. No painel do navegador do objeto, clique no nome do objeto.
  2. O ambiente de desenvolvimento integrado abre o arquivo em que o objeto é definido e posiciona o cursor na primeira linha da declaração do objeto.

Pesquisar o objeto

Para pesquisar um objeto ou arquivo, siga estas etapas:

  1. No painel do navegador de objetos, clique no ícone Acessar o objeto ou arquivo .

    Como alternativa, use o atalho de teclado Command + J (Mac) ou Ctrl + J (Windows).

  2. Digite o termo de pesquisa. O Looker mostra uma lista de objetos e arquivos que correspondem ao termo de pesquisa.

Situações especiais

Visualização de 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 do objeto para conferir 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 o modelo, inclua essa visualização 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 expandir para mostrar as visualizações e os campos que ela contém.

Quando você seleciona um objeto em 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.

Como visualizar objetos estendidos no painel do navegador de objetos

Se o projeto incluir uma visualização ou uma Análise que estenda outra visualização ou Análise, use o painel do navegador de objetos para acessar e navegar até o LookML do objeto que está sendo estendido. Quando você expande uma visualização que estende outra, o painel do navegador do objeto mostra os campos da visualização básica junto com aqueles que você adicionou à visualização estendida.

Por exemplo, o arquivo de visualização abaixo define uma visualização com o nome 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 de base e os novos campos definidos na visualização user_with_age_extension.

Você pode acessar o LookML do objeto estendido, selecionando seu nome no painel do navegador do objeto.

Como visualizar objetos refinados no painel do navegador de objetos

Você pode usar o painel do navegador de objetos para conferir o conteúdo de uma visualização refinada ou Análise, ou para acessar o LookML para os refinamentos em seu projeto.

O painel do navegador de objetos lista refinamentos e as Análises ou visualizações criadas como objetos únicos, em vez de exibir refinamentos e seus objetos de base separadamente. Se você usar refinamentos para adicionar campos a uma visualização ou mesclar visualizações a uma Análise, os campos ou visualizações adicionados serão exibidos com o conteúdo da visualização original.

Quando você clica no nome de uma visualização refinada ou em uma 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 uma Análise detalhada for refinada várias vezes, o ambiente de desenvolvimento integrado vai navegar até o último refinamento do objeto incluindo a ordem.

Como exemplo, suponha que você queira adicionar uma nova dimensão, country, à visualização com o nome user_with_age_extension sem modificar o LookML original da 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 com os campos originais da visualização.

Ao adicionar refinamentos ao seu projeto, preste atenção à ordem em que eles são aplicados. Os refinamentos são aplicados linha por linha em 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 saber em que ordem os refinamentos são aplicados.