Criar painéis de controlo do LookML

Os painéis de controlo do LookML são criados por programadores do LookML e armazenados como ficheiros com controlo de versões. Por predefinição, aparecem na pasta Painéis de controlo do LookML da sua instância do Looker.

Para comparar e contrastar os painéis de controlo do LookML e os painéis de controlo definidos pelo utilizador, consulte a página de documentação Comparar painéis de controlo definidos pelo utilizador e do LookML.

Para criar um painel de controlo do LookML, tem de ter as seguintes autorizações do Looker:

Além disso, tem de ter acesso aos modelos LookML para todos os dados que quer usar no painel de controlo.

Criar um ficheiro de painel de controlo do LookML

Para criar um painel de controlo do LookML, comece por criar um ficheiro de painel de controlo, que tem a extensão .dashboard.lookml (embora a parte .lookml da extensão seja silenciosa no IDE). Os passos para o fazer são os seguintes:

  1. Ative o modo de programação.
  2. No menu Desenvolver, navegue para o seu projeto.
  3. Selecione o ícone de mais Adicionar ficheiro ou pasta na parte superior do painel do explorador de ficheiros no IDE do Looker para criar um ficheiro do painel de controlo do LookML fora das pastas do projeto existentes. Em alternativa, clique no menu de três pontos Opções da pasta de uma pasta para criar o ficheiro na pasta. Clique em Criar painel de controlo para criar o ficheiro do painel de controlo.

  1. É apresentada uma janela Criar ficheiro. Na janela, atribua um nome ao ficheiro do painel de controlo no campo de introdução e selecione o botão Criar.

Editar ficheiros de painéis de controlo do LookML

Quando cria um ficheiro de painel de controlo do LookML, o Looker pré-preenche o ficheiro com vários parâmetros do painel de controlo básicos, que implementam definições para todo o painel de controlo. Também pré-preenche o ficheiro com vários parâmetros de elementos do painel de controlo, que estão agrupados no parâmetro do painel de controlo elements e que definem a função e o aspeto dos mosaicos, do texto e dos botões do painel de controlo. Um ficheiro .dashboard.lookml recém-criado contém LookML do painel de controlo semelhante ao seguinte:

- dashboard: order_analysis
  title: Order Analysis
  layout: newspaper
  preferred_viewer: dashboards-next
  tile_size: 100

  filters:

  elements:
    - name: hello_world
      type: looker_column

Pode editar o ficheiro do painel de controlo no IDE, desde que esteja no modo de desenvolvimento.

Tem várias opções para criar o seu painel de controlo:

  • Criação manual: pode criar manualmente um painel de controlo usando parâmetros de painel de controlo e parâmetros de elementos do painel de controlo.
  • Copie um painel de controlo definido pelo utilizador: pode criar uma cópia de um painel de controlo definido pelo utilizador eliminando o LookML do painel de controlo pré-preenchido do ficheiro, copiando o LookML do painel de controlo de um painel de controlo definido pelo utilizador e colando-o no ficheiro do painel de controlo.
  • Copiar LookML de elementos do painel de controlo: pode copiar o LookML do painel de controlo de uma exploração ou de um Look e colá-lo no ficheiro do painel de controlo.

Quando criar um painel de controlo, tenha em atenção as práticas recomendadas para a criação de painéis de controlo. Encontre informações e recomendações sobre a criação de painéis de controlo com bom desempenho na página de práticas recomendadas Considerações ao criar painéis de controlo do Looker com bom desempenho.

Adicionar uma visualização a um painel de controlo do LookML existente

A forma mais fácil de adicionar uma visualização a um painel de controlo LookML existente é usar a página Explorar para criar uma consulta que quer transformar num elemento do painel de controlo:

  1. Depois de criar a consulta e a visualização que quer adicionar a um painel de controlo, clique no menu de engrenagem Ações de exploração do Explore.

  2. Selecione Obter LookML para expor o LookML.

  3. É apresentada uma janela Get LookML. Com o Painel de controlo selecionado na janela, selecione todo o LookML e copie-o.

    Na parte superior da janela Obter LookML, existem separadores para o LookML do painel de controlo, da tabela agregada e da tabela derivada.

A partir daqui, cole o LookML no ficheiro LookML do painel de controlo. Ao editar o ficheiro LookML do painel de controlo, certifique-se de que:

  • Confirme se está no modo de programação para poder editar o ficheiro do painel de controlo.
  • Cole o LookML no parâmetro elements do painel de controlo.
  • Use a indentação correta quando colar LookML no ficheiro do painel de controlo. Se possível, faça corresponder o recuo aos elementos existentes que já se encontram no ficheiro do painel de controlo.

Se quiser, pode ajustar os parâmetros LookML através dos parâmetros descritos nas páginas de documentação de cada tipo de elemento individual.

Adicionar filtros

Depois de ter elementos do painel de controlo guardados no ficheiro do painel de controlo, pode querer adicionar filtros, que permitem aos visitantes do painel de controlo filtrar alguns ou todos os elementos num painel de controlo. Os filtros podem ser úteis por vários motivos possíveis, por exemplo:

  • Ajustar o período apresentado
  • Ajustar a categoria de produto específica, o tipo de cliente, etc., que está a ser apresentado
  • Fornecer uma capacidade do tipo "consulta" para um cliente

Certifique-se de que cria o tipo de filtro pretendido. Os dois tipos são:

  • Filtros que codifica nos elementos do painel de controlo e que os visitantes do painel de controlo não podem alterar
  • Filtros do painel de controlo que os visitantes do painel de controlo podem alterar

Filtros codificados nos elementos do painel de controlo

Os filtros que codifica nos elementos do painel de controlo, que os utilizadores não podem alterar, são normalmente criados automaticamente no passo de cópia do LookML para uma visualização ou para um painel de controlo. Num painel de controlo do LookML, esses filtros usam o parâmetro do elemento do painel de controlo filters e têm o seguinte aspeto:

- name: element_name
  # lots of other element parameters here
  filters:
    dimension_or_measure_name: 'looker filter expression'

Filtros do painel de controlo

Os filtros do painel de controlo permitem que os visitantes refinem interativamente os dados apresentados nos elementos do painel de controlo. Para criar um filtro do painel de controlo, siga estes passos:

  1. Crie o filtro do painel de controlo usando o parâmetro filters no ficheiro do painel de controlo do LookML.
  2. Aplique o filtro a elementos individuais do painel de controlo através do parâmetro listen.

Criar um filtro de painel de controlo

O parâmetro filters permite-lhe criar vários tipos de filtros interativos para o seu painel de controlo.

Para criar um filtro do painel de controlo com o qual os utilizadores podem interagir, adicione um parâmetro filters ao ficheiro do painel de controlo. Por exemplo, o código de exemplo seguinte cria um painel de controlo 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 utilizadores selecionar um intervalo de datas. O valor predefinido está definido para os últimos 30 dias.
  • category_name: um filtro de campo que permite aos utilizadores filtrar por categoria de produto. Este filtro gera dinamicamente opções baseadas no campo category.name no modelo LookML especificado (ecommerce) e na exploração (product).

Aplicar um filtro do painel de controlo aos elementos do painel de controlo

Depois de criar um filtro do painel de controlo, pode aplicá-lo a elementos individuais do painel de controlo através do parâmetro listen. A utilização do parâmetro listen desta forma permite que os elementos associados sejam atualizados dinamicamente com base na seleção do utilizador no filtro.

Por exemplo, considere o seguinte código LookML de exemplo 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 apresenta a quantidade de encomendas aprovadas por dia, uma vez que a consulta se baseia na dimensão orders_created_date e na medida orders.count, e tem um filtro aplicado, orders.status: 'approved'. Este filtro é fixo no elemento e não pode ser modificado pelos visitantes do painel de controlo.

Para permitir que os utilizadores filtrem o gráfico approved_orders_by_day através do filtro date e do filtro category_name do exemplo anterior, adicione o parâmetro listen ao elemento do painel de controlo.

- 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 visitante do painel de controlo interage com o filtro category_name ou o filtro 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 vão ser usados para permitir que os visitantes do painel de controlo forneçam informações ao filtro.

Um filtro do painel de controlo pode ser aplicado a qualquer campo (do mesmo tipo de dados) em qualquer elemento. Por exemplo, um elemento pode aplicar a entrada de um utilizador à data de criação da encomenda (date: orders.created_date), enquanto outro a aplica à data de envio da encomenda (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

Incluir o ficheiro do painel de controlo num modelo

Para que o painel de controlo seja visível na pré-visualização no modo de desenvolvimento ou visível na produção, tem de ser incluído no ficheiro de modelo no qual o painel de controlo se baseia através de uma declaração include.

Uma prática comum é incluir todos os painéis de controlo do LookML num modelo através de um caráter universal:

include: "*.dashboard.lookml"

Em alternativa, se os seus painéis de controlo do LookML aparecerem numa pasta no IDE, use o caminho para a respetiva localização

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

Também pode incluir um painel de controlo específico, especificando o respetivo nome de ficheiro:

include: "my_dashboard.dashboard.lookml"

Guardar, pré-visualizar e publicar o painel de controlo do LookML

Para pré-visualizar o painel de controlo:

  1. Guarde o ficheiro .dashboard.lookml clicando no botão Guardar alterações no canto superior direito do ficheiro.
  2. Inclua o painel de controlo no ficheiro de modelo relevante e guarde as alterações nesse ficheiro.
  3. No ficheiro .dashboard.lookml que quer pré-visualizar, clique no ícone de seta para baixo Ver ações do ficheiro e selecione Ver painel de controlo.

Pode fazer mais alterações ao ficheiro .dashboard.lookml, guardá-las e pré-visualizar o painel de controlo novamente.

Quando estiver satisfeito com o painel de controlo, pode publicá-lo na produção, o que permite que outros utilizadores com as autorizações corretas o vejam. O método de publicação do painel de controlo é o mesmo que o de publicação de outras alterações ao LookML na sua instância e depende das definições de controlo de versões da sua instância do Looker.

Pasta de painéis de controlo do LookML

Após a publicação, os painéis de controlo do LookML são guardados na pasta Painéis de controlo do LookML por predefinição. A pasta Painéis de controlo do LookML encontra-se na pasta Pastas no painel de navegação do lado esquerdo. A pasta Painéis de controlo do LookML é diferente de outras pastas de várias formas:

  • Tem de incluir um painel de controlo do LookML em, pelo menos, um ficheiro de modelo para que apareça na pasta Painéis de controlo do LookML.
  • Para ver a pasta Painéis de controlo do LookML, os utilizadores têm de ter a autorização see_lookml_dashboards.
  • Para ver painéis de controlo na pasta Painéis de controlo do LookML, os utilizadores têm de ter acesso ao modelo do LookML que inclui o painel de controlo.
  • Para ver qualquer mosaico num painel de controlo do LookML, os visitantes do painel de controlo têm de ter acesso ao modelo do LookML no qual o mosaico se baseia.
  • Para editar um painel de controlo na pasta Painéis de controlo do LookML, tem de ter a autorização develop no modelo que inclui o painel de controlo do LookML.
  • Para Explorar a partir daqui num determinado mosaico num painel de controlo, os visitantes do painel de controlo têm de ter a autorização explore para o modelo no qual o mosaico se baseia.
  • Não pode criar uma pasta na pasta Painéis de controlo do LookML.

Mover painéis de controlo do LookML para fora da pasta de painéis de controlo do LookML

Se tiver as see_lookml_dashboards e develop autorizações do Looker, bem como acesso ao modelo LookML no qual um painel de controlo do LookML está incluído, pode mover um painel de controlo do LookML para qualquer pasta para a qual tenha o nível de acesso à pasta Gerir acesso, Editar.

Existem duas formas de mover o painel de controlo:

  • Na pasta Painéis de controlo do LookML, selecione o painel de controlo a mover, clique no botão Mover na parte superior da secção de painéis de controlo e selecione a pasta para a qual quer mover o painel de controlo. Consulte a página de documentação Organizar e gerir conteúdo para mais informações.
  • Na pasta Painéis de controlo do LookML, clique no menu de três pontos do painel de controlo, selecione Mover no menu e selecione a pasta para a qual quer mover o painel de controlo.

Se estiver no modo de programação, não pode mover painéis de controlo do LookML para fora da pasta Painéis de controlo do LookML. Em alternativa, pode usar a opção Importar para copiar o painel de controlo do LookML como um painel de controlo definido pelo utilizador para outra pasta.

Uma pasta que contenha painéis de controlo definidos pelo utilizador e painéis de controlo do LookML apresenta os painéis de controlo do LookML numa secção Painel de controlo do LookML. Na secção Painel de controlo do LookML, pode mover um painel de controlo do LookML para outra pasta ou fixar um painel de controlo do LookML num quadro. No entanto, ao contrário dos painéis de controlo definidos pelo utilizador, não é possível mudar o nome dos painéis de controlo do LookML nem movê-los para o lixo a partir de uma pasta.

Se o valor do parâmetro dashboard de um painel de controlo do LookML for alterado, o painel de controlo do LookML é automaticamente movido novamente para a pasta Painéis de controlo do LookML.

Ver o LookML de um painel de controlo do LookML existente

Se tiver a autorização see_lookml, pode navegar para o LookML do painel de controlo de um painel de controlo LookML existente selecionando Aceder ao LookML no menu de três pontos Ações do painel de controlo de um painel de controlo:

Quando seleciona Aceder ao LookML, o Looker navega para o ficheiro do painel de controlo no qual o painel de controlo do LookML está definido.

Estender um painel de controlo do LookML

Depois de criar um painel de controlo do LookML, pode expandi-lo. Isto permite-lhe criar um segundo painel de controlo com base no original, podendo adicionar ou substituir algumas definições. Em seguida, se alterar o primeiro painel de controlo, o segundo herda essas alterações automaticamente (a menos que sejam substituídas no segundo painel de controlo). Consulte a página de documentação Reutilizar código com extends para mais informações.

Melhorar o desempenho do painel de controlo através da notoriedade agregada

Os programadores do LookML podem conseguir melhorar o desempenho do painel de controlo do LookML através da consciência agregada. Com a consciência agregada, os programadores podem criar tabelas agregadas nos parâmetros explore do LookML, que podem otimizar as consultas para um ou mais mosaicos num painel de controlo.

Depois de criar e estar a ver um painel de controlo do LookML, pode usar a opção Obter LookML da tabela agregada no menu de Ações do painel de controlo de três pontos, que fica visível se tiver a autorização see_lookml.

Para mais informações, consulte a página de documentação do parâmetro aggregate_table.