Os painéis do LookML são criados por desenvolvedores do LookML e armazenados como arquivos com controle de versão. Por padrão, eles aparecem na pasta painéis do LookML da sua instância do Looker.
Para comparar painéis do LookML e definidos pelo usuário, consulte a página de documentação Comparação entre painéis definidos pelo usuário e do LookML.
Para criar um painel do LookML, você precisa ter as seguintes permissões do Looker:
Além disso, é necessário ter acesso aos modelos do LookML para todos os dados que você quer usar no painel.
Criar um arquivo de painel do LookML
Para criar um painel do LookML, comece criando um arquivo de painel com a extensão .dashboard.lookml (embora a parte .lookml da extensão seja silenciosa no ambiente de desenvolvimento integrado). As etapas para fazer isso são as seguintes:
- Ative o Modo de Desenvolvimento.
- No menu Desenvolver, 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. Ou clique no menu de Opções da pasta com três pontos para criar o arquivo dentro da pasta. Clique em Criar painel para criar o arquivo de painel.
- Uma janela Criar arquivo será exibida. Na janela, nomeie o arquivo do painel no campo de entrada e selecione o botão Criar.
Editar arquivos de dashboard do LookML
Quando você cria um arquivo de painel do LookML, o Looker preenche o arquivo com vários parâmetros de painel básicos, que implementam as configurações para todo o painel. Ele também preenche o arquivo com vários exemplos de parâmetros de elementos do painel, que são agrupados no parâmetro de painel elements e que definem a função e a aparência dos blocos, textos 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
É possível editar o arquivo do dashboard no ambiente de desenvolvimento integrado, desde que você esteja no Modo de Desenvolvimento.
Você tem várias opções para criar seu painel:
- Criação manual: é possível criar um painel manualmente usando parâmetros de painel e de elemento.
- Copiar um dashboard definido pelo usuário:para criar uma cópia de um dashboard definido pelo usuário, exclua o LookML predefinido do painel do arquivo, copie o LookML do dashboard de um dashboard definido pelo usuário e cole-o no arquivo do dashboard.
- Copiar o LookML do dashboard de elementos: é possível copiar o LookML do dashboard de uma Análise ou um Look e colá-lo no arquivo do dashboard.
Ao criar um painel, lembre-se das práticas recomendadas para a construção dele. Encontre informações e recomendações sobre a criação de dashboards de alta performance na página Considerações ao criar painéis de alta performance no Looker.
Adicionar uma visualização a um dashboard do LookML.
A maneira mais fácil de adicionar uma visualização a um painel do LookML é usar a página "Explorar" para criar uma consulta que você quer transformar em um elemento do painel:
- Depois de criar a consulta e a visualização que você quer adicionar a um painel, clique no menu de engrenagens Ações da Análise detalhada.
Selecione Acessar o LookML para expor o LookML.
Uma janela Get LookML será exibida. Com Painel selecionado na janela, selecione todo o LookML e copie.
Cole o LookML no arquivo do LookML do seu dashboard. Ao editar o arquivo LookML do painel, faça o seguinte:
- Verifique se você está no Modo de Desenvolvimento para editar o arquivo do dashboard.
- 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 já existentes no arquivo do dashboard.
É 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 os elementos do dashboard no arquivo do dashboard, adicione filtros, que permitem que os visualizadores do dashboard filtrem alguns ou todos os elementos de um dashboard. Os filtros podem ser úteis por vários motivos, por exemplo:
- Ajustando o período mostrado
- Ajustar a categoria de produto específica, o tipo de cliente etc. que está sendo mostrado.
- Fornecer uma "pesquisa" capacidade de tipo de um cliente
Crie o tipo de filtro que você quer. Os dois tipos são:
- Filtros que você codifica nos elementos do painel e que não podem ser alterados pelos visualizadores
- Filtros do painel, que os leitores do painel podem mudar
Filtros codificados em elementos do dashboard
Os filtros que você codifica nos elementos do dashboard, que não podem ser alterados pelos usuários, geralmente são criados automaticamente na etapa de cópia do LookML para uma visualização ou para um dashboard. Em um dashboard do LookML, esses filtros usam o parâmetro de 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
Com os filtros do painel, os usuários podem refinar de maneira interativa os dados mostrados nos elementos do painel. Para criar um filtro de painel, siga estas etapas:
- Crie o filtro do painel usando o parâmetro
filtersno arquivo de painel do LookML. - Aplique o filtro a elementos individuais do painel usando o parâmetro
listen.
Como criar um filtro de painel
O parâmetro filters permite criar vários tipos de filtros interativos para seu painel.
Para criar um filtro de painel que permita a interação dos usuários, adicione um parâmetro filters ao arquivo do dashboard. Por exemplo, o exemplo de código a seguir cria um dashboard do LookML com os filtros date e category_name:
- dashboard: dashboard_name
title: Dashboard Title
layout: newspaper
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
O código no exemplo anterior cria os seguintes filtros:
date: um filtro de data que permite que os usuários selecionem um período. O valor padrão é definido como os últimos 30 dias.category_name: um filtro de campo que permite que os usuários filtrem por categoria de produto. Esse filtro gera opções dinamicamente com base no campocategory.nameno modelo do LookML (ecommerce) e na Análise (product) especificados.
Aplicar um filtro de dashboard aos elementos do dashboard
Depois de criar um filtro de painel, é possível aplicá-lo a elementos individuais do painel usando o parâmetro listen. O uso do parâmetro listen dessa forma permite que os elementos vinculados sejam atualizados dinamicamente com base na seleção do usuário no filtro.
Por exemplo, considere o seguinte código do LookML de amostra para um elemento de gráfico de área:
- name: approved_orders_by_day
type: looker_area
model: ecommerce
explore: orders
dimensions: [orders.created_date]
measures: [orders.count]
filters:
orders.status: 'approved'
O gráfico approved_orders_by_day mostra a contagem de pedidos aprovados por dia, já que a consulta se baseia na dimensão orders_created_date e na medição orders.count e tem um filtro aplicado, orders.status: 'approved'. Esse filtro é fixado no elemento e não pode ser modificado pelos leitores do painel.
Para permitir que os usuários filtrem o gráfico approved_orders_by_day usando o filtro date e o filtro category_name do exemplo anterior, adicione o parâmetro listen ao elemento do painel.
- name: approved_orders_by_day
type: looker_area
model: ecommerce
explore: orders
dimensions: [orders.created_date]
measures: [orders.count]
filters:
orders.status: 'approved'
listen:
category_name: category.name
date: orders.created_date
Quando um leitor de painel interage com os filtros category_name ou date, o gráfico approved_orders_by_day é atualizado automaticamente para refletir os resultados filtrados.
O parâmetro listen usa a sintaxe filter_name: field_name. No exemplo anterior, category_name e date são os nomes dos filtros, e category.name e orders.created_date são os campos que serão usados para permitir que os leitores do painel forneçam entradas para o filtro.
Um filtro de 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: orders.created_date), enquanto outro a aplica à data de envio do pedido (date: orders.ship_date):
- name: element_one
# lots of other element parameters here
listen:
date: orders.created_date
- name: element_two
# lots of other element parameters here
listen:
date: orders.ship_date
Como incluir o arquivo do painel em um modelo
Para que o painel fique visível para visualização 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 o local deles
include: "/path/*.dashboard.lookml"
Também é possível incluir um painel específico especificando o nome do arquivo:
include: "my_dashboard.dashboard.lookml"
Salvar, visualizar e publicar o dashboard do LookML
Para conferir uma prévia do 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 no ícone de seta para baixo Ver ações do arquivo e selecione Visualizar painel.
Você pode fazer outras mudanças no arquivo .dashboard.lookml, salvá-las e conferir o painel novamente.
Quando você estiver satisfeito com o painel, poderá publicá-lo para produção. Assim, outros usuários com as permissões corretas podem vê-lo. O método de publicação do dashboard é o mesmo que publicar outras mudanças no LookML na sua instância e depende das configurações de controle de versão da instância do Looker.
Pasta de dashboards do LookML
Depois de publicados, os dashboards do LookML são salvos na pasta Dashboards do LookML por padrão. A pasta Dashboards do LookML está localizada na pasta Folders no painel de navegação à esquerda. A pasta Dashboards do LookML é exclusiva das outras pastas em alguns aspectos:
- 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 conferir a pasta Dashboards do LookML, os usuários precisam ter a permissão
see_lookml_dashboards. - Para acessar os dashboards na pasta Dashboards do LookML, os usuários precisam ter acesso ao modelo do LookML que inclui o dashboard.
- Para conferir um determinado bloco em um dashboard do LookML, os visualizadores do dashboard precisam ter acesso ao modelo do LookML em que o bloco é baseado.
- Para editar um painel na pasta Painéis do LookML, você precisa ter a permissão
developno modelo que inclui o painel do LookML. - Para Explorar daqui em qualquer bloco de um dashboard, os leitores 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.
Mover dashboards do LookML para fora da pasta dos dashboards do LookML
Se você tiver as permissões do Looker see_lookml_dashboards e develop, além de acesso ao modelo do LookML em que um painel do LookML está incluído, você poderá mover um painel do LookML para qualquer pasta em que você tenha o nível de acesso Gerenciar acesso, Editar.
Há duas maneiras de mover o painel:
- Na pasta Painéis do LookML, selecione o painel a ser movido, clique no botão Mover na parte de cima da seção "Painéis" e selecione a pasta para onde você quer mover o painel. Consulte a página de documentação Organizar e gerenciar conteúdo para mais informações.
- Na pasta Dashboards do LookML, clique no menu de três pontos do painel, selecione Mover no menu e selecione a pasta para onde você quer mover o painel.
No Modo de Desenvolvimento, não é possível mover os dashboards do LookML para fora da pasta Dashboards do LookML. Em vez disso, use a opção Importar para copiar o painel do LookML como um painel definido pelo usuário para outra pasta.
Uma pasta que contém dashboards definidos pelo usuário e dashboards do LookML exibe os dashboards 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 painéis definidos pelo usuário, os painéis do LookML não podem ser renomeados nem movidos para a lixeira de uma pasta.
Se o valor do parâmetro dashboard de um painel LookML for alterado, o painel será movido automaticamente de volta para a pasta Painéis LookML.
Como visualizar o LookML de um dashboard do LookML
Se você tiver a permissão see_lookml, poderá navegar até o LookML de um painel existente selecionando Acessar o LookML no menu de Ações do painel de três pontos:
Quando você seleciona Acessar o LookML, o Looker navega até o arquivo de dashboard em que o dashboard do LookML está definido.
Estender um dashboard do LookML
Depois de criar um painel do LookML, você pode estendê-lo. Assim, você pode criar um segundo painel com base no original, possivelmente adicionando ou substituindo algumas configurações. Se você mudar o primeiro painel, o segundo vai herdar essas mudanças automaticamente, a menos que elas sejam substituídas no segundo painel. Consulte a página de documentação Como reutilizar código com extends para mais informações.
Como melhorar a performance do painel usando a consciência agregada
Os desenvolvedores do LookML podem melhorar a performance do painel do LookML usando a percepção agregada. Com a consciência agregada, os desenvolvedores podem criar tabelas agregadas nos parâmetros explore do LookML, que podem otimizar consultas para um ou mais blocos em um painel.
Depois de criar e visualizar um painel do LookML, use a opção Obter LookML da tabela agregada no menu de três pontos Ações do painel, que fica 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.