Metadados de objetos do LookML

Os usuários com a permissão develop podem acessar 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 ambiente de desenvolvimento integrado do Looker:

  1. Acesse 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, posicione o cursor sobre o objeto que tem mais contexto 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 possíveis ícones de tipo de objeto.

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

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

Metadados de 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 respectivas definições no projeto do LookML.
  • Análises: lista 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 título de cada seção também mostra o número de cada tipo de objeto.

Metadados de visualizações

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

  1. Nome e detalhes da visualização: o nome 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 possíveis ícones de tipo de objeto. O painel de metadados também fornece o nome do arquivo e o número da linha em que a visualização está definida no LookML do arquivo (e um link para a visualização no projeto).
  2. Usado no menu [number] de modelos: mostra uma lista de modelos que incluem essa visualização, em que [number] 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 básica de: Análises que usam essa visualização como base.
  5. Mesclado em: explorações a que a visualização é mesclada.

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

Metadados das 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. Consulte a página de documentação Como navegar em projetos com o painel do navegador de objetos para conferir todos os possíveis ícones de tipo de objeto. O painel de metadados também fornece o nome do arquivo e o número da linha em que a Análise está definida no LookML do arquivo (e um link para a Análise no seu projeto).
  2. Visualização básica: a visualização base da Análise, que é usada como ponto de partida para a criação dela.
  3. Visualizações mescladas: outras visualizações que são mescladas na visualização base.

Se a Análise tiver extensões ou refinamentos, essas informações também serão exibidas no painel de metadados.

Metadados de campos

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

  1. Nome e detalhes do campo: o nome do campo 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 possíveis ícones de tipo de objeto. 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 seu projeto).
  2. Usado no menu [number] 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 de extensões

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

Por exemplo, considere o exemplo de código do LookML a seguir para um arquivo 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 da 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 do aircraft_extended, o painel de metadados vai fornecer as seguintes informações sobre a Análise estendida do aircraft:

  • Visualizações mescladas: lista todas as visualizações que estão associadas à Análise aircraft.
  • Estende: lista o objeto que o Explore selecionado estende. Neste caso, é a Análise aircraft.

Nesses exemplos, os parâmetros explore estendidos e estendidos ficam lado a lado no mesmo arquivo, mas esse nem sempre é o caso. Não fica óbvio quando um parâmetro está estendido, principalmente 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 os objetos estejam definidos.

Metadados para refinamentos

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

Assim como acontece com as extensões, não é possível dizer se um objeto foi refinado apenas conferindo o LookML, principalmente porque o LookML de refinamento pode estar em um arquivo diferente. O painel de metadados permite ver se um objeto foi refinado e, em caso afirmativo, você pode navegar diretamente para o LookML para o refinamento.

Metadados de projetos importados

O painel de metadados contém 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 mostra 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.