Como usar o diagrama do LookML

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

O diagrama do LookML é um relacionamento de entidade de um modelo do LookML que mostra visualmente os relacionamentos entre os objetos LookML. Use essa extensão para:

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

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

Esta página discute como:

Após a instalação do diagrama do LookML, clique em Blocos no painel de navegação à esquerda e selecione o bloco Diagrama do LookML para acessar o diagrama.

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

O administrador do Looker precisa conceder permissões ao modelo lookml_diagram e a qualquer modelo que você queira visualizar na extensão.

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

  1. Um painel Configurações do diagrama para selecionar um modelo, uma ramificação do Git e uma exploração
  2. Um painel Opções de visualização para refinar quais campos você deseja visualizar
  3. Uma seção de Ajuda do diagrama para fornecer uma explicação adicional dos elementos do diagrama
  4. Uma tela de diagrama para interagir com os objetos LookML na seção "Explorar"
  5. Uma lista selecionada de campos de "Explorar" agrupada por visualização
  6. Uma barra de ferramentas com opções de zoom e posição, além de um ícone para mostrar ou ocultar o minimapa da tela, o que ajuda na orientação em um diagrama maior.
  7. Um criador de perfil de objeto para visualizar informações sobre o objeto LookML e navegar para o LookML ou Explore dele, se aplicável

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

Como definir as configurações do diagrama

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

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

  • A lista suspensa Branch atual é preenchida com uma lista de branches Git desse modelo. Se o modelo tiver apenas uma ramificação, geralmente a branch de produção, ela será exibida. Se você estiver no modo de produção ou não tiver permissões para alterar branches do Git, o menu suspenso Branch atual será desativado.

    Se o administrador tiver concedido permissões para 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 selecione 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 dela agrupados por visualização, exibidos na tela da página.

Explorar as opções de visualização

Com a opção "Explorar" selecionada, você pode usar o painel Opções de visualização para restringir os campos e as visualizações exibidos na tela.

Como limitar os campos exibidos

Você pode optar por exibir todos os campos em cada visualização da guia Explorar selecionando Todos os campos em Campos a serem exibidos. Ou, para mostrar apenas as visualizações que têm campos associados a outros campos, selecione Campos com mesclagens.

Se ativado, o botão de alternância Ocultar campos ocultos oculta qualquer campo que contenha hidden: yes no LookML subjacente. A opção Ocultar campos ocultos fica ativada por padrão.

Como limitar as visualizações exibidas

A seção Visualizações do painel Opções de visualização mostra uma lista das visualizações presentes no Explorar selecionado. 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 junções 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 tudo para exibir todas as visualizações da guia "Explorar".

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 estiver oculta, o nome dela ficará esmaecido e o ícone de olho terá uma barra atravessada. Para exibir uma visualização oculta individual, clique no ícone de olho.

Como interpretar a tela do diagrama

A tela do diagrama do LookML é onde todas as entidades e relacionamentos de uma determinada exploração são representados. No veredito do Looker, o diagrama de LookML mostra como os objetos LookML são mesclados em um recurso "Explorar" para um modelo específico.

A barra de título do objeto na parte superior da tela exibe o nome da exploração 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 de objeto e saber mais sobre o recurso Explorar selecionado. Clique na seta no sentido horário para recarregar a extensão.

Entidades

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

  1. A visualização básica do Explorar é indicada por um plano de fundo azul escuro.
  2. As visualizações agrupadas na guia "Explorar" têm um fundo azul claro.

  3. Quando um agrupamento, uma visualização ou um 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 superior.

  5. As medidas estã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 indicando 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, type: zipcode

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

Relacionamentos

O diagrama usa uma linha para descrever como cada objeto está relacionado a outro objeto no modelo selecionado. O formato da linha, em que ela se conecta à visualização ou ao campo, transmite a cardinalidade da relação entre os dois objetos. Uma linha bifurcada indica uma cardinalidade "muitas", e uma única linha indica uma cardinalidade "uma". Leia a relação como da visualização base para a visualização mesclada. Exemplo:

  1. Uma participação de um para um de order_items a inventory_items no campo id.
  2. Uma participação de muitos para um de order_items a 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 de tela

Um minimapa no canto superior direito do canvas pode ajudar a orientar seu posicionamento em diagramas maiores, com a parte esmaecida do mapa indicando qual parte do diagrama está sendo exibida no momento. Clique e arraste o espaço vazio da tela para ir 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 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 Criador de perfil de objeto exibe informações sobre o objeto selecionado. Clique em qualquer exploração, visualização, campo ou mesclagem na tela do diagrama para abrir o criador de perfil de objeto no lado direito da tela. Clique na tela para recolher o criador de perfil do objeto.

Explores

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

Para o recurso Explorar selecionado no painel Configurações do diagrama, o Criador de perfil de objeto exibe:

  • Rótulo: o valor da função Explorar label.
  • Rótulo do grupo: o valor do parâmetro group_label, que combina o recurso Explorar em grupos personalizados no menu Procurar do Looker. Se um rótulo de grupo não estiver definido para a exploração, 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 que um modelo recuperará dados.

Se você tiver permissões para ver o LookML, clique em Go to LookML no canto inferior esquerdo do Profiler para abrir o arquivo em que o recurso "Explorar" está 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 Criador de perfil de objeto exibe o Nome da tabela SQL, se 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 LookML, clique em Go to LookML no canto inferior esquerdo do Object Profiler para abrir o arquivo em que a opção "Explorar" à qual a visualização está associada é 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 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ê encontra:

  • View Name: 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 rótulo da visualização seguido do nome ou rótulo do campo.
  • Distribuição: para dimensões numéricas em uma visualização com uma medida com type: count, clique em Calcular para mostrar uma visualização do gráfico de colunas que descreve 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 visualização com uma medida que tem type: count, clique em Calcular para mostrar uma visualização dos valores de contagem. Clique em Explorar mais para abrir o recurso ao qual este campo pertence.

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

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

Se você tiver permissões para explorar dados, clique em Explorar com campo no canto inferior direito do Criador de perfil de objetos para abrir um Explorar com esse campo pré-selecionado no seletor de campo "Explorar".

Mesclagens

Clique em uma mesclagem na tela do diagrama.

O Criador de perfil de objeto exibe a declaração de mesclagem que descreve a relação, o tipo e a cardinalidade da mesclagem.

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