Metadados para objetos LookML

Os utilizadores com autorização develop podem ver informações contextualmente relevantes sobre os objetos no painel de metadados do IDE do Looker.

Para ver o painel de metadados no IDE do Looker:

  1. Navegue para os ficheiros do projeto.
  2. Para abrir o painel de Ajuda rápida, selecione o ícone Ajuda rápida .
  3. No editor de código LookML, coloque o cursor no objeto sobre o qual quer mais contexto no painel de metadados.
  4. No painel de Ajuda rápida, selecione o separador 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 nos projetos com o painel do explorador de objetos para ver todos os ícones de tipo de objeto possíveis).

Se um objeto LookML for usado em vários modelos, o painel de metadados apresenta um menu pendente que lhe permite selecionar o modelo para o qual quer ver os metadados.

As informações apresentadas no painel de metadados dependem do tipo de objeto LookML que selecionou, bem como da forma como o objeto selecionado é usado no seu projeto. Pode usar os metadados para compreender melhor muitos aspetos do seu projeto, conforme descrito nas secções seguintes.

Metadados para modelos

Se selecionar um ficheiro de modelo, o painel de metadados apresenta as seguintes secções:

  • Painéis de controlo: apresenta todos os painéis de controlo do LookML incluídos no modelo, com links para as respetivas definições no seu projeto do LookML
  • Explores: apresenta uma lista de todos os Explores incluídos no modelo, com links para as respetivas definições no seu projeto do LookML
  • Visualizações: apresenta todas as visualizações incluídas no modelo, com links para as respetivas definições no seu projeto do LookML

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

Metadados para visualizações

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

  1. Ver nome e detalhes: o nome da visualização de propriedade e um ícone que representa o tipo de objeto da visualização de propriedade (consulte a página de documentação Navegar nos projetos com o painel do explorador de objetos para ver todos os ícones de tipo de objeto possíveis). O painel de metadados também indica o nome do ficheiro e o número da linha onde a vista está definida no LookML do ficheiro (e um link para a vista no seu projeto).
  2. Usado no menu [number] modelos: apresenta uma lista de modelos que incluem esta visualização de propriedade, onde [number] representa a quantidade de modelos que incluem a visualização de propriedade. Por exemplo, se uma vista for usada em dois modelos, o painel de metadados apresenta o texto Usado em 2 modelos.
  3. Chave principal: a chave principal da vista.
  4. Vista de base de: explorações que usam esta vista como vista de base.
  5. Unido em: explora em que vista esta vista está unida.

Se a vista tiver extensões ou refinamentos, estes também são apresentados no painel de metadados.

Metadados para explorações

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

  1. Nome e detalhes do Explorar: o nome do Explorar e um ícone que representa o respetivo tipo de objeto (consulte a página de documentação Navegar nos 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 indica o nome do ficheiro e o número da linha onde a exploração está definida no LookML do ficheiro (e um link para a exploração no seu projeto).
  2. Vista de base: a vista de base para a exploração (a vista que é usada como ponto de partida para criar a exploração).
  3. Vistas unidas: outras vistas que são unidas à vista base.

Se a exploração tiver extensões ou refinamentos, estes também são apresentados no painel de metadados.

Metadados para campos

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

  1. Nome e detalhes do campo: o nome do campo e um ícone que representa o respetivo tipo de objeto (consulte a página de documentação Navegar nos projetos com o painel do explorador de objetos para ver todos os ícones de tipo de objeto possíveis). O painel de metadados também mostra o tipo do campo e indica o nome do ficheiro e o número da linha onde o campo está definido no LookML do ficheiro (e um link para o campo no seu projeto).
  2. Usado no menu [number] modelos: apresenta uma lista de modelos que incluem a visualização deste campo.
  3. Existe na vista: vistas que usam este campo.

Metadados para extensões

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

Por exemplo, considere o seguinte código LookML de amostra para um ficheiro de modelo no qual a aircraft_extendedexploração estende a aircraftexploração:

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 selecionar a definição do LookML para a aircraftexploração, o painel de metadados apresenta aircraft_extended na secção Estendido por. Clique no link na secção Estendido por para navegar diretamente para o LookML onde aircraft_extended está definido.

Se clicar na definição do aircraft_extended Explorar, o painel de metadados apresenta as seguintes informações acerca do aircraft Explorar expandido:

  • Visualizações unidas: lista todas as visualizações unidas ao aircraft Explorar.
  • Extends: apresenta o objeto que a análise detalhada selecionada expande. Neste caso, trata-se da opção aircraft Explorar.

Nestes exemplos, os parâmetros explore extending e extended estão juntos no mesmo ficheiro, mas nem sempre é assim. Não é óbvio determinar se um parâmetro foi estendido apenas ao observá-lo, especialmente porque os objetos estendidos e de extensão podem estar em ficheiros LookML diferentes. O painel de metadados dá-lhe contexto sobre os objetos relacionados, independentemente de onde os objetos estão definidos.

Metadados para refinamentos

O painel de metadados facilita a visualização do momento em que uma vista ou uma exploração tem refinamentos que foram adicionados ao objeto. A secção Refinements do painel de metadados apresenta o número de refinamentos que foram adicionados ao objeto, e pode usar os links para navegar para o LookML de cada refinamento.

Tal como acontece com as extensões, não pode saber se um objeto foi refinado apenas analisando o LookML, especialmente porque o LookML de refinamento pode estar num ficheiro diferente. O painel de metadados permite-lhe ver se um objeto foi refinado e, se tiver sido, permite-lhe navegar diretamente para o LookML do refinamento.

Metadados para projetos importados

O painel de metadados inclui informações sobre objetos de projetos importados, incluindo links para navegar para o ficheiro importado onde o objeto está definido. Por exemplo, se selecionar o LookML de uma análise detalhada baseada num ficheiro de visualização importado, as informações do ficheiro de visualização importado são apresentadas no painel de metadados.

No painel de metadados, pode clicar no link para navegar para o ficheiro importado onde o objeto está definido.

Além disso, pode clicar nos objetos que se encontram na pasta de projetos importados no explorador de ficheiros do IDE para ver os metadados sobre os ficheiros importados.