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:
- Acesse os arquivos do projeto.
- Para abrir o painel de Ajuda rápida, selecione o ícone Ajuda rápida .
- No editor de código do LookML, coloque o cursor no objeto sobre o qual você quer mais contexto no painel de metadados.
- 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 os dashboards do LookML incluídos no modelo, com links para as definições deles 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 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:
- 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).
- 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.
- Chave primária: a chave primária da visualização.
- Visualização básica de: as análises detalhadas que usam essa visualização como base.
- Mesclagem: mostra as Análises em que esta visualização é mesclada.
Se a visualização tiver extensões ou refinamentos, eles também vão aparecer no painel de metadados.
Metadados das análises detalhadas
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:
- 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 é definida no LookML do arquivo (e um link para a Análise no seu projeto).
- Visualização base: a visualização usada como ponto de partida para a criação do recurso.
- 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 vai mostrar as seguintes informações sobre como o campo é usado no projeto:
- 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).
- Usado no menu de modelos [número]: mostra uma lista de modelos que incluem a visualização para este campo.
- 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 Estendida por do painel de metadados mostra todas as extensões desse objeto.
Por exemplo, considere o seguinte código de exemplo do LookML 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 Estendida por. Clique no link da seção Estendido por para navegar diretamente para o LookML em que aircraft_extended
está definido.
Se você clicar na definição da análise detalhada aircraft_extended
, o painel de metadados vai mostrar as seguintes informações sobre a análise detalhada aircraft
:
- Visualizações combinadas: lista todas as visualizações combinadas à Análise
aircraft
. - Extends: lista o objeto que a Análise detalhada selecionada estende. Nesse caso, é a seção
aircraft
"Explorar".
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 Aprimoramentos 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 acontece com as extensões, não é possível dizer se um objeto é refinado apenas conferindo o LookML, principalmente porque o LookML de refinamento pode estar em um arquivo diferente. O painel de metadados permite verificar se um objeto foi refinado e, se for o caso, 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.