Como usar o diagrama do LookML

O diagrama do LookML é uma extensão, ou seja, um aplicativo da Web criado com componentes do Looker, desenvolvido usando a estrutura de extensão do Looker e implantado pelo Looker Marketplace.

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

  • Avaliar a estrutura do modelo do LookML, identificando áreas em que o LookML pode ser consolidado e determinando a melhor forma de adicionar ao modelo
  • Identifique a lógica incorreta, reduzindo as chances de cálculos incorretos e desempenho ruim da consulta
  • Aprenda a fazer modelagem de dados baseada em código (LookML)

Esta página de documentação descreve como usar o diagrama do LookML versão 2.0.0 e mais recentes. Os administradores do Looker devem consultar a página de documentação Configurar a extensão do diagrama do LookML para saber como ativar essa extensão para os usuários do Looker.

Esta página mostra como:

Depois que o diagrama LookML for instalado, você poderá navegar até ele clicando em Blocos no painel de navegação à esquerda e selecionando o bloco Diagrama LookML.

Observar as relações de objetos do LookML com o diagrama do LookML

O administrador do Looker precisa conceder permissões para o modelo lookml_diagram e qualquer outro que você queira acessar na extensão.

A extensão de diagrama do LookML consiste nestes elementos:

  1. Um painel Diagram Settings para selecionar um modelo, uma ramificação do Git e uma Análise
  2. Um painel Opções de visualização para refinar quais campos você quer visualizar
  3. Uma seção de Ajuda do diagrama para explicar melhor os elementos do diagrama
  4. Uma tela de diagrama para interagir com os objetos do LookML na Análise detalhada selecionada
  5. Uma lista de campos selecionada da Análise detalhada, 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, que ajuda a se orientar em um diagrama maior
  7. Um perfilador de objetos para conferir informações sobre o objeto LookML e navegar até o LookML ou a Análise de dados associada, se aplicável

Clique duas vezes no ícone Diagram Settings ou View Options para recolher o painel esquerdo.

Como definir as configurações do diagrama

Clique no ícone do diagrama na barra de navegação para mostrar as 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 vão aparecer:

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

    Se o administrador concedeu a você permissões para mudar as ramificações do Git no diagrama do LookML, ative o modo de desenvolvimento, verifique se um modelo e uma análise estão selecionados e selecione uma ramificação para visualizar o diagrama de acordo com a configuração do modelo nessa ramificação.

  • A lista Selecionar uma Análise é preenchida com uma lista das Análises do modelo. Clique no nome de uma Análise para ver os campos dela, agrupados por visualização, exibidos na tela da página.

Conheça as opções de visualização

Com uma análise detalhada selecionada, é possível usar o painel Opções de visualização para restringir quais campos e visualizações são exibidos na tela.

Limitar os campos exibidos

Para mostrar todos os campos em cada visualização da Análise, selecione Todos os campos em Campos a serem mostrados. Para mostrar apenas as visualizações que têm campos agrupados a outros, selecione Campos com agrupamentos.

Quando ativado, o botão Ocultar campos ocultos oculta qualquer campo que contenha hidden: yes no LookML. A opção Ocultar campos ocultos está ativada por padrão.

Limitar as visualizações exibidas

A seção Visualizações do painel Opções de visualização mostra uma lista das visualizações presentes na Análise detalhada selecionada. Por padrão, todas as visualizações são mostradas na tela do diagrama. Quando você oculta uma visualização, o objeto de visualização e todas as mesclagens que conectam esse objeto a outros objetos na seção "Explorar" são ocultas da tela do diagrama.

Clique em Ocultar tudo para ocultar todas as visualizações na seção "Explorar" da tela do diagrama. Clique em Mostrar tudo para mostrar todas as visualizações na Análise detalhada.

Você também pode ocultar seletivamente visualizações individuais da tela desmarcando o ícone de olho à direita do nome da visualização. Quando a visualização está oculta, o nome dela aparece esmaecido e o ícone de olho tem um traço. Para mostrar uma visualização oculta, clique no ícone de olho riscado.

Como interpretar a tela do diagrama

O canvas do diagrama do LookML é onde todas as entidades e relações de uma determinada análise são representadas. No contexto do Looker, o diagrama do LookML mostra como os objetos do LookML são agrupados em uma Análise para um determinado modelo.

A barra de título do objeto na parte de cima da tela exibe o nome da Análise em que as visualizações são exibidas. Clique no ícone de informações da Análise de objetos, um "i" em círculo, na barra de título do objeto para abrir o Profiler de objetos e saber mais sobre a Análise de objetos selecionada. Clique na seta no sentido horário para recarregar a extensão.

Entidades

Cada visualização da seção "Explorar" é representada como um conjunto de entidades, com o nome da visualização aparecendo na parte de cima do conjunto:

  1. A visualização de base do Google Notícias é indicada por um fundo azul escuro.
  2. As visualizações agrupadas na seção "Explorar" têm um plano de fundo azul-claro.
  3. Quando uma mesclagem, visualização ou campo é selecionado, ele é destacado em azul claro.

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

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

  5. As medidas são listadas na parte de baixo e destacadas em laranja claro.

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

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

  • A: dimensões de type: string
  • #: dimensões ou medidas de type: number
  • Barras em camadas: 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 e type: zipcode

Clique no nome do campo para abrir o Perfilador de objetos e saber mais sobre o campo selecionado.

Relacionamentos

O diagrama usa uma linha para mostrar como cada objeto se relaciona a outro no modelo selecionado. A forma da linha, onde ela se conecta à visualização ou ao campo, transmite a cardinalidade da relação entre os dois objetos. Uma linha bifurcada indica uma cardinalidade "muitos", e uma única linha indica uma cardinalidade "um". Você leria a relação como da a vista base para a vista combinada. Exemplo:

  1. Uma mesclagem um a um de order_items para inventory_items, mesclando no campo id
  2. Uma mesclagem muitos para um de order_items para repeat_purchase_facts

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

Clique na linha para abrir o Perfilador de objetos e conferir mais informações sobre a mesclagem.

Opções de visualização do Canvas

Um minimapa no canto superior direito da tela pode ajudar a orientar sua posição em diagramas maiores, com a parte esmaecida do mapa indicando qual parte do diagrama está visível na tela. Clique e arraste o espaço vazio na tela para mover para 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 voltar à posição inicial padrão do diagrama.
  • Clique no ícone do mapa para ativar ou desativar o minimapa.

Como conferir informações de objetos com o criador de perfil de objetos

O Object Profiler mostra informações sobre o objeto selecionado. Clique em qualquer opção de análise detalhada, visualização, campo ou união no espaço de trabalho do diagrama para abrir o Object Profiler no lado direito. Clique na tela para recolher o Object Profiler.

Análises

Clique no ícone de informações de exploração, um "i" em círculo, no lado direito da barra de título do objeto.

Para a análise detalhada selecionada no painel Diagram Settings, o Object Profiler mostra:

  • Rótulo: o valor da Explorar label.
  • Rótulo do grupo: o valor do parâmetro group_label, que combina análises em grupos personalizados no menu Análise do Looker. Se um rótulo de grupo não for definido para a Análise detalhada, o padrão será o nome do modelo.
  • 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 de onde um modelo vai extrair dados.

Se você tiver permissões para visualizar o LookML, clique em Acessar o LookML no canto inferior esquerdo do Perfilador de objetos para abrir o arquivo em que a Análise foi definida. O arquivo é aberto em uma nova guia do navegador com a linha do explore destacada.

Visualizações

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

O Analisador de objetos mostra o nome da tabela SQL se ele for definido no LookML da visualização. 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 Acessar o LookML no canto inferior esquerdo do Perfilador de objetos para abrir o arquivo em que a Análise em que a visualização está vinculada é definida. O arquivo é aberto em uma nova guia do navegador com a linha do explore destacada.

Campos

Clique em um campo na tela do diagrama.

O Analisador de objetos mostra o nome, o tipo e o valor do campo, além de indicar se o campo é uma chave primária na parte de cima do painel. Duas guias no perfil, Detalhes e Código, mostram informações adicionais sobre o campo.

Na guia Detalhes, você pode conferir:

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

Na guia Código, é possível conferir o parâmetro de campo e os subparâmetros.

Se você tiver permissões para visualizar o LookML, clique em Acessar o LookML no canto inferior esquerdo do Perfilador de objetos para abrir o arquivo em que a mesclagem é definida. O arquivo será aberto em uma nova guia do navegador na linha da Análise da turma.

Se você tiver permissões para analisar dados, clique em Analisar com campo no canto inferior direito do Perfilador de objetos para abrir uma análise com esse campo pré-selecionado no seletor de campos.

Mesclagens

Clique em uma mesclagem na tela do diagrama.

O Profiler de objetos mostra a instrução de mesclagem que descreve a relação de mesclagem e o tipo e a cardinalidade da mesclagem.

Se você tiver permissões para visualizar o LookML, clique em Acessar o LookML no canto inferior esquerdo do Perfilador de objetos para abrir o arquivo em que a mesclagem é definida. O arquivo será aberto em uma nova guia do navegador na linha da Análise da turma.