Os dashboards do LookML são criados por desenvolvedores do LookML e armazenados como arquivos com controle de versões. Por padrão, eles aparecem na pasta painéis do LookML da sua instância do Looker.
Para comparar e contrastar os painéis do LookML e os definidos pelo usuário, consulte a página de documentação Como comparar painéis definidos pelo usuário e do LookML.
Para criar um dashboard do LookML, é preciso ter as seguintes permissões do Looker:
Além disso, você precisa ter acesso aos modelos LookML para todos os dados que quiser usar no dashboard.
Como criar um arquivo dashboard do LookML
Para criar um dashboard do LookML, comece criando um arquivo do dashboard, que tenha a extensão .dashboard.lookml, embora a parte .lookml da extensão esteja silenciosa no ambiente de desenvolvimento integrado. Estas são as etapas:
- Ative o Modo de desenvolvimento.
- No menu Develop, navegue até seu projeto.
Selecione o ícone de adição Adicionar arquivo ou pasta na parte de cima do painel do navegador de arquivos no ambiente de desenvolvimento integrado do Looker para criar um arquivo do dashboard do LookML fora das pastas do projeto. Se preferir, clique no menu de três pontos Opções de pasta para criar o arquivo dentro da pasta. Clique em Criar painel para criar o arquivo do painel.
A janela Create File será exibida. Na janela, dê um nome ao arquivo do painel no campo de gravação e selecione o botão Criar.
Editar arquivos do dashboard do LookML
Quando você cria um arquivo do dashboard do LookML, o Looker preenche automaticamente o arquivo com vários parâmetros do painel básicos que implementam as configurações de todo o painel. Ele também preenche automaticamente o arquivo com vários parâmetros do elemento do painel de exemplo, agrupados no parâmetro do dashboard elements e definem a função e a aparência dos blocos, texto e botões do painel. Um arquivo .dashboard.lookml recém-criado contém um dashboard do LookML semelhante a este:
- dashboard: order_analysis
title: Order Analysis
layout: newspaper
preferred_viewer: dashboards-next
tile_size: 100
filters:
elements:
- name: hello_world
type: looker_column
Você pode editar o arquivo do painel no ambiente de desenvolvimento integrado como quiser, desde que esteja no modo de desenvolvimento.
Há várias opções para criar seu painel:
- Criação manual:você pode criar um painel manualmente usando parâmetros e parâmetros dos elementos do painel.
- Copiar um dashboard definido pelo usuário:é possível criar a cópia de um dashboard definido pelo usuário excluindo o LookML pré-preenchido do arquivo, copiando o LookML do dashboard de um painel definido pelo usuário e colando-o no arquivo do dashboard.
- Copiar o LookML do dashboard dos elementos:é possível copiar o LookML do dashboard de uma Análise ou de um Look e colá-lo no seu arquivo do dashboard.
Ao criar um painel, tenha em mente as práticas recomendadas para a construção de um painel. Encontre informações e recomendações sobre como criar painéis de alto desempenho na página de práticas recomendadas Considerações ao criar painéis de alto desempenho do Looker.
Adicionar uma visualização a um dashboard do LookML atual
A maneira mais fácil de adicionar uma visualização a um dashboard do LookML atual é usar a página Explorar para criar uma consulta que você queira transformar em um elemento do dashboard:
- Depois de criar a consulta e a visualização que você quer adicionar a um painel, clique no menu de engrenagem Analisar ações do Explore.
Selecione Acessar LookML para expor o LookML.
Uma janela Get LookML será exibida. Com Dashboard selecionado na janela, selecione todo o LookML e copie-o.
Depois, cole o LookML no arquivo do LookML do dashboard. Ao editar o arquivo LookML do dashboard, faça o seguinte:
- Verifique se você está no modo de desenvolvimento para poder editar o arquivo do painel.
- Cole o LookML no parâmetro
elementsdo dashboard. - Use o recuo correto ao colar o LookML no arquivo do dashboard. Se possível, associe o recuo aos elementos existentes que já estão no arquivo do painel.
É possível ajustar os parâmetros do LookML, se quiser, usando os parâmetros descritos nas páginas de documentação de cada tipo de elemento individual.
Adicione filtros
Depois de salvar elementos do painel no seu arquivo de painel, você pode adicionar filtros, que permitem que os visualizadores do painel filtrem alguns ou todos os elementos em um painel. Os filtros podem ser úteis por vários motivos. Por exemplo:
- Ajuste o período mostrado
- Ajustar a categoria de produto específica, tipo de cliente etc. sendo mostrado
- Fornecer um recurso do tipo "pesquisa" para um cliente
Crie o tipo de filtro desejado. Os dois tipos são:
- Filtros que você codifica nos elementos do painel, que não podem ser modificados pelos visualizadores do painel.
- Filtros do painel, que os leitores podem mudar
Filtros codificados em elementos do dashboard
Os filtros codificados nos elementos do dashboard, que os usuários não podem alterar, geralmente são criados automaticamente na etapa de cópia do LookML para uma visualização ou para um painel. Em um dashboard do LookML, esses filtros usam o parâmetro do elemento do dashboard filters e têm esta aparência:
- name: element_name
# lots of other element parameters here
filters:
dimension_or_measure_name: 'looker filter expression'
Filtros do painel
É possível criar filtros do painel que um usuário pode alterar em duas etapas:
- Crie o filtro do painel usando o parâmetro
filtersdo painel e os subparâmetros dele. - Aplique o filtro aos elementos do painel usando o parâmetro
listen.
Como criar um filtro do painel
A primeira etapa é criar os filtros com que os usuários interagem. Para fazer isso, adicione uma seção filters ao seu arquivo do painel, que terá esta aparência:
- dashboard: dashboard_name
# possibly some other dashboard parameters here
filters:
- name: date
title: 'Date Range'
type: date_filter
default_value: 30 days
- name: category_name
type: field_filter
model: ecommerce
explore: product
field: category.name
As diversas opções e parâmetros para esses filtros são descritos em mais detalhes na página de documentação Parâmetros do painel. Uma das coisas mais importantes a ter em mente é o tipo de entrada que você espera dos usuários. Você pode atribuir um type ao filtro, o que o fará aceitar um tipo específico de entrada, como números, datas ou strings. Também é possível usar o filtro type para associar um filtro a um campo do LookML subjacente. Nesse caso, o Looker vai selecionar automaticamente o tipo correto de entrada e, se o campo do LookML subjacente for type: string, fornecer sugestões de filtro aos leitores do painel.
Conforme descrito na página de documentação Parâmetros do painel, apenas filtros com
type: field filterusam os parâmetrosexploreefield. Se você incluir os parâmetrosexploreefieldcom qualquer outro tipo de filtro, vão ocorrer erros de validação do LookML.
Como aplicar um filtro do dashboard aos elementos do painel
Depois de criar um filtro do painel, aplique-o aos elementos adequados usando o parâmetro listen. A ideia é que o elemento "detecte" um ou mais filtros de entrada do usuário e faça os ajustes necessários. Esse parâmetro se aplica a todos os tipos de elementos além de type: text e type: button, e os detalhes sobre o uso aparecem nas páginas de documentação para cada tipo de visualização. Para conferir um exemplo representativo de como listen funciona, consulte Parâmetros do gráfico de área para painéis do LookML.
Por exemplo, você pode ter um elemento parecido com este:
- name: approved_orders_by_day
type: looker_area
model: ecommerce
explore: order
dimensions: [order.created_date]
measures: [order.count]
filters:
order.status: 'approved'
Esse elemento já tem um parâmetro filters que o restringe a pedidos aprovados (usando o filtro order.status: 'approved'). Isso não pode ser alterado pelo usuário.
Suponha que você queira que o usuário possa filtrar esse elemento usando os filtros do painel criados anteriormente neste exemplo. Para fazer isso, adicione um parâmetro listen como este:
- name: approved_orders_by_day
type: looker_area
model: ecommerce
explore: order
dimensions: [order.created_date]
measures: [order.count]
filters:
order.status: 'approved'
listen:
category_name: category.name
date: order.created_date
Se você não quiser que os usuários ajustem a data ou a categoria, não adicione o parâmetro listen. Você só precisa adicionar uma listen aos elementos que você quer que o usuário possa ajustar.
Você verá que a sintaxe listen funciona primeiro escrevendo o nome do filtro criado e depois o nome do campo em que você quer aplicar a entrada do usuário.
Um filtro do painel pode ser aplicado a qualquer campo (do mesmo tipo de dados) em qualquer elemento. Por exemplo, um elemento pode aplicar a entrada de um usuário à data de criação do pedido (date: order.created_date), enquanto outro a aplica à data de envio do pedido (date: order.ship_date):
- name: element_one
# lots of other element parameters here
listen:
date: order.created_date
- name: element_two
# lots of other element parameters here
listen:
date: order.ship_date
Como incluir o arquivo do dashboard em um modelo
Para que seu painel fique visível no Modo de Desenvolvimento ou na produção, ele precisa ser incluído no arquivo de modelo em que o painel se baseia usando uma instrução include.
Uma prática comum é incluir todos os dashboards do LookML em um modelo usando um caractere curinga:
include: "*.dashboard.lookml"
ou, se os dashboards do LookML aparecerem em uma pasta no ambiente de desenvolvimento integrado, use o caminho para a localização deles
include: "/path/*.dashboard.lookml"
Você também pode incluir um painel específico especificando seu nome de arquivo:
include: "my_dashboard.dashboard.lookml"
Como salvar, visualizar e publicar o dashboard do LookML
Para visualizar o painel:
- Salve o arquivo
.dashboard.lookmlclicando no botão Save Changes no canto superior direito do arquivo. - Inclua o painel no arquivo de modelo relevante e salve as alterações nesse arquivo.
- No arquivo
.dashboard.lookmlque você quer visualizar, clique na seta para baixo Ver ações do arquivo e selecione Ver painel.
Você pode fazer outras alterações no arquivo .dashboard.lookml, salvá-las e visualizar o painel novamente.
Quando estiver contente com seu painel, publique-o para produção. Assim, outros usuários com as permissões corretas poderão vê-lo. O método para publicar o painel é o mesmo que publicar outras mudanças no LookML na sua instância e depende das configurações de controle de versão da sua instância do Looker.
Pasta de dashboards do LookML
Depois de publicados, os dashboards do LookML são salvos na pasta LookML dashboards por padrão. A pasta Dashboards do LookML está localizada na pasta Folders no painel de navegação à esquerda. A pasta Dashboards do LookML é diferente das outras pastas por alguns motivos:
- Você precisa incluir um dashboard do LookML em pelo menos um arquivo de modelo para que ele apareça na pasta Dashboards do LookML.
- Para acessar a pasta Dashboards do LookML, os usuários precisam ter a permissão
see_lookml_dashboards. - Para conferir os painéis na pasta Dashboards do LookML, os usuários precisam ter acesso ao modelo do LookML que inclui o dashboard.
- Para visualizar qualquer bloco em um dashboard do LookML, os visualizadores do dashboard precisam ter acesso ao modelo LookML em que o bloco se baseia.
- Para editar um dashboard na pasta Dashboards do LookML, você precisa ter a permissão
developno modelo que inclui o dashboard do LookML. - Para Explorar aqui em qualquer bloco de um painel, os visualizadores do painel precisam ter a permissão
explorepara o modelo em que o bloco é baseado. - Não é possível criar uma pasta dentro da pasta Dashboards do LookML.
Como mover dashboards do LookML para fora da pasta de dashboards do LookML
Se você tiver as permissões see_lookml_dashboards e develop do Looker, bem como acesso ao modelo LookML em que um dashboard do LookML está incluído, poderá mover um dashboard do LookML para qualquer pasta em que tenha o nível de acesso Gerenciar acesso, editar.
Há duas maneiras de mover o painel:
- Na pasta Dashboards do Looker, selecione o dashboard a ser movido, clique no botão Mover na parte superior da seção de dashboards e selecione a pasta para a qual quer mover o dashboard. Para mais informações, consulte a página de documentação Como organizar e gerenciar conteúdo.
- Na pasta Dashboards do LookML, clique no menu de três pontos do dashboard, selecione Mover no menu e escolha a pasta para a qual você quer mover o dashboard.
No Modo de Desenvolvimento, não é possível mover painéis do LookML para fora da pasta Dashboards do LookML. Em vez disso, é possível usar a opção Importar para copiar o dashboard do LookML como um dashboard definido pelo usuário para outra pasta.
Uma pasta que contém dashboards definidos pelo usuário e painéis do LookML exibe os painéis do LookML em uma seção Painel do LookML. Na seção Painel do LookML, é possível mover um dashboard do LookML para outra pasta ou fixar um dashboard do LookML em um quadro. No entanto, ao contrário dos dashboards definidos pelo usuário, os dashboards do LookML não podem ser renomeados ou movidos de uma pasta para a lixeira.
Se o valor do parâmetro dashboard de um dashboard do LookML for alterado, o dashboard do LookML será movido automaticamente de volta para a pasta Dashboards do LookML.
Como visualizar o LookML de um dashboard do LookML atual
Se você tiver a permissão see_lookml, poderá navegar até o dashboard do LookML de um dashboard do LookML atual selecionando Go to LookML no menu de três pontos Ações do dashboard:
Quando você seleciona Go to LookML, o Looker navega até o arquivo do dashboard em que o dashboard do LookML está definido.
Como ampliar um dashboard do LookML
Depois de criar um dashboard do LookML, é possível estender o dashboard. Assim, é possível criar um segundo painel com base no original, possivelmente adicionando ou substituindo algumas configurações. Então, se você alterar o primeiro painel, o segundo herdará essas alterações automaticamente (a menos que seja substituído no segundo painel). Para mais informações, consulte a página de documentação Como reutilizar códigos com extensões.
Como melhorar a performance do painel usando o reconhecimento agregado
Os desenvolvedores do LookML podem melhorar a performance do dashboard usando o reconhecimento agregado. Com o reconhecimento agregado, os desenvolvedores podem criar tabelas agregadas nos parâmetros explore do LookML, que podem otimizar consultas para um ou mais blocos em um dashboard.
Depois de criar e acessar um dashboard do LookML, use a opção Acessar tabela de agregação do LookML no menu de três pontos Ações do painel, que estará visível se você tiver a permissão see_lookml.
Para mais informações, consulte a página de documentação do parâmetro aggregate_table.