Como usar o diagrama LookML

O diagrama do LookML é uma extensão, um aplicativo da Web criado usando componentes do Looker, desenvolvido usando o framework de extensão do Looker e implantado por meio do Looker Marketplace.

O diagrama do LookML é uma relação de entidade de um modelo LookML que mostra visualmente as relações entre os objetos LookML. Use essa extensão para:

  • Avaliar a estrutura do modelo LookML, identificar áreas em que o LookML pode ser consolidado e determinar a melhor maneira de adicionar ao modelo
  • Identifique lógica incorreta, reduzindo as chances de cálculos incorretos e desempenho insatisfatório de consultas
  • Saiba como fazer modelagem de dados com base em código (LookML)

Esta página de documentação descreve como usar o diagrama do LookML versão 2.0.0 e posterior. Os administradores do Looker devem consultar a página de documentação Como configurar a extensão do diagrama do LookML para ver instruções sobre como ativar essa extensão para os usuários do Looker.

Nesta página, falamos sobre como:

Depois da instalação do diagrama do LookML, navegue até o diagrama do LookML clicando em Blocks no painel de navegação à esquerda e selecionando o bloco LookML diagrama.

Como observar relações de objetos LookML com o diagrama LookML

Seu administrador do Looker precisa conceder a você permissões para o modelo lookml_diagram e qualquer modelo que você queira ver na extensão.

A extensão Diagrama do LookML consiste nestes elementos:

  1. Um painel Configurações do diagrama para selecionar um modelo, uma ramificação do Git e um Explorar
  2. Um painel View Options para refinar os campos que você quer ver
  3. A seção Ajuda do diagrama para mais explicações sobre os elementos do diagrama
  4. Uma tela de diagrama para interagir com os objetos LookML no recurso Explorar selecionado
  5. Uma lista selecionada de campos "Explorar" agrupada por visualização
  6. Uma barra de ferramentas com opções de zoom e posição e um ícone para mostrar ou ocultar o minimapa da tela, o que ajuda você a se orientar em um diagrama maior.
  7. Um criador de perfil de objetos para visualizar informações sobre o objeto LookML e navegar para o respectivo LookML ou Explore, se aplicável

Clique duas vezes no ícone Configurações do diagrama ou no ícone Opções de visualização para recolher o painel esquerdo.

Como definir as configurações do diagrama

Clique no ícone de diagrama na barra de navegação do diagrama para exibir Configurações do diagrama.

O menu suspenso Escolher um modelo lista todos os modelos que você tem permissões para visualizar. Depois de selecionar um modelo, duas opções adicionais serão exibidas:

  • O menu suspenso Current Branch é preenchido com uma lista das Ramificações Git desse modelo. Se o modelo tiver apenas uma ramificação, geralmente a ramificação de produção, ela será exibida. Se você estiver no Modo de produção ou se não tiver permissões para alterar as ramificações do Git, o menu suspenso Ramificação atual estará desativado.

    Caso o administrador tenha concedido permissões para você alterar as ramificações do Git no diagrama do LookML, ative o modo de desenvolvimento, verifique se um modelo e uma exploração estão selecionados e escolha uma ramificação para ver o diagrama de acordo com a configuração do modelo na ramificação.

  • A lista Selecionar uma exploração é preenchida com uma lista das explorações desse modelo. Clique no nome de uma exploração para ver os campos agrupados por visualização exibidos na tela da página.

Conhecer as opções de visualização

Com o recurso "Explorar" selecionado, você pode usar o painel Opções de visualização para restringir os campos e as visualizações que aparecem na tela.

Como limitar os campos exibidos

É possível exibir todos os campos em cada visualização do Explorar selecionando Todos os campos em Campos a serem exibidos. Para mostrar somente as vistas que têm campos associados a outros campos, selecione Campos com mesclas.

Se ativado, o botão de alternância Ocultar campos ocultos ocultará qualquer campo que contenha hidden: yes no LookML subjacente. O botão Ocultar campos ocultos é ativado por padrão.

Como limitar as visualizações exibidas

A seção Views do painel View Options mostra uma lista das visualizações presentes na guia "Explorar" selecionada. Por padrão, todas as visualizações são exibidas na tela do diagrama. Quando você oculta uma visualização, o objeto de visualização e todas as mesclagens que o conectam a outros objetos em "Explorar" ficam ocultos na tela do diagrama.

Clique em Ocultar tudo para ocultar todas as visualizações em "Explorar" na tela do diagrama. Clique em Mostrar todas para reexibir todas as visualizações nesse recurso.

Também é possível ocultar visualizações individuais da tela desmarcando o ícone de olho à direita do nome dela. Quando a visualização está oculta, o nome dela é esmaecido e o ícone de olho passa uma barra. Para reexibir uma visualização oculta individual, clique no ícone de barra.

Como interpretar a tela do diagrama

É na tela do diagrama LookML que todas as entidades e relações de uma determinada exploração são retratadas. No vernáculo do Looker, pense no diagrama LookML como uma representação de como objetos LookML são mesclados em um Explore para um determinado modelo.

A barra de título do objeto na parte superior da tela exibe o nome do recurso "Explorar" cujas visualizações são exibidas na tela. Clique no ícone "Explorar informações", um ""i" circulado", na barra de título do objeto para abrir o Criador de perfil do objeto e saber mais sobre o recurso "Explorar" selecionado. Clique na seta no sentido horário para atualizar a extensão.

Entidades

Cada visualização da exploração é representada como o próprio conjunto de entidades, com o nome da visualização aparecendo na parte superior do conjunto:

  1. A visualização base do "Explorar" é indicada por um plano de fundo azul-escuro.
  2. As vistas combinadas em "Explorar" têm um plano de fundo azul-claro.

  3. Quando uma mesclagem, uma visualização ou um campo são selecionados, eles são destacados em azul.

    Abaixo de cada visualização, há uma lista de campos que pertencem a ela:

  4. As dimensões são listadas na parte superior.

  5. As medidas são listadas na parte inferior e destacadas em laranja-claro.

  6. Se o campo for uma chave primária, um ícone de chave aparecerá à direita do nome do campo.

À esquerda de cada campo, há um ícone que indica o tipo:

  • A: dimensões de type: string
  • No: dimensões ou medidas de type: number
  • Barras em níveis: dimensões de type: tier
  • Marca de seleção: dimensões de type: yesno
  • Agenda: dimensões de type: date, type: date_time, type: time
  • Ponto do mapa: dimensões de type: location, type: distance, type: zipcode

Clique no nome do campo para abrir o Object Profiler e saber mais sobre o campo selecionado.

Relacionamentos

O diagrama usa uma linha para ilustrar como cada objeto se relaciona com outro objeto no modelo selecionado. O formato da linha, onde ele é anexado à visualização ou ao campo, transmite a cardinalidade da relação entre os dois objetos. Uma linha bifurcada indica uma cardinalidade "multiple" e uma única linha indica uma cardinalidade "one". Você leria a relação como da visualização base para a visualização mesclada. Exemplo:

  1. Mesclagem individual de order_items para inventory_items, no campo id
  2. Mescla de muitos para um entre order_items e repeat_purchase_facts

Também é possível passar o cursor sobre a linha para ver qual relação de tipo de mesclagem conecta os dois objetos.

Clique na linha para abrir o Object Profiler e ver mais informações sobre a mesclagem.

Opções de visualização das telas.

Um minimapa no canto superior direito da tela pode ajudar a orientar sua colocação em diagramas maiores, com a parte esmaecida do mapa indicando qual parte do diagrama está sendo exibida na tela no momento. Clique e arraste o espaço vazio da tela para ir a outras partes do diagrama.

Uma barra de ferramentas vertical no canto inferior esquerdo da tela contém ícones para controlar a exibição do diagrama:

  • Clique em (+) para aumentar o zoom e em - para diminuir o zoom do diagrama.
  • Clique no ícone quadrado para retornar à posição inicial padrão do diagrama.
  • Clique no ícone de mapa para ativar ou desativar o minimapa.

Como visualizar informações de objetos com o Object Profiler

O Object Profiler exibe informações sobre o objeto selecionado. Clique em "Explorar", "Ver", "Campo" ou "Mesclar" na tela do diagrama para abrir o criador de perfil do objeto no lado direito da tela. Clique na tela para recolher o Object Profiler.

Explorar

Clique no ícone Explorar informações , um "i" circunscrito ao lado direito da barra de título do objeto.

Para a opção "Explorar" selecionada no painel Configurações do diagrama, o Criador de perfil de objeto exibe:

  • Rótulo: o valor de Explorar label.
  • Marcador de grupo: o valor do parâmetro group_label, que combina "Explorar" em grupos personalizados no menu Procurar do Looker. Quando um rótulo de grupo não é definido para "Explorar", o nome do modelo é padronizado por padrão.
  • Nome do projeto: o nome do projeto do LookML, conforme definido nas configurações do projeto.
  • Nome da conexão: o valor do parâmetro connection, que especifica a conexão do banco de dados a partir da qual um modelo recuperará dados.

Se você tiver permissões para visualizar o LookML, clique em Go to LookML no canto inferior esquerdo do Object Profiler para abrir o arquivo em que "Explore" é definido. O arquivo é aberto em uma nova guia do navegador com a linha de explore destacada.

Visualizações

Clique em uma visualização na tela do diagrama.

O Object Profiler exibe o SQL Table Name se definido no LookML do view's. Se nenhum sql_table_name for definido para a visualização, o Nome da tabela SQL será mostrado como unknown.

Se você tiver permissões para visualizar o LookML, clique em Go to LookML no canto inferior esquerdo do Object Profiler para abrir o arquivo em que a exploração a que a visualização é mesclada é definida. O arquivo é aberto em uma nova guia do navegador com a linha de explore destacada.

Campos

Clique em um campo na tela do diagrama.

O Object Profiler exibe o nome, o tipo e o valor do tipo do campo e se o campo é uma chave primária na parte superior do painel. Duas guias no criador de perfil (Detalhes e Código) mostram informações adicionais sobre o campo.

Na guia Detalhes, você pode ver o seguinte:

  • Nome da visualização: o nome da visualização a que o campo pertence.
  • Rótulo: como o campo aparecerá na seção "Dados" de uma exploração, que é o nome ou o rótulo da visualização seguido pelo nome ou rótulo do campo.
  • Distribuição: para dimensões numéricas em uma vista com uma medida que tem type: count, clique em Calcular para visualizar o gráfico de colunas que mostra a distribuição dos valores de contagem. A seção Distribuição também exibe os valores mínimo, máximo e médio da série de dimensões numéricas.
  • Valores: para dimensões numéricas em uma vista com uma medida que tem type: count, clique em Calcular para exibir uma visualização dos valores de contagem. Clique em Explorar mais para abrir o recurso "Explorar" ao qual este campo pertence.

Na guia Código, você pode ver o parâmetro e subparâmetros do campo.

Se você tiver permissões para visualizar o LookML, clique em Go to LookML no canto inferior esquerdo do Object Profiler para abrir o arquivo em que a mesclagem é definida. O arquivo é aberto em uma nova guia do navegador na linha de exploração.

Se você tiver permissões para explorar dados, clique em Explorar com campo no canto inferior direito do criador de perfil do objeto para abrir uma opção "Explorar com" nesse campo pré-selecionado no seletor de campos de "Explorar".

Mesclagens

Clique em uma mesclagem na tela do diagrama.

O Cloud Profiler mostra a instrução de mesclagem que descreve a relação de mesclagem, além do tipo e da cardinalidade da mesclagem.

Se você tiver permissões para visualizar o LookML, clique em Go to LookML no canto inferior esquerdo do Object Profiler para abrir o arquivo em que a mesclagem é definida. O arquivo é aberto em uma nova guia do navegador na linha de exploração.