Utilizar filtros do painel de controle

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

Interatividade e escopo do filtro

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

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

• Filtros globais: Filtros interativos que se aplicam a todas as páginas de 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 ao 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 apenas a widgets de visualização individuais onde estão configurados. Os autores do painel definem filtros com valores que os visualizadores não podem alterar. Esses filtros criam visualizações exclusivas do mesmo conjunto de dados em diferentes widgets.

Barra de filtro ativa

Todos os filtros ativos em um painel são mostrados na barra de filtros ativos na parte superior do painel. Qualquer filtro (global ou de 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, quer o valor seja definido pelo usuário ou herdado de um padrão.

Comportamento da aplicação do filtro

Por padrão, os filtros aplicam-se imediatamente quando um utilizador seleciona um valor num menu de lista. Os autores dos dashboards podem configurar filtros para se aplicarem apenas quando o espectador clica num botão Aplicar , permitindo que os espectadores selecionem múltiplos valores de filtro antes de atualizarem o dashboard. Para configurar o comportamento da aplicação do filtro, veja Configurar o comportamento da aplicação do filtro.

Filtros globais

Para visualizar todos os filtros globais, clique no ícone de filtro no canto superior esquerdo do painel. Um painel abre-se no lado direito do painel de controlo.

Para criar um filtro global:

1. Clique no ícone de filtro no canto superior esquerdo da tela do painel.
2. Clique em +. O painel de configuração do filtro é aberto no lado direito da tela.
3. Configure a configuração do 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.

Widgets de filtro

Os widgets de filtro são elementos interativos que permitem que os visualizadores ajustem os 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 no 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 Título do widget para mostrar um campo de título no widget. Edite o título no widget.
3. Ative Descrição.
4. No menu Filtro no painel de configuração, selecione Seletor de intervalo de datas.
5. Clique no ícone de mais ao lado do menu Campos. Selecione tpep_pickup_datetime do 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 Valor padrão nas definições de configuração do widget de filtro.

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

Filtrar campos

Os filtros de campo restringem os dados por campos específicos do conjunto de dados. 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 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 nas seleções. Para conectar um filtro a campos de mais de um conjunto de dados, adicione vários Campos, sendo no máximo um por cada conjunto de dados. O filtro se aplica a todas as visualizações criadas nos conjuntos de dados selecionados. Ao selecionar um valor para um filtro, altera-se dinamicamente os valores disponíveis que aparecem 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âmetros modificam a consulta SQL diretamente, oferecendo ajustes de consulta dinâmicos. 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 os parâmetros do painel.

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

• string
• Numérico
  • Inteiro
  • Decimal
• Encontro
• Data e Hora
• Intervalo de datas
• Intervalo de data e hora

Devo filtrar um campo ou um parâmetro?

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

Os parâmetros substituem valores em tempo de execução e sempre exigem que a consulta associada seja executada novamente. No entanto, os parâmetros podem oferecer maior flexibilidade para otimização de consultas. Os filtros de campo encapsulam seu SQL em uma expressão de tabela comum (CTE) e aplicam-se no 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 da consulta, como antes de uma associação em vez de depois dela. Essa flexibilidade permite otimizar o desempenho da consulta com base na estrutura de dados e nos padrões de acesso. Por exemplo, a filtragem 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 nos campos do conjunto de dados com a filtragem usando parâmetros.

Tipos de filtros

Os filtros de campo e parâmetro suportam 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âmetros: Valor único, vários valores, seletor de datas, intervalo de datas.

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

Filtros em URLs de dashboards 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 é carregado com os 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 de página name e do valor de widget name, separados por uma til (~). Esses valores são gerados automaticamente por padrão. O identificador e o valor do filtro 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 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. Veja URL e ID do painel.
• A seção que identifica o filtro começa com f_ e é seguida pelos 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 dashboard é 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. Consulte Editar um ficheiro 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: Time Range, Pickup Zip e Dropoff Zip. Apenas 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.

Especificar os valores relativos do intervalo de datas na URL

Se for usado um filtro de tempo relativo, 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 estáticos de widgets

Os filtros estáticos no nível do widget exibem uma exibição do conjunto de dados pelo autor do painel. Estes aplicam-se apenas ao widget onde estão configurados, permitindo visualizaçõ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áticos aplicam-se apenas ao widget de visualização onde estão configurados. Seus valores de filtro não podem ser alterados pelos visualizadores do painel.

Exemplo de caso de uso

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

Tipos de filtro suportados para filtros no nível do widget

Os filtros no nível do widget suportam os seguintes tipos de filtro:

• Valor único: filtrar um valor específico de um campo
• Vários valores: filtrar um ou mais valores de um campo
• Seletor de data: filtrar em uma data específica
• Seletor de intervalo de datas: filtre em um intervalo de datas, incluindo intervalos de datas relativos (como últimos 7 dias, último mês)
• Controle deslizante de intervalo: filtrar em 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 Tipos de filtro de painel.

Adicionar um filtro estático no nível do widget

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

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

2. Com o novo widget selecionado, escolha um conjunto de dados na lista suspensa Dataset no painel de configuração.

3. Clique Mostrar filtros. Uma opção campos de filtro aparece sob o 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 Campos de filtro e escolha um campo no menu suspenso.
2. Por padrão, o valor do filtro é definido como Todos os. Utilize o menu desdobrável para escolher um novo valor. Navegue para fora do menu suspenso para mostrar a visualização com o novo filtro aplicado.
3. Revise o seu painel de controlo.

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