Pular para o conteúdo principal

Use filtros de painel

Os filtros do painel permitem que os espectadores se concentrem em dados específicos nas visualizações. Você pode criar filtros para serem interativos, permitindo que os visualizadores ajustem os valores de forma dinâmica ou estática, onde o autor do painel predefine os valores.

Filtros interativos e estáticos em nível de widget

Os filtros podem ser interativos ou estáticos, cada um com finalidades diferentes:

  • Filtros interativos: Permite que os visualizadores ajustem os valores dinamicamente, aplicando o filtro selecionado a todas as visualizações na mesma página que compartilham o mesmo dataset.
  • Filtros estáticos: Exibir um view predefinido do dataset pelo autor do painel. Eles se aplicam somente ao widget em que estão configurados, permitindo a visualização exclusiva do mesmo dataset em todos os widgets. Consulte Filtros estáticos de widgets.

Widgets de filtro

Os widgets de filtro são elementos interativos na tela do painel que aplicam filtros aos campos ou valores de parâmetros do dataset.

nota

Os parâmetros baseados em consultas combinam um filtro de campo e um filtro de parâmetros em um único widget. Para obter mais informações, consulte Parâmetros baseados em consulta.

Defina os valores do filtro default

Os valores padrão são usados quando o painel é atualizado sem a seleção de um novo valor de filtro. Para definir um valor default, selecione um valor no menu suspenso de valor padrão nas definições de configuração do widget de filtro.

Os filtros se aplicam a todo o site dataset. Para conjuntos de dados pequenos, os filtros são aplicados no navegador para otimizar o desempenho. Se o site dataset for maior, o filtro será adicionado à consulta que está sendo executada no site SQL warehouse. Consulte otimização e armazenamento em cache do conjunto de dados.

Filtrar por campos

Os filtros de campo restringem os dados por campos específicos do site dataset. Por exemplo, um filtro de campo pode limitar os dados a um determinado intervalo de datas com base em um campo de data em um site dataset. Os filtros de campo podem ser conectados a um ou mais conjuntos de dados, permitindo alterações dinâmicas nos valores de filtro disponíveis com base nas seleções. Para conectar um filtro a campos de mais de um site dataset, adicione vários campos , até um por site dataset. O filtro se aplica a todas as visualizações criadas no conjunto de dados selecionado. Selecionar um valor para um filtro altera dinamicamente os valores disponíveis mostrados nos menus suspensos para outros filtros. A imagem a seguir mostra um painel de configuração de filtro definido para filtrar em dois campos.

A configuração do filtro mostra dois conjuntos de dados selecionados. O drop-down do widget mostra valores de ambos os conjuntos de dados

Filtrar por parâmetros

Os filtros de parâmetros modificam diretamente a consulta SQL, oferecendo ajustes dinâmicos à consulta. Os filtros podem ser conectados a um ou mais parâmetros. Para conectar um filtro a mais de um parâmetro, adicione vários parâmetros no painel de configuração do filtro. Um valor default definido em um widget de filtro substitui o valor default definido no editor de consultas. Se um filtro estiver conectado a um parâmetro, ele executará uma consulta no site SQL warehouse, independentemente do tamanho do dataset. Consulte Trabalhar com parâmetros do painel.

Você pode definir valores de parâmetros para aceitar um dos seguintes tipos de dados:

  • String

  • Numérico

    • Integer
    • Decimal
  • Data

  • Data e hora

  • Intervalo de dados

  • Intervalo de data e hora

Devo filtrar por um campo ou parâmetro?

A tabela a seguir compara a filtragem diretamente nos campos do site dataset com a filtragem usando parâmetros.

Tipo de filtragem

Descrição

Desempenho

Versatilidade

Filtrando em um campo

Aplicado diretamente aos campos dataset sem modificar o dataset.

Normalmente mais rápido. Um pequeno conjunto de dados pode ser filtrado no navegador. Os grandes conjuntos de dados são filtrados executando novamente a consulta com o predicado de filtro aplicado. Consulte otimização e armazenamento em cache do conjunto de dados.

Limitado à filtragem de resultados resolvidos do dataset. Não pode ser usado em subconsultas ou em lógica condicional personalizada.

Filtrando por um parâmetro

Substitui valores diretamente na consulta dataset em tempo de execução.

É necessário executar novamente a consulta sempre que o valor do parâmetro for alterado.

Pode ser usado em subconsultas, lógica condicional ou para modificar a estrutura da consulta.

Tipos de filtro

Os filtros de campo e de parâmetros suportam vários tipos de filtro:

  • Filtros de campo: valor único, valores múltiplos, seletor de data, seletor de intervalo de datas, entrada de texto, controle deslizante de intervalo.
  • Filtros de parâmetros: valor único, valores múltiplos, seletor de datas, intervalo de datas.

Para ver exemplos que mostram como configurar diferentes tipos de filtro, consulte Tipos de filtro do painel.

Filtros em URLs de painéis publicados

Os painéis publicados armazenam filtros de campo e seleções de parâmetros na URL. Isso permite que os usuários marquem ou compartilhem um painel com configurações de filtro específicas. Quando um usuário abre a URL, o painel carrega com esses valores de filtro já aplicados.

Os identificadores de filtro não são armazenados como valores nomeados. Cada filtro é identificado por uma combinação do valor da página name e do valor do widget name, separados por um tilde (~). Esses valores são gerados automaticamente pelo site default. O identificador e o valor do filtro são passados como parte do URL para carregar o painel com a seleção de filtro especificada.

nota

O name key aparece no arquivo serializado que define o painel e não pode ser acessado na interface do usuário Databricks. Ele é separado do valor "displayName", que define o nome da página mostrado na interface do usuário. Consulte Editar um arquivo de painel.

O exemplo a seguir mostra a estrutura de um URL de painel com um valor de filtro selecionado:

<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_<page-name>~<widget-name>=<filter-value>
  • A primeira parte do URL identifica o painel publicado. Consulte URL e ID do painel.
  • A seção que identifica o filtro começa com f_ e é seguida por page-name e widget-name, separados por um til (~).
  • O valor à direita do sinal de igual (=) é o valor do filtro selecionado.

Os valores page-name e widget-name são gerados automaticamente quando o painel é criado. Você pode editar esses nomes no arquivo lvdash.json serializado. Os nomes persistem em operações como importação, exportação e republicação. Consulte Editar um arquivo de painel.

Acesse e defina valores de filtro no URL

O exemplo a seguir mostra uma URL para um painel publicado que inclui um valor de filtro selecionado:

<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_53eadf26~3490f286=10013

Esse exemplo faz referência a um painel com três filtros: Time Range , Pickup Zip e Dropoff Zip. Somente o filtro Pickup Zip recebe um valor. No URL, ele foi definido como 10013 usando o identificador f_53eadf26~3490f286.

Para criar um painel semelhante ao usado neste exemplo, consulte Criar um painel.

Especifique valores relativos do intervalo de datas no URL

Se um filtro de tempo relativo for usado, como Últimos 5 minutos ou Últimas 12 horas , o valor correspondente aparecerá na URL.

O exemplo a seguir mostra um URL com as últimas 12 horas selecionadas.

<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_53eadf26~3490f286=now-12h

Nesse caso, o identificador de filtro f_53eadf26~3490f286 é definido com o valor relativo now-12h.

Filtros estáticos de widgets

Os filtros de widgets estáticos podem ser usados para apresentar diferentes visualizações do mesmo dataset em uma tela. Diferentemente dos filtros do painel, os filtros estáticos do widget se aplicam somente ao widget de visualização em que estão configurados. Esses filtros são estáticos e não podem ser alterados pelos visualizadores do painel.

Exemplo de caso de uso

Suponha que o senhor esteja criando um painel de controle de vendas que analisa o desempenho regional. O senhor usa o site dataset com dados de ventas para todas as regiões. Ao aplicar filtros de widgets estáticos, o senhor pode configurar um widget para exibir as ventas da Região A e outro widget para exibir as ventas da Região B. Essa abordagem permite que os visualizadores comparem o desempenho regional lado a lado, mesmo que ambos os widgets sejam extraídos do mesmo dataset. Como os filtros do widget estático são fixos, os visualizadores não podem modificar os filtros, garantindo que o painel sempre apresente uma view consistente dos dados.

Adicionar um filtro de widget estático

Para adicionar um filtro de widget estático a uma visualização:

  1. Adicione um widget de visualização à tela de rascunho do painel.

  2. Com o novo widget selecionado, escolha um dataset no menu suspenso do conjunto de dados no painel de configuração.

  3. Clique em Mostrar filtros . A opção Filter fields (Filtrar campos ) aparece sob o título dataset. Para conjuntos de dados que incluem parâmetros, também é exibida uma seção Parameters (Parâmetros ).

    Um painel de configuração de visualização mostrando a opção de escolher um parâmetro.

Para adicionar um filtro de campo, faça o seguinte:

  1. Clique no sinal de mais à direita do título Filtrar campos e escolha um campo no menu suspenso.
  2. Em default, o valor do filtro é definido como All (Todos ). Use o menu suspenso para escolher um novo valor. Saia do menu suspenso para mostrar a visualização com o novo filtro aplicado.
  3. Revise seu painel.

Para saber como definir um parâmetro estático no nível do widget, consulte Parâmetros estáticos do widget.