O diagrama do LookML é uma extensão, um aplicativo da Web criado com componentes do Looker, desenvolvida com o framework de extensão do Looker e implantada no Marketplace do Looker.
O diagrama do LookML é um diagrama de entidade e relacionamento de um modelo LookML que representa visualmente as relações entre os objetos LookML. Use essa extensão para:
- Avaliar a estrutura do modelo LookML, identificando áreas em que o LookML pode ser consolidado e determinando a melhor maneira de adicionar a ele.
- Identifique uma 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)
Nesta página de documentação, descrevemos como usar o diagrama LookML versão 2.0.0 e mais recentes. Os administradores do Looker precisam consultar a página de documentação Como configurar a extensão do diagrama LookML para conferir instruções sobre como ativar essa extensão para usuários do Looker.
Esta página discute como:
- Navegue até o diagrama do LookML
- Observar relações de objetos do LookML com o diagrama do LookML
- Definir as configurações do diagrama
- Configurar opções de visualização para uma Análise
- Interpretar a tela do diagrama
- Observar informações do objeto com o Object Profiler
Como navegar até o diagrama do LookML
Depois de instalar o diagrama do LookML, clique em Blocos no painel de navegação à esquerda e selecione o bloco Diagrama do LookML.
Como observar relações de objetos do LookML com o diagrama do LookML
Seu administrador do Looker precisa conceder a você permissões para o modelo lookml_diagram e qualquer modelo que você queira visualizar na extensão.
A extensão do diagrama do LookML consiste nos seguintes elementos:
- Um painel Diagram Settings para selecionar um model, uma ramificação Git e uma Explore.
- Um painel Opções de visualização para refinar quais campos você quer ver
- Uma seção de Ajuda do diagrama para fornecer explicações adicionais sobre os elementos do diagrama
- Uma tela de diagrama para interagir com os objetos LookML no Explore selecionado
- Uma lista de campos de uma Análise selecionada, agrupados por visualização
- Uma barra de ferramentas com opções de zoom e posição e um ícone para mostrar ou ocultar o minimapa da tela, ajudando na sua orientação em um diagrama maior.
- Um objeto Profiler para visualizar informações sobre o objeto LookerML e navegar até o LookML ou o Explore associado, se aplicável
Clique duas vezes no ícone Diagram Settings ou View Options para fechar o painel esquerdo.
Como definir as configurações do diagrama
Clique no ícone do 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 será 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 não tiver permissões para mudar ramificações do Git, o menu suspenso Branch atual será desativado.
Se o administrador tiver concedido a você permissões para mudar as ramificações Git do diagrama LookML, ative o Modo de Desenvolvimento, verifique se um modelo e uma Análise estão selecionados e, em seguida, selecione uma ramificação para exibir o diagrama de acordo com a configuração do modelo nessa ramificação.
A lista Select an Explore é preenchida com uma lista de Explores desse modelo. Clique no nome de uma Análise para ver os campos dele, agrupados por visualização, exibidos na tela da página.
Conheça as opções de visualização
Com uma Análise 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 exibidos. Se quiser mostrar apenas as vistas que têm campos associados a outros, selecione Campos com mesclagens.
Se ativada, a opção Ocultar campos ocultos vai ocultar qualquer campo que contenha hidden: yes no LookML subjacente. A opção Ocultar campos ocultos é ativada por padrão.
Limitar as visualizações exibidas
A seção Views do painel View Options mostra uma lista das visualizações presentes no Explore selecionado. 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 as mesclagens que conectam esse objeto a outros objetos no Explore ficam ocultos na tela do diagrama.
Clique em Hide all para ocultar todas as visualizações em "Explore" na tela do diagrama. Clique em Mostrar tudo para mostrar todas as visualizações na Análise.
Você também pode ocultar seletivamente visualizações individuais no canvas, desmarcando o ícone do olho à direita do nome da visualização. Quando a visualização está oculta, o nome dela aparece esmaecido e o ícone de olho tem uma barra. Para reexibir uma visualização oculta individual, clique no ícone de olhos cortados.
Como interpretar a tela do diagrama
Todas as entidades e relacionamentos de um determinado Explore são retratados na tela do diagrama LookML. Na linguagem do Looker, o diagrama do LookML mostra como os objetos do LookerML são mesclados em uma Análise para um determinado modelo.
A barra de título do objeto na parte superior da tela mostra o nome da Análise com visualizações que são exibidas na tela. Clique no ícone "Explorar" (um "i" circunscrito) na barra de título do objeto para abrir o Criador de perfil de objetos e saber mais sobre a Análise selecionada. Clique na seta no sentido horário para atualizar a extensão.
Entidades
Cada visualização da Análise é representada como o próprio conjunto de entidades, com o nome da visualização aparecendo na parte de cima do conjunto:
- A visualização básica do Explore é indicada por um fundo azul-escuro.
- As visualizações agrupadas em "Explorar" têm um fundo azul-claro.
Quando uma mesclagem, visualização ou campo é selecionado, ele é destacado em azul brilhante.
Abaixo de cada visualização há uma lista de campos pertencentes a ela:
As dimensões são listadas na parte de cima.
As medidas estão listadas na parte inferior e destacadas em laranja-claro.
Se o campo for uma chave primária, um ícone de chave vai aparecer à direita do nome dele.
À 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 níveis: dimensões de
type: tier - Marca de seleção: dimensões de
type: yesno - Agenda: dimensões de
type: date,type: date_timeetype: 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 descrever como cada objeto se relaciona com outro objeto no modelo selecionado. A forma da linha, anexada à 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 "um". A relação seria lida como da visualização base para a visualização unida. Exemplo:
- Uma mesclagem um para um de
order_itemsparainventory_items, mesclando no campoid. - Uma mesclagem de muitos para um de
order_itemsarepeat_purchase_facts
Também é possível passar o cursor sobre a linha para conferir qual relação de tipo de mesclagem conecta os dois objetos.
Clique na linha para abrir o Criador de perfil de objetos e conferir mais informações sobre a mesclagem.
Opções de visualização de tela
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á sendo exibida no momento. Clique e arraste o espaço vazio no canvas 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 mostra informações sobre o objeto selecionado. Clique em qualquer Análise, visualização, campo ou mesclagem na tela do diagrama para abrir o Criador de perfil de objetos no lado direito da tela. Clique na tela para recolher o Criador de perfil de objetos.
Explores
Clique no ícone "Explore info" (um "i" circulado) no lado direito da barra de título do objeto.
Para o Explore selecionado no painel Diagram Settings, o Object Profiler exibe:
- Rótulo: o valor do atributo Explorar
label. - Etiqueta do grupo: o valor do parâmetro
group_label, que combina as Análises em grupos personalizados no menu Explorar do Looker. Se um rótulo de grupo não estiver definido para a Análise, o nome do modelo será usado 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 de onde um modelo vai recuperar dados.
Se você tiver permissões para acessar o LookML, clique em Acessar LookML no canto inferior esquerdo do Object Profiler para abrir o arquivo em que a Análise está 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 Object Profiler mostra 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 acessar o LookML, clique em Acessar LookML no canto inferior esquerdo do Object Profiler para abrir o arquivo em que a Análise a que a visualização está associada está 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 Object Profiler mostra 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 (Details e Code) mostram informações adicionais sobre o campo.
Na guia Detalhes, você encontra estas informações:
- Nome da visualização: o nome da visualização à qual o campo pertence.
- Rótulo: como o campo aparece 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 tenha
type: count, clique em Calcular para exibir uma prévia 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 com
type: count, clique em Calcular para mostrar uma prévia dos valores de contagem. Clique em Explorar mais para abrir a opção Explorar a que esse campo pertence.
Na guia Código, é possível ver o parâmetro e os subparâmetros do campo.
Se você tiver permissões para acessar o LookML, clique em Acessar LookML no canto inferior esquerdo do Object Profiler para abrir o arquivo em que a mesclagem está definida. O arquivo é aberto em uma nova guia do navegador na linha do Explore da mesclagem.
Se você tiver permissões para explorar dados, clique em Explorar com campo no canto inferior direito da Ferramenta de criação de objeto para abrir uma Análise com esse campo pré-selecionado no seletor de campos.
Mesclagens
Clique em uma mesclagem na tela do diagrama.
O Object Profiler exibe a instrução de mesclagem que descreve a relação e o tipo e a cardinalidade da mesclagem.
Se você tiver permissões para acessar o LookML, clique em Acessar LookML no canto inferior esquerdo do Object Profiler para abrir o arquivo em que a mesclagem está definida. O arquivo é aberto em uma nova guia do navegador na linha do Explore da mesclagem.