Metadados para objetos LookML

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

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

  1. Navegue até os arquivos do projeto.
  2. Selecione o ícone Ajuda rápida para abrir o painel de ajuda rápida.
  3. No painel central, posicione o cursor sobre o objeto que você quer ver no painel de metadados.
  4. 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 Como navegar pelos projetos com o painel do navegador de objetos para ver todos os ícones de tipo de objeto possíveis.

Para objetos LookML usados em vários modelos, o painel de metadados fornece um menu suspenso para que você selecione o modelo do qual deseja ver os metadados.

As informações exibidas no painel de metadados dependem do tipo de objeto LookML selecionado e de como o objeto é usado no seu 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ê clicar em um arquivo de modelo, os metadados mostrarão os painéis "Explorar", "Views" e "LookML" incluídos no modelo e links para o local definido.

Metadados de visualizações

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

  1. O nome da visualização e um ícone que representa o tipo de objeto. Consulte a página de documentação Como navegar pelos projetos com o painel do navegador de objetos para ver todos os ícones de tipo de objeto possíveis. O painel de metadados também fornece o nome do arquivo e o número da linha onde a visualização é definida no LookML do arquivo (e um link para a visualização no seu projeto).
  2. Modelos que incluem essa visualização.
  3. A chave primária da visualização.
  4. Explorações que usam essa visualização como base.
  5. Explora a visualização em que essa visualização está unida.

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

Metadados para explorações

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

  1. O nome da ferramenta Explorar e um ícone que representa o tipo de objeto. Consulte a página de documentação Como navegar pelos projetos com o painel do navegador de objetos para ver todos os ícones de tipo de objeto possíveis. O painel de metadados também fornece o nome do arquivo e o número da linha em que a exploração é definida no LookML do arquivo (e um link para a exploração no seu projeto).
  2. Visualização de base do Explorar (a visualização usada como ponto de partida para criar a exploração).
  3. Outras visualizações que são mescladas na visualização base.

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

Metadados dos campos

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

  1. O nome do campo e um ícone que representa o tipo de objeto. Consulte a página de documentação Como navegar pelos projetos com o painel do navegador de objetos para ver todos os ícones de tipo de objeto possíveis. O painel de metadados também mostra o tipo de campo e fornece o nome do arquivo e o número da linha onde o campo está definido no LookML do arquivo (e um link para o campo em seu projeto).
  2. Modelos que incluem a visualização desse campo.
  3. Visualizações que usam esse campo.

Metadados das extensões

Quando você seleciona um parâmetro view ou explore, o painel de metadados mostra as extensões do objeto. Veja um exemplo de uma exploração que foi estendida:

O painel de metadados mostra que a exploração aérea foi estendida pela exploração aérea estendida.

Você pode selecionar o link na seção Extended by do painel de metadados para navegar diretamente para o LookML em que o objeto está estendido.

Da mesma forma, você pode usar o painel de metadados em objetos estendidos para obter informações contextuais sobre o objeto estendido. Por exemplo, a amostra de código LookML a seguir é usada na definição da exploração aircraft_extended para estender a exploração aircraft:


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

Nesse caso, o painel de metadados fornece informações sobre o objeto estendido original, como quais visualizações são unidas ao Explorar e o nome do objeto que ele estende, que é a exploração aircraft neste exemplo.

Nestes exemplos, os parâmetros explore estendidos e estendidos estão lado a lado no mesmo arquivo, mas esse nem sempre é o caso. Não é óbvio olhar um parâmetro se ele for estendido, especialmente porque os objetos estendidos e estendidos podem estar em arquivos LookML diferentes. O painel de metadados fornece contexto sobre os objetos relacionados, independentemente de onde os objetos estão definidos.

Metadados para refinamentos

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

Assim como acontece com as extensões, não é possível saber se um objeto é refinado apenas observando o LookML, especialmente porque o refinamento LookML pode estar em um arquivo diferente. O painel de metadados permite que você veja se um objeto foi refinado e navegue com facilidade até o LookML para realizar 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 de uma exploração baseada em um arquivo de visualização importado mostrará as informações do arquivo de visualização importado no painel de metadados.

A seção "Visualização base" do painel de metadados mostra informações sobre a visualização importada.

No painel de metadados, selecione o link para navegar até o arquivo importado em que o objeto está definido.

Além disso, você pode clicar em objetos em arquivos importados para ver metadados sobre os arquivos importados.