Metadados de objetos LookML

Os usuários com a permissão develop podem ver informações contextualmente relevantes sobre os objetos no painel de metadados do ambiente de desenvolvimento integrado do Looker.

Para conferir o painel de metadados no ambiente de desenvolvimento integrado do Looker:

  1. Navegue até os arquivos do projeto.
  2. Para abrir o painel de Ajuda rápida, selecione o ícone de Ajuda rápida .
  3. No editor de código LookML, coloque o cursor sobre o objeto que você quer contextualizar no painel de metadados.
  4. No painel de Ajuda rápida, selecione a guia Metadados para abrir o painel.

O painel de metadados identifica o objeto com um nome e um ícone que representa o tipo de objeto. Consulte a página de documentação Como navegar em projetos com o painel do navegador de objetos para ver todos os ícones de tipos de objetos possíveis.

Se um objeto LookML for usado em vários modelos, o painel de metadados vai fornecer um menu suspenso que permite selecionar o modelo em que você quer ver metadados.

As informações exibidas no painel de metadados dependem do tipo de objeto do LookML selecionado e de como o objeto selecionado é usado no projeto. Você pode usar metadados para entender melhor muitos aspectos do seu projeto, conforme descrito nas seções a seguir.

Metadados para modelos

Se você selecionar um arquivo de modelo, o painel de metadados exibirá as seguintes seções:

  • Dashboards: lista todos os dashboards do LookML incluídos no modelo, com links para as definições no projeto do LookML.
  • Explores: lista as Análises incluídas no modelo, com links para as definições no projeto do LookML
  • Views: lista todas as visualizações incluídas no modelo, com links para as definições no projeto do LookML.

O título de cada seção também exibe o número de cada tipo de objeto.

Metadados das visualizações

Se você selecionar um parâmetro de visualização, o painel de metadados vai mostrar as seguintes informações sobre como a visualização é usada no projeto:

  1. Nome e detalhes da visualização: o nome da visualização e um ícone que representa o tipo de objeto da visualização. Consulte a página de documentação Como navegar em projetos com o painel do navegador de objetos para ver todos os ícones de tipos de objetos possíveis. O painel de metadados também fornece o nome do arquivo e o número da linha em que a visualização é definida no LookML do arquivo (e um link para a visualização no projeto).
  2. Usado no menu [número] modelos: mostra uma lista de modelos que incluem essa visualização, em que [número] representa o número de modelos que incluem a visualização. Por exemplo, se uma visualização for usada em dois modelos, o painel de metadados exibirá o texto Usado em dois modelos.
  3. Chave primária: a chave primária da visualização.
  4. Visualização base de: explorações que usam essa visualização como base.
  5. Participante: explora a que essa visualização está mesclada.

Se a visualização tiver extensões ou refinamentos, eles também serão exibidos no painel de metadados.

Metadados para Explores

Se você selecionar um parâmetro explore, o painel de metadados vai mostrar as seguintes informações sobre como a Análise é usada no projeto:

  1. Nome e detalhes do Explore: o nome da Análise e um ícone que representa o tipo de objeto. Consulte a página de documentação Como navegar em projetos com o painel do navegador de objetos para ver todos os ícones de tipos de objetos possíveis. O painel de metadados também fornece o nome do arquivo e o número da linha em que a Análise é definida no LookML do arquivo (e um link para a Análise no projeto).
  2. Visualização base: a visualização base da Análise (usada como ponto de partida para a criação dela).
  3. Visualizações agrupadas: outras visualizações que são mescladas à visualização básica.

Se a Análise tiver extensões ou refinamentos, eles também vão aparecer no painel de metadados.

Metadados para campos

Se você selecionar um campo, o painel de metadados mostrará as seguintes informações sobre como o campo é usado no projeto:

  1. Nome e detalhes do campo: o nome do campo e um ícone que representa o tipo de objeto dele. Consulte a página de documentação Como navegar em projetos com o painel do navegador de objetos para ver todos os ícones de tipos de objetos possíveis. O painel de metadados também mostra o tipo do campo e fornece o nome do arquivo e o número da linha em que o campo está definido no LookML do arquivo (e um link para o campo no projeto).
  2. Usado no menu [número] modelos: exibe uma lista de modelos que incluem a visualização desse campo.
  3. Existe na visualização: visualizações que usam esse campo.

Metadados para extensões

Quando você seleciona um parâmetro view ou explore no editor de código LookML, a seção Extended by do painel de metadados mostra as extensões desse objeto.

Por exemplo, considere o exemplo de código LookML a seguir para um arquivo de modelo em que a Análise aircraft_extended estende a Análise aircraft:

explore: aircraft {
  view_name: aircraft
  join: aircraft_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_type_id} = ${aircraft_types.aircraft_type_id} ;;
    relationship: many_to_one
  }

  join: aircraft_engine_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_engine_type_id} = ${aircraft_engine_types.aircraft_engine_type_id} ;;
    relationship: many_to_one
  }
}

explore: aircraft_extended {
  extends: [aircraft]
  label: "Aircraft Extended"
}

Se você selecionar a definição do LookML para a Análise aircraft, o painel de metadados vai listar aircraft_extended na seção Estendido por. Clique no link na seção Extended by para navegar diretamente para o LookML em que aircraft_extended está definido.

Se você clicar na definição da Análise aircraft_extended, o painel de metadados vai fornecer as seguintes informações sobre a Análise aircraft estendida:

  • Visualizações agrupadas: lista todas as visualizações que fazem parte do Explore aircraft.
  • Extends: lista o objeto que o Explore selecionado estende. Nesse caso, é a Análise aircraft.

Nesses exemplos, os parâmetros explore estendidos e estendidos estão lado a lado no mesmo arquivo, mas isso nem sempre é assim. Não é óbvio procurar um parâmetro se ele estiver estendido, especialmente porque os objetos estendidos e estendidos podem estar em arquivos LookML diferentes. O painel de metadados oferece contexto sobre os objetos relacionados, independentemente de onde eles estão definidos.

Metadados para refinamentos

Com o painel de metadados, é fácil ver quando uma visualização ou uma Análise tem refinamentos adicionados ao objeto. A seção Refinamentos do painel de metadados mostra o número de refinamentos que foram adicionados ao objeto. É possível usar os links para navegar até o LookML de cada refinamento.

Assim como com as extensões, não é possível dizer se um objeto é refinado apenas olhando para o LookML, especialmente porque o LookML de refinamento pode estar em um arquivo diferente. O painel de metadados permite ver se um objeto foi refinado e, se tiver sido, permite navegar diretamente para o LookML para o refinamento.

Metadados de projetos importados

O painel de metadados inclui informações sobre objetos de projetos importados, incluindo links para navegar até o arquivo importado em que o objeto está definido. Por exemplo, selecionar o LookML para uma Análise baseada em um arquivo de visualização importado vai mostrar as informações do arquivo de visualização importado no painel de metadados.

No painel de metadados, clique no link para acessar o arquivo importado em que o objeto está definido.

Além disso, você pode clicar nos objetos que estão na pasta de projetos importados no navegador de arquivos do ambiente de desenvolvimento integrado para ver os metadados sobre os arquivos importados.