Usar filtros de painel

Os filtros limitam os dados apresentados nas visualizações do painel para que os usuários possam se concentrar em dados que atendam a critérios específicos. Esta página explica os tipos de filtro disponíveis e como trabalhar com eles.

Filtrar interatividade e escopo

Os autores do painel podem configurar filtros para serem interativos, permitindo que os visualizadores ajustem valores dinamicamente ou estaticamente, em que o autor do painel predefini valores de filtro. Os filtros interativos permitem que os visualizadores do painel selecionem os valores do conjunto de dados em visualizações relacionadas. Um editor de dashboard configura valores de filtro estáticos e os aplica somente ao widget em que estão configurados, permitindo exibições exclusivas do mesmo conjunto de dados entre widgets.

Os filtros de painel operam em escopos diferentes, cada um com características específicas:

• Filtros globais: Filtros interativos que se aplicam em todas as páginas em um painel para visualizações que compartilham um ou mais conjuntos de dados. Os visualizadores podem ajustar esses valores dinamicamente e as alterações afetam todo o painel. Consulte filtros globais.

• Filtros no nível da página: Widgets de filtro interativos que se aplicam a todas as visualizações na mesma página que compartilham um ou mais conjuntos de dados. Os visualizadores podem modificar esses valores para alterar a exibição dessa página específica.

• Filtros no nível do widget: Filtros estáticos que se aplicam somente a widgets de visualização individuais em que estão configurados. Os autores do painel definem filtros com valores que os visualizadores não podem alterar. Esses filtros criam exibições exclusivas do mesmo conjunto de dados em widgets diferentes.

Barra de filtro ativa

Todos os filtros ativos em um painel são mostrados na barra de filtros ativos perto da parte superior do painel. Qualquer filtro (global ou nível de página) não definido como Todos, bem como qualquer filtragem cruzada, aparece nesta barra. A barra de filtros ativos exibe todos os filtros globais e de nível de página, juntamente com seus valores, se o valor é definido pelo usuário ou herdado de um padrão.

Filtrar o comportamento do aplicativo

Por padrão, os filtros se aplicam imediatamente quando um visualizador seleciona um valor em um menu suspenso. Os autores do painel podem configurar filtros a serem aplicados somente quando o visualizador clicar em um botão Aplicar , permitindo que os visualizadores selecionem vários valores de filtro antes de atualizar o painel. Para configurar o comportamento do aplicativo de filtro, consulte Configurar o comportamento do aplicativo de filtro.

Filtros globais

Para exibir todos os filtros globais, clique no Ícone de filtro no canto superior esquerdo do painel. Um painel abre no lado direito do painel.

Para criar um filtro global:

1. Clique no filtre o ícone no canto superior esquerdo da tela do painel.
2. Clique em +. O painel de configuração de filtro é aberto no lado direito da tela.
3. Configure a configuração de filtro como faria com qualquer outro widget de filtro interativo. Para obter exemplos de configuração de widgets de filtro, consulte tipos de filtro de painel.

Filtrar widgets

Os widgets de filtro são elementos interativos que permitem aos visualizadores ajustar valores de filtro no nível da página em campos e parâmetros do conjunto de dados.

Para criar um widget de filtro:

1. Clique Adicione um filtro (campo/parâmetro) para adicionar um widget de filtro. Em seguida, coloque o filtro em uma página na tela do painel. O filtro é selecionado e um painel de configuração é aberto no lado direito da tela.
2. Ative o título do Widget para mostrar um campo de título no widget. Edite o título no widget.
3. Ative a Descrição.
4. No menu suspenso Filter no painel de configuração, selecione Seletor de faixa de datas.
5. Clique no além do ícone ao lado do menu Campos . Clique em tpep_pickup_datetime no menu suspenso.

Definir valores de filtro padrão

Os valores padrão são usados quando o painel é atualizado sem selecionar um novo valor de filtro. Para definir um valor padrão, selecione um valor na lista suspensa de Valor Padrão nas configurações do widget de filtro.

Os filtros se aplicam a todo o conjunto de dados. Para pequenos conjuntos de dados, os filtros são aplicados no navegador para otimizar o desempenho. Se o conjunto de dados for maior, o filtro será adicionado à consulta que é executada no SQL Warehouse. Confira Otimização e armazenamento em cache do conjunto de dados.

Filtrar em campos

O campo filtra dados estreitos por campos de conjunto de dados específicos. Por exemplo, um filtro de campo pode limitar os dados a um intervalo de datas específico com base em um campo de data em um conjunto de dados. 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 em seleções. Para conectar um filtro a campos de mais de um conjunto de dados, adicione vários campos , até um por conjunto de dados. O filtro se aplica a todas as visualizações criadas nos conjuntos de dados selecionados. 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.

Filtrar parâmetros

Os filtros de parâmetro modificam a consulta SQL diretamente, oferecendo ajustes dinâmicos de 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 padrão definido em um widget de filtro substitui o valor padrão definido no editor de consultas. Se um filtro estiver conectado a um parâmetro, ele executará uma consulta no SQL Warehouse, independentemente do tamanho do conjunto de dados. Veja Trabalhar com parâmetros de painel.

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

• corda
• Numérico
  • Número Inteiro
  • Decimal
• Data
• Data e hora
• Intervalo de datas
• Intervalo de Data e Hora

Devo filtrar em um campo ou parâmetro?

Para conjuntos de dados relativamente pequenos, os filtros de campo geralmente têm um desempenho mais eficiente do que os parâmetros, pois o Azure Databricks os aplica no navegador sem executar novamente a consulta.

Os parâmetros substituem valores em runtime e sempre exigem que a consulta associada seja executada novamente. No entanto, os parâmetros podem oferecer maior flexibilidade para otimização de consulta. Os filtros de campo encapsulam seu SQL em uma CTE (expressão de tabela comum) e se aplicam ao final de uma consulta, o que pode ser menos eficiente em alguns casos.

Com parâmetros, você pode colocar condições de filtro em qualquer lugar na consulta, como antes de uma junção, em vez de depois dela. Essa flexibilidade permite otimizar o desempenho da consulta com base em sua estrutura de dados e padrões de acesso. Por exemplo, filtrar antes de uma junção reduz significativamente os dados processados durante a operação de junção.

A tabela a seguir compara a filtragem diretamente em campos de conjunto de dados com a filtragem usando parâmetros.

Tipos de filtro

Os filtros de campo e de parâmetro dão suporte a vários tipos de filtro:

• Filtros de campo: Valor único, vários valores, seletor de data, seletor de intervalo de datas, entrada de texto, controle deslizante de intervalo.
• Filtros de parâmetro: Valor único, vários valores, seletor de data, intervalo de datas.

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

Filtros em URLs de painel publicados

Os painéis publicados armazenam filtros de campo e seleções de parâmetro 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 é carregado com esses valores de filtro já aplicados.

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 til (~). Esses valores são gerados automaticamente por padrão. O identificador de filtro e o valor são passados como parte da URL para carregar o painel com a seleção de filtro especificada.

O exemplo a seguir mostra a estrutura de uma URL do 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 da URL identifica o painel publicado. Consulte URL e ID do Painel.
• A seção que identifica o filtro começa com f_ e é seguida pelo page-name e widget-name, separados por uma tilde (~).
• O valor à direita do sinal de igual (=) é o valor de filtro selecionado.

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

Acessar e definir valores de filtro na 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

Este exemplo faz referência a um painel com três filtros: Intervalo de Tempo, Zip de Retirada e Zip de Entrega. Somente o filtro Zip de Retirada recebe um valor. Na URL, foi configurado como 10013 usando o identificador f_53eadf26~3490f286.

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

Especificar valores relativos de intervalo de datas na 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 uma 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 f_53eadf26~3490f286 de filtro é definido como o valor now-12hrelativo.

Filtros de widgets estáticos

Os filtros de nível de widget estático exibem uma exibição do conjunto de dados definido pelo autor do painel. Elas se aplicam somente ao widget em que estão configurados, permitindo exibições exclusivas do mesmo conjunto de dados em widgets diferentes. Ao contrário dos filtros globais e de nível de página, os filtros de widget estático se aplicam somente ao widget de visualização em que estão configurados. Seus valores de filtro não podem ser alterados pelos visualizadores do painel.

Caso de uso de exemplo

Suponha que você esteja criando um painel de vendas que analisa o desempenho regional. Você usa um conjunto de dados com dados de vendas para todas as regiões. Aplicando filtros de widget estático, você pode configurar um widget para exibir vendas para a Região A e outro widget para exibir as vendas para a Região B. Essa abordagem permite que os visualizadores comparem o desempenho regional lado a lado, mesmo que ambos os widgets extraam do mesmo conjunto de dados. Como os filtros de widget estático são corrigidos, os visualizadores não podem modificar os filtros, garantindo que o painel sempre apresente uma exibição consistente dos dados.

Tipos de filtro com suporte para filtros no nível do widget

Os filtros no nível do widget dão suporte aos seguintes tipos de filtro:

• Valor único: filtrar um valor específico de um campo
• Vários valores: filtrar em um ou mais valores de um campo
• Seletor de data: filtrar em uma data específica
• Seletor de intervalo de datas: filtrar em um intervalo de datas, incluindo intervalos de datas relativos (como últimos 7 dias, mês passado)
• Controle deslizante de intervalo: Filtrar por um intervalo numérico
• Entrada de texto: filtrar com base na correspondência de texto

Para obter exemplos de configuração de cada tipo de filtro, consulte os tipos de filtro de painel.

Adicionar um filtro estático de nível de widget

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

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

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

3. Clique em Mostrar filtros. A opção Campos de filtro aparecerá abaixo do título do conjunto de dados. Para conjuntos de dados que incluem parâmetros, uma seção Parâmetros também é exibida.

   

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

1. Clique no sinal de adição à direita do título Filtrar campos e escolha um campo no menu suspenso.
2. Por padrão, o valor de filtro é definido como Tudo. Use o menu suspenso para escolher um novo valor. Navegue para fora do menu suspenso para mostrar a visualização com o novo filtro aplicado.
3. Revise seu painel.

Para saber mais sobre como definir um parâmetro de nível de widget estático, consulte parâmetros de widget estático.