Criar dashboards do LookML

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 Dashboards do LookML da sua instância do Looker.

Para comparar e contrastar dashboards do LookML e painéis definidos pelo usuário, consulte a página de documentação Comparação entre painéis definidos pelo usuário e dashboards do LookML.

Para criar um dashboard do LookML, você precisa ter as seguintes permissões do Looker:

• see_lookml_dashboards
• develop

Além disso, você precisa ter acesso aos modelos do LookML para todos os dados que quiser usar no painel.

Como criar um arquivo de dashboard do LookML

Para criar um dashboard do LookML, comece criando um arquivo de dashboard, que tem a extensão .dashboard.lookml (embora a parte .lookml da extensão seja silenciosa no ambiente de desenvolvimento integrado). Para isso, siga estas etapas:

1. Ative o Modo de Desenvolvimento.
2. No menu Desenvolver, acesse seu projeto.
3. 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 de dashboard do LookML fora das pastas do projeto. Ou clique no menu de três pontos Opções da pasta para criar o arquivo dentro da pasta. Clique em Criar arquivo do dashboard para criar o arquivo do dashboard.

1. Uma janela Criar arquivo vai aparecer. Na janela, nomeie o arquivo do dashboard no campo de texto e selecione o botão Criar.

Como editar arquivos de dashboard do LookML

Quando você cria um arquivo de dashboard do LookML, o Looker pré-preenche o arquivo com vários parâmetros de dashboard básicos, que implementam configurações para todo o dashboard. Ele também pré-preenche o arquivo com vários exemplos de parâmetros de elementos do dashboard, que são agrupados no parâmetro de dashboard elements e definem a função e a aparência dos blocos, textos, botões e grupos de blocos do dashboard. Um arquivo .dashboard.lookml recém-criado contém um LookML de dashboard 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 dashboard no ambiente de desenvolvimento integrado (IDE) desde que esteja no Modo de Desenvolvimento.

Há várias opções para criar seu painel:

• Criação manual: é possível criar um dashboard manualmente usando parâmetros de dashboard e de elementos do dashboard.
• Copiar um painel definido pelo usuário: para criar uma cópia de um painel definido pelo usuário, exclua o LookML do dashboard pré-preenchido do arquivo, copie o LookML do dashboard de um painel 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 de um Look e colá-lo no arquivo do dashboard.

Ao criar um painel, lembre-se das práticas recomendadas para a construção de painéis. Encontre informações e recomendações sobre como criar painéis de desempenho na página de práticas recomendadas Considerações ao criar painéis de desempenho do Looker.

Como adicionar uma visualização a um dashboard do LookML

A maneira mais fácil de adicionar uma visualização a um dashboard do LookML é usar a página "Análise" para criar uma consulta que você quer transformar em um elemento do dashboard:

1. Depois de criar a consulta e a visualização que você quer adicionar a um dashboard, clique no menu de engrenagem Ações de análise da análise.

2. Selecione Acessar o LookML para expor o LookML.

   

3. Uma janela Acessar o LookML será exibida. Com a opção Painel selecionada na janela, selecione todo o LookML e copie-o.

   

Em seguida, 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 editar o arquivo do dashboard.
• Cole o LookML no parâmetro elements do painel.
• Use o recuo correto ao colar o LookML no arquivo do dashboard. Se possível, use o mesmo recuo dos elementos que já estão no arquivo do dashboard.

É possível ajustar os parâmetros do LookML como quiser, usando os parâmetros descritos nas páginas de documentação de cada tipo de elemento.

Adicione filtros

Depois de salvar os elementos do dashboard no arquivo, você pode adicionar filtros, que permitem que os usuários filtrem alguns ou todos os elementos de um dashboard. Os filtros podem ser úteis por vários motivos, por exemplo:

• Como ajustar o período mostrado
• Ajustar a categoria dos produtos específica, o tipo de cliente etc. que está sendo mostrado
• Oferecer um recurso de "pesquisa" para um cliente

Crie o tipo de filtro que você quer. Os dois tipos são:

• Filtros que você codifica nos elementos do dashboard, que não podem ser alterados pelos leitores do dashboard
• 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 de dashboard, os leitores podem refinar de forma interativa os dados mostrados nos elementos do dashboard. Para criar um filtro de painel, siga estas etapas:

1. Crie o filtro do dashboard usando o parâmetro filters no arquivo do dashboard do LookML.
2. Aplique o filtro a elementos individuais do dashboard 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 dashboard com que os usuários possam interagir, 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 aos usuários selecionar um período. O valor padrão é definido como os últimos 30 dias.
• category_name: um filtro de campo que permite aos usuários filtrar por categoria dos produtos. Esse filtro gera opções dinamicamente com base no campo category.name no modelo do LookML (ecommerce) e na Análise (product) especificados.

Observação: somente os filtros com type: field_filter usam os parâmetros explore e field. Se você incluir os parâmetros explore e field com qualquer outro tipo de filtro, vai receber erros de validação do LookML.

Como aplicar um filtro de dashboard aos elementos do dashboard

Depois de criar um filtro de dashboard, é possível aplicá-lo a elementos individuais do dashboard usando o parâmetro listen. Usar o parâmetro listen dessa forma permite que os elementos do link sejam atualizados dinamicamente com base na seleção do usuário no filtro.

Observação: o parâmetro listen é compatível com todos os tipos de elemento, exceto type: text, type: button e type: group.

Por exemplo, considere o seguinte exemplo de código LookML 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 é fixo 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 dashboard.

- 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 usuário do painel interage com o filtro 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.

Para mostrar um filtro diretamente em um bloco de visualização individual em vez de na barra de filtros superior do painel, adicione o parâmetro vis_filter: true à definição do filtro em filters:. Quando um elemento detecta esse filtro, o controle dele aparece em uma barra de filtros na parte de cima do bloco. Esse recurso está na visualização.

Um filtro de dashboard 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

Observação: para elementos do dashboard que usam o parâmetro merged_queries, cada consulta de origem pode detectar um ou mais filtros de dashboard. É possível definir a lógica de filtro para cada consulta de origem de forma independente, independentemente do número de consultas de origem no elemento de resultados combinados. Se uma consulta não tiver um parâmetro listen, ela não será afetada por nenhum filtro do painel.

Como incluir o arquivo do dashboard 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 de arquivo:

include: "my_dashboard.dashboard.lookml"

Como salvar, visualizar e publicar o dashboard do LookML

Para visualizar o painel:

1. Salve o arquivo .dashboard.lookml clicando no botão Salvar alterações no canto superior direito do arquivo.
2. Inclua o painel no arquivo de modelo relevante e salve as mudanças nesse arquivo.
3. No arquivo .dashboard.lookml que você quer visualizar, clique no ícone de seta para baixo Ver ações do arquivo e selecione Ver painel.

Você pode fazer mais mudanças no arquivo .dashboard.lookml, salvá-las e visualizar o painel novamente.

Quando o painel estiver pronto, você poderá publicá-lo na produção, o que permite que outros usuários com as permissões corretas o vejam. O método para publicar o painel é o mesmo que 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 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 Pastas na navegação à esquerda. A pasta Dashboards do LookML é diferente das outras pastas de algumas maneiras:

• 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 ver a pasta Dashboards do LookML, os usuários precisam ter a permissão see_lookml_dashboards.
• Para ver os dashboards na pasta Dashboards do LookML, os usuários precisam ter acesso ao modelo do LookML que inclui o dashboard.
• Para ver um bloco em um dashboard do LookML, os leitores precisam ter acesso ao modelo do LookML em que o bloco se baseia.
• Para editar um dashboard na pasta Dashboards do LookML, você precisa ter a permissão develop no modelo que inclui o dashboard do LookML.
• Para Analisar a partir daqui em qualquer bloco de um painel, os leitores precisam ter a permissão explore para o modelo em que o bloco se baseia.
• Não é possível criar uma pasta dentro da pasta Dashboards do LookML.
• No Modo de Produção, a lista da pasta dashboards do LookML é paginada (30 dashboards por página). No Modo de Desenvolvimento, todos os dashboards do LookML ficam em uma única página.
• Cada dashboard do LookML é classificado na pasta Dashboards do LookML de acordo com o nome definido no código do dashboard do LookML, em vez do título. Como resultado, os painéis podem não aparecer em ordem alfabética por título.

Como mover dashboards do LookML para fora da pasta de 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 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 LookML, selecione o dashboard que você quer mover, clique no botão Mover na parte de cima da seção de dashboards e selecione a pasta de destino. Consulte a página de documentação Como organizar e gerenciar conteúdo para mais informações.
• Na pasta Dashboards do LookML, clique no menu de três pontos do dashboard, selecione Mover no menu e escolha a pasta para onde você quer mover o dashboard.

Se você estiver no Modo de Desenvolvimento, não será 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 dashboard do LookML como um painel definido pelo usuário para outra pasta.

Uma pasta que contém painéis definidos pelo usuário e dashboards do LookML exibe os dashboards do LookML em uma seção Dashboard do LookML. Na seção Dashboard do LookML, é possível mover um dashboard do LookML para outra pasta ou fixá-lo em um board. No entanto, ao contrário dos painéis definidos pelo usuário, os dashboards do LookML não podem ser renomeados ou movidos para a lixeira de uma pasta.

Quando um dashboard do LookML é movido para fora da pasta Dashboards do LookML, ele herda os controles de acesso da pasta de destino. Para visualizar um dashboard do LookML em outra pasta, os usuários (incluindo os de incorporação) precisam ter a permissão see_looks ou see_user_dashboards, além de acesso à pasta de destino e ao modelo do LookML do dashboard. Os usuários que têm apenas a permissão see_lookml_dashboards não podem visualizar os dashboards do LookML que foram movidos para fora da pasta Dashboards do LookML.

Se o valor do parâmetro dashboard de um dashboard do LookML for alterado, ele será movido automaticamente de volta para a pasta Dashboards do LookML.

Como visualizar o LookML de um dashboard do LookML

Se você tiver a permissão see_lookml, poderá acessar o LookML de um dashboard do LookML selecionando Acessar o LookML no menu de três pontos Ações do dashboard:

Quando você seleciona Acessar o LookML, o Looker navega até o arquivo do dashboard em que o dashboard do LookML está definido.

Como estender um dashboard do LookML

Depois de criar um dashboard do LookML, é possível estendê-lo. Isso permite criar um segundo painel com base no original, possivelmente adicionando ou substituindo algumas configurações. Se você alterar o primeiro painel, o segundo herdará essas alterações automaticamente (a menos que sejam substituídas no segundo painel). Para mais informações, consulte a página de documentação Reutilizar código com extensões.

Como adicionar agentes de dashboard aos dashboards do LookML

É possível configurar agentes de dados de dashboard do Conversational Analytics para seus dashboards do LookML. Os agentes de painel permitem que os leitores façam perguntas sobre os dados do painel em linguagem natural usando uma interface de chat de conversação.

Para configurar um agente de dashboard do LookML:

1. Defina um agente de dashboard em um arquivo LookML usando o parâmetro agent com is_dashboard_agent: yes e seu instructions personalizado.
2. No arquivo .dashboard.lookml, associe o agente ao dashboard do LookML usando o parâmetro default_dashboard_agent. Controle o acesso ao chat com o parâmetro enabled_dashboard_agent. Exemplo:

- dashboard: sales_overview
  title: "Sales Overview"
  layout: newspaper
  enabled_dashboard_agent: true
  default_dashboard_agent: sales_dashboard_agent

É possível testar as instruções e o comportamento do agente no Modo de Desenvolvimento antes de implantá-los na produção. Para detalhes completos sobre como configurar, testar e gerenciar agentes de dashboards do LookML, consulte a página de documentação Criar e gerenciar agentes de dados para dashboards do LookML.

Como melhorar o desempenho do painel usando o reconhecimento de agregação

Os desenvolvedores do LookML podem melhorar o desempenho do dashboard do LookML usando o reconhecimento de agregados. Com o reconhecimento de agregados, os desenvolvedores podem criar tabelas de agregação nos parâmetros explore do LookML, que podem otimizar as consultas para um ou mais blocos em um painel.

Depois de criar e visualizar um dashboard do LookML, use a opção Acessar o LookML da tabela de agregação no menu de três pontos Ações do dashboard, 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.

Observação: confira outras informações e recomendações sobre como criar painéis de desempenho na página de práticas recomendadas Considerações ao criar painéis de desempenho do Looker.