Os painéis do LookML são criados por desenvolvedores do LookML e armazenados como arquivos com controle de versão. Por padrão, elas aparecem na pasta Dashboards do LookML da sua instância do Looker.
Para comparar 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 pelo LookML.
Para criar um painel do LookML, você precisa ter as seguintes permissões do Looker:
Além disso, você precisa ter acesso aos modelos do LookML para usar os dados que quiser no painel.
Como criar um arquivo do painel do LookML
Para criar um painel do LookML, comece criando um arquivo do painel que tenha 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 Develop, navegue até seu projeto.
Selecione o ícone de adição Adicionar arquivo ou pasta na parte superior do painel do navegador de arquivos no ambiente de desenvolvimento integrado do Looker para criar um arquivo do painel do LookML fora das pastas do projeto. Ou 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.
Uma janela Criar arquivo será exibida. Na janela, nomeie o arquivo do painel no campo de texto e selecione Criar.
Como editar arquivos do painel do LookML
Quando você cria um arquivo do painel do LookML, o Looker preenche o arquivo previamente com vários parâmetros básicos do painel, que implementam as configurações do painel inteiro. Ele também preenche o arquivo com vários parâmetros do elemento do painel de amostra, agrupados no parâmetro elements e que definem a função e a aparência dos blocos, do texto e dos botões do painel. Um arquivo .dashboard.lookml recém-criado contém um LookML do painel 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 painel 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 os parâmetros e os elementos do painel.
- Copiar um painel definido pelo usuário: para criar uma cópia de um painel definido pelo usuário, exclua o LookML do painel pré-preenchido do arquivo, copie o painel LookML de um painel definido pelo usuário e cole-o no arquivo do painel.
- Copiar LookML do painel dos elementos: você pode copiar o LookML do painel em Explorar ou Look e colá-lo no arquivo do painel.
Ao criar um painel, tenha em mente as práticas recomendadas para a criação do painel. Encontre informações e recomendações sobre como criar painéis de alto desempenho na página Considerações ao criar painéis de alto desempenho do Looker.
Como adicionar uma visualização a um painel 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 engrenagem Explorar ações.
Selecione GetLookML para expor o LookML.
Uma janela Get LookML é exibida. Com Painel selecionado na janela, selecione todo o LookML e copie-o.
Depois, cole o LookML no arquivo LookML do painel. Ao editar o arquivo LookML do painel, 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 painel. - Use o recuo correto ao colar o LookML no arquivo do painel. Se possível, corresponda 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 para cada tipo de elemento individual.
Como adicionar filtros
Quando os elementos do painel estiverem salvos no arquivo, você poderá adicionar filtros para que os visualizadores possam filtrar alguns ou todos os elementos. Os filtros podem ser úteis por vários motivos possíveis, por exemplo:
- Ajustando o período exibido
- Ajustar a categoria de produto, o tipo de cliente etc.
- Fornecimento de um recurso do tipo “pesquisa” para um cliente ou um cliente
Crie o tipo de filtro desejado. Os dois tipos são:
- Filtros que você codifica nos elementos do painel, que os visualizadores do painel não podem alterar
- Filtros do painel, que os visualizadores do painel podem alterar
Filtros codificados em elementos do painel
Os filtros que você codifica nos elementos do painel, 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 painel do LookML, esses filtros usam o parâmetro de elemento do painel 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 de painel que um usuário pode alterar em duas etapas:
- Crie o filtro do painel usando o parâmetro do painel
filterse os subparâmetros dele. - Aplique o filtro ao painel usando o parâmetro de elemento do painel
listen.
Como criar um filtro do painel
A primeira etapa é criar os filtros com os quais os usuários interagem. Para fazer isso, adicione uma seção filters ao arquivo do seu painel, que será semelhante a esta:
- 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 várias opções e parâmetros desses filtros são descritos com 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. É possível atribuir uma type ao filtro, o que faz com que ele aceite 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 selecionará automaticamente o tipo correto de entrada e, se o campo estiver em type: string, fornecerá sugestões de filtro para os visualizadores do painel.
Conforme descrito na página de documentação Parâmetros do painel, somente os filtros com
type: field filterusam os parâmetrosexploreefield. Se você incluir os parâmetrosexploreefieldcom qualquer outro tipo de filtro, receberá os erros de validação do LookML.
Como aplicar um filtro ao painel
Depois de criar um filtro do painel, você precisará aplicá-lo aos elementos corretos usando o parâmetro listen. A ideia é que o elemento "ouça" um ou mais filtros para a entrada do usuário e faça os ajustes necessários. Esse parâmetro se aplica a todos os tipos de elementos, exceto type: text e type: button, e os detalhes sobre o uso dele aparecem nas páginas de documentação para cada tipo de visualização individual. Para ver um exemplo representativo de como o listen funciona, consulte Parâmetros do gráfico de área para painéis do LookML.
Por exemplo, você pode ter um elemento com esta aparência:
- 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'). Ele não pode ser alterado pelo usuário.
Suponha que você queira que o usuário possa filtrar este 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, basta não adicionar o parâmetro listen. Você só precisa adicionar uma listen aos elementos que quer que o usuário ajuste.
Para ver a sintaxe de listen, primeiro escreva o nome do filtro criado e, em seguida, escreva o nome do campo em que você quer aplicar a entrada do usuário.
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: order.created_date), enquanto outro o 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 painel em um modelo
Para que o painel seja 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 painéis do LookML em um modelo usando um caractere curinga:
include: "*.dashboard.lookml"
ou, se os painéis 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 seu nome de arquivo:
include: "my_dashboard.dashboard.lookml"
Como salvar, visualizar e publicar o painel 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 no ícone de seta para baixo Ver ações do arquivo e selecione View Dashboard.
É possível fazer outras alterações no arquivo .dashboard.lookml, salvá-las e visualizar o painel novamente.
Quando estiver satisfeito com seu painel, você poderá publicá-lo para produção, o que permite que outros usuários com as permissões corretas o vejam. O método para publicar o painel é igual ao de publicar outras alterações no LookML na sua instância e depende das configurações de controle de versões da sua instância do Looker.
Pasta de painéis do LookML
Depois de publicados, os painéis do LookML são salvos na pasta Dashboards do LookML por padrão. A pasta Painéis do LookML está localizada na pasta Folders na navegação à esquerda. A pasta Painéis do LookML é exclusiva das outras pastas de algumas maneiras:
- Você precisa incluir um painel do LookML em pelo menos um arquivo de modelo para que ele apareça na pasta Painéis do LookML.
- Para ver a pasta Painéis do LookML, os usuários precisam ter a permissão
see_lookml_dashboards. - Para ver os painéis na pasta Painéis do LookML, os usuários precisam ter acesso ao modelo do LookML que inclui o painel.
- Para ver qualquer bloco em um painel do LookML, os visualizadores do painel precisam ter acesso ao modelo do LookML em que o bloco se baseia.
- 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 em um painel, os visualizadores do painel precisam ter a permissão
explorepara o modelo em que o bloco se baseia. - Não é possível criar uma pasta dentro da pasta Painéis do LookML.
Mover painéis do LookML para fora da pasta de painéis do LookML
Se você tiver as permissões do Looker see_lookml_dashboards e develop, além do acesso ao modelo do LookML em que um painel do LookML está incluído, será possível 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 que você quer mover, clique no botão Mover na parte superior da seção e escolha a pasta para onde quer mover o painel. Consulte a página de documentação Como organizar e gerenciar conteúdo para mais informações.
- Na pasta Painéis do LookML, clique no menu de três pontos do painel, selecione Mover no menu e escolha a pasta para que você quer mover o painel.
Se você estiver no modo de desenvolvimento, não será possível mover painéis do LookML para fora da pasta Painéis do LookML. Em vez disso, use a opção Importar para copiar o painel LookML como um painel definido pelo usuário para outra pasta.
Uma pasta que contém painéis definidos pelo usuário e painéis LookML exibe os painéis LookML em uma seção LookML Dashboard. Na seção Painel do LookML, você pode mover um painel do LookML para outra pasta ou fixar um painel do LookML em uma placa. No entanto, ao contrário dos painéis definidos pelo usuário, os painéis do LookML não podem ser renomeados ou movidos para a lixeira a partir de uma pasta.
Se o valor do parâmetro dashboard de um painel do LookML for alterado, ele será movido automaticamente para a pasta Painéis do LookML.
Como visualizar o LookML de um painel LookML existente
Se você tiver a permissão see_lookml, poderá acessar o LookML de um painel LookML existente selecionando Go to LookML no menu de três pontos Ações do painel:
Quando você seleciona Go to LookML, o Looker navega para o arquivo do painel em que o painel LookML está definido.
Como estender um painel do LookML
Depois de criar um painel do LookML, é possível estender o painel. Isso permite criar um segundo painel com base no original, possivelmente adicionando ou modificando algumas configurações. Se você alterar o primeiro painel, o segundo herdará essas alterações automaticamente, a menos que elas sejam substituídas no segundo. Consulte a página de documentação Como reutilizar código com extensões para mais informações.
Como melhorar o desempenho do painel usando reconhecimento agregado
Os desenvolvedores do LookML podem melhorar o desempenho do painel usando o reconhecimento agregado. Com o reconhecimento agregado, os desenvolvedores podem criar tabelas agregadas nos parâmetros explore do LookML, que podem otimizar as consultas para um ou mais blocos em um painel.
Depois de criar e ver um painel do LookML, você pode usar a opção Ver tabela agregada LookML 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.