Metadados de objetos do LookML

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

Para acessar o painel de metadados no Looker IDE:

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

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 Navegar por projetos com o painel do navegador de objetos para conferir todos os ícones de tipo de objeto possíveis.

Se um objeto do LookML for usado em vários modelos, o painel de metadados vai mostrar um menu suspenso que permite selecionar o modelo para o qual você quer conferir os 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. É possível usar metadados para entender melhor muitos aspectos do projeto, conforme descrito nas seções a seguir.

Metadados para modelos

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

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

O cabeçalho de cada seção também mostra o número de cada tipo de objeto.

Metadados para 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 Navegar por projetos com o painel do navegador de objetos para conferir todos os ícones de tipo de objeto possíveis. O painel de metadados também mostra o nome do arquivo e o número da linha em que a visualização é definida no LookML do arquivo, além de um link para a visualização no projeto.
  2. Usado no menu [número] de modelos: mostra uma lista de modelos que incluem essa visualização, em que [número] representa a contagem de modelos que incluem a visualização. Por exemplo, se uma visualização for usada em dois modelos, o painel de metadados vai mostrar o texto Usado em 2 modelos.
  3. Chave primária: a chave primária da visualização.
  4. Visualização básica de: análises que usam essa visualização como base.
  5. Unido em: análises em que essa visualização é unida.

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

Metadados para análises

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 da análise: o nome da análise e um ícone que representa o tipo de objeto dela. Consulte a página de documentação Navegar por projetos com o painel do navegador de objetos para conferir todos os ícones de tipo de objeto possíveis. O painel de metadados também mostra o nome do arquivo e o número da linha em que a análise é definida no LookML do arquivo, além de um link para a análise no projeto.
  2. Visualização básica: a visualização básica da análise (a visualização usada como ponto de partida para criar a análise).
  3. Visualizações unidas: outras visualizações que são unidas à visualização básica.

Se a análise tiver extensões ou refinamentos, eles também serão mostrados no painel de metadados.

Metadados para campos

Se você selecionar um campo, o painel de metadados vai 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 Navegar por projetos com o painel do navegador de objetos para conferir todos os ícones de tipo de objeto 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 é definido no LookML do arquivo, além de um link para o campo no projeto.
  2. Usado no menu [número] de modelos: mostra 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 do LookML, a seção Estendido por do painel de metadados mostra todas as extensões desse objeto.

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

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 Estendido por para navegar diretamente até o LookML em que aircraft_extended está definido.

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

  • Visualizações unidas: lista todas as visualizações unidas à análise aircraft.
  • Estende: lista o objeto que a análise selecionada estende. Nesse caso, é a análise aircraft.

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

Metadados para refinamentos

O painel de metadados facilita a identificação de quando uma visualização ou análise tem refinamentos adicionados ao objeto. A seção Refinamentos do painel de metadados mostra o número de refinamentos adicionados ao objeto, e você pode usar os links para navegar até o LookML de cada refinamento.

Assim como com as extensões, não é possível saber se um objeto é refinado apenas analisando o LookML, especialmente porque o LookML de refinamento pode estar em um arquivo diferente. O painel de metadados permite conferir se um objeto foi refinado e, em caso afirmativo, navegar diretamente até o LookML do refinamento.

Metadados para 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 de 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 navegar até o arquivo importado em que o objeto está definido.

Além disso, é possível clicar nos objetos que estão na pasta de projetos importados no navegador de arquivos do IDE para conferir os metadados sobre os arquivos importados.