Você está vendo a documentação do Looker 22.16. A documentação mais recente está disponível aqui.

Como criar painéis do LookML

Os painéis LookML são criados por desenvolvedores LookML e armazenados como arquivos de versão controlada. 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 e os painéis definidos pelo usuário, consulte a página de documentação Como comparar painéis definidos pelo usuário e LookML.

Para criar um painel do LookML, é necessário ter as seguintes permissões do Looker:

Além disso, é preciso ter acesso aos modelos LookML para usar os dados que você quer usar no painel.

Como criar um arquivo do 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. Para fazer isso, siga estas etapas:

Ative o Modo de desenvolvimento.
No menu Desenvolver, navegue até seu projeto.
Selecione o ícone de adição Add file or folder na parte superior do painel do navegador de arquivos no ambiente de desenvolvimento integrado do Looker para criar um arquivo do painel LookML fora das pastas do projeto atuais. Se preferir, clique no menu Opções de pasta de três pontos de uma 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, nomeie o arquivo do painel no campo de login e selecione Criar.

Editar arquivos do painel do LookML

Quando você cria um arquivo do painel do LookML, o Looker preenche automaticamente o arquivo com vários parâmetros de painel básicos, que implementam configurações para todo o painel. O arquivo também é preenchido automaticamente com vários parâmetros do elemento do painel de amostra, agrupados no parâmetro elements do painel 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 manualmente um painel usando os parâmetros do painel e os elementos do painel.
Copiar um painel definido pelo usuário:é possível criar uma cópia de um painel definido pelo usuário excluindo o LookML do painel pré-preenchido do arquivo, copiando o LookML do painel de um painel definido pelo usuário e colando-o no arquivo do painel.
Copiar um elemento LookML do painel: você pode copiar o LookML do painel de uma Explorar ou uma Aparência e colá-lo no arquivo do painel.

Ao criar um painel, lembre-se das práticas recomendadas de construção de painel. Encontre informações e recomendações sobre a criação de painéis de desempenho no artigo Práticas recomendadas para criar painéis de 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 Get LookML para expor o LookML.
A janela Get LookML vai aparecer. Com o Painel selecionado na janela, selecione todo o LookML e o copie.

Depois, cole o LookML no arquivo LookML do seu 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 elements do 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 LookML se quiser, usando os parâmetros descritos nas páginas de documentação de cada tipo de elemento.

Como adicionar filtros

Quando você salvar elementos do painel no arquivo do painel, poderá adicionar filtros para que os visualizadores do painel possam filtrar alguns ou todos os elementos em um painel. Os filtros podem ser úteis por diversos motivos, como:

Ajustar o período exibido
Ajustar a categoria de produtos, o tipo de cliente etc. específicos que estão sendo exibidos
Fornecer um recurso de tipo "quot;lookup" para um cliente ou cliente

Crie o tipo de filtro desejado. Veja abaixo os dois tipos:

Filtros que você codifica nos elementos do painel, que não podem ser alterados pelos visualizadores
Filtros do painel, que os visualizadores do painel podem mudar

Filtros codificados em elementos do painel

Os filtros codificados no elemento dos painéis, 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 filters e os subparâmetros.
Aplique o filtro do painel aos elementos do painel usando o parâmetro de elemento do painel 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 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 serem consideradas é o tipo de entrada que você espera dos usuários. Você pode atribuir um type ao filtro, fazendo 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 LookML subjacente. Nesse caso, o Looker selecionará automaticamente o tipo correto de entrada e, se o campo LookML subjacente for 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 filter usam os parâmetros explore e field. Se você incluir os parâmetros explore e field com qualquer outro tipo de filtro, receberá erros de validação LookML.

Aplicar um filtro de painel 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 "quot;listens"" para um ou mais filtros para entrada do usuário e, em seguida, faça o ajuste adequado. Esse parâmetro se aplica a todos os tipos de elementos além de type: text e type: button. Os detalhes sobre seu uso aparecem nas páginas de documentação de cada tipo de visualização individual. Para ver um exemplo representativo de como listen funciona, consulte Parâmetros de gráfico de área para painéis 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'

É possível ver que 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 este elemento com 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 categoria, simplesmente não adicione o parâmetro listen. Você só precisa adicionar um listen aos elementos que o usuário poderá ajustar.

Para ver a sintaxe da listen, primeiro escreva o nome do filtro criado e, em seguida, o nome do campo a que a entrada do usuário será aplicada.

É possível aplicar um filtro do painel 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 create do pedido (date: order.created_date), enquanto outro aplica a entrada à data de ship 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 visível 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 onde estão

 include: "/path/*.dashboard.lookml"

Também é possível incluir um painel específico especificando seu nome de arquivo:

include: "my_dashboard.dashboard.lookml"

Salvar, visualizar e publicar o painel do LookML

Para visualizar o painel, faça o seguinte:

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

É possível fazer mais alterações no arquivo .dashboard.lookml, salvá-los e visualizar o painel novamente.

Quando estiver feliz com seu painel, você poderá publicá-lo para produção, permitindo 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 instância do Looker.

Pasta de painéis do LookML

Por padrão, depois de publicados, os painéis do LookML são salvos na pasta LookML painéis. A pasta LookML painéis está localizada na pasta Folders na navegação esquerda. A pasta LookML painéis é exclusiva de outras pastas de algumas maneiras:

É preciso 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 painéis na pasta Painéis do LookML, os usuários precisam ter acesso ao modelo 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 develop no modelo que inclui o painel do LookML.
Para Explorar daqui em um determinado bloco em um painel, os visualizadores do painel devem ter a permissão explore para o modelo no qual 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 do LookML

Se você tiver as permissões do Looker do see_lookml_dashboards e do develop, bem como o 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 a pastas 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 superior da seção de painéis, e selecione a pasta para onde você 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 selecione a pasta para onde você quer mover o painel.

Se você estiver no modo de desenvolvimento, não será possível mover os painéis LookML para fora da pasta LookML painéis. Em vez disso, é possível usar 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 LookML Dashboard, você pode mover um painel LookML para outra pasta ou fixar um painel LookML em um board. No entanto, ao contrário dos painéis definidos pelo usuário, os painéis do LookML não podem ser renomeados ou movidos de uma pasta para a lixeira.

Se o valor de um parâmetro dashboard do painel LookML for alterado, o painel LookML voltará automaticamente para a pasta LookML painéis.

Como visualizar o LookML de um painel LookML atual

Se você tiver a permissão see_lookml, acesse o LookML do painel de um painel LookML atual selecionando Go to LookML no menu Ações do painel de três pontos em um painel:

Se o painel do LookML estiver no estilo de painel legado, clique em Acessar painel do LookML no menu de engrenagem do painel.

Quando você seleciona Go to LookML, o Looker navega até o arquivo do painel em que o painel LookML é definido.

Como estender um painel do LookML

Depois de criar um painel LookML, você pode estender o painel. Assim, você pode criar um segundo painel com base no original e possivelmente adicionar ou substituir algumas configurações. Em seguida, se você alterar o primeiro painel, o segundo herdará essas alterações automaticamente, a menos que sejam substituídos no segundo painel. Consulte a página de documentação Como reutilizar código com estende para mais informações.

Como melhorar o desempenho do painel usando o reconhecimento agregado

Os desenvolvedores do LookML podem melhorar o desempenho do painel do LookML com o reconhecimento agregado. Com o reconhecimento agregado, os desenvolvedores podem criar tabelas agregadas com os parâmetros explore do LookML, o que pode otimizar as consultas para um ou mais blocos em um painel.

Depois de criar e visualizar um painel do LookML, use a opção Get Looktable table LookML no menu de três pontos Painel Actions, 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.