Compartilhar via

Filtros de consulta

  • Artigo

Um filtro de consulta permite reduzir interativamente a quantidade de dados mostrados em uma visualização. Os filtros de consulta são semelhantes ao parâmetro de consulta, mas com algumas diferenças importantes. Um filtro de consulta limita os dados após a execução da consulta. Isso torna os filtros ideais para conjuntos de dados e ambientes menores em que as execuções de consulta são demoradas, limitadas por taxa ou onerosas.

A descrição a seguir enumera alguns benefícios do Databricks SQL.

  • Embora os filtros de consulta anteriores operassem somente no lado do cliente, esses filtros atualizados funcionam dinamicamente no lado do cliente ou do servidor para otimizar o desempenho.
  • Experiência de interface do usuário simplificada: clique no botão +Adicionar filtro e selecione uma coluna em uma lista suspensa para adicionar um filtro. Você não precisa criar, permitir e atualizar uma consulta separada para filtrar os valores distintos de uma coluna.
  • Habilite “realçar valores relevantes” para ver quais seleções dentro de um filtro retornarão os resultados dadas outras seleções de filtro. Por exemplo, considere um usuário que tenha os filtros "Estado" e "Cidade". Se um usuário optar por realçar valores relevantes, selecionar "Califórnia" no filtro de estado destacará apenas as cidades da Califórnia no filtro "Cidade". As opções não realçadas são colocadas em uma opção de menu "Filtrado" na lista suspensa.
  • Filtros de entrada de texto: filtra os resultados da coluna com base em pesquisas de entrada de texto. Há três modos com os quais a pesquisa pode encontrar correspondências: correspondência exata, contém e começa com.
  • Seletores de data rápidos permitem filtrar em intervalos de datas predefinidos, como na semana passada, no mês passado, no ano passado e muito mais.
  • Você pode definir intervalos de datas padrão ao criar filtros de data.
  • Você também pode usar filtros de consulta em painéis. Por padrão, o widget de filtro aparece ao lado de cada visualização em que o filtro foi adicionado à consulta. Para vincular os widgets de filtro a um filtro de consulta no nível do painel, confira Filtros de painel.

Descrição da funcionalidade

Depois de executar uma consulta, no painel Resultados, clique em + e selecione Filtrar.

O botão +Adicionar filtro abre um menu pop-up em que você pode aplicar os filtros e configurações a seguir.

  • Coluna: a coluna à qual aplicar o filtro.
    • No momento, há suporte para cadeias de caracteres, números e datas.
    • Se a coluna selecionada contiver datas, os usuários poderão optar por especificar uma compartimentalização de tempo por data, mês ou ano.
  • Tipo: o tipo de filtro a ser aplicado
    • Seleção Única: filtrar apenas para um valor de campo
    • Seleção Múltipla: filtrar para vários valores de campo
    • Entrada de texto: insira uma cadeia de caracteres para pesquisar valores correspondentes em uma coluna específica. Dá suporte a "Contains", "Exact Match" e "Starts With"
    • Seletor de data/hora e seletor de intervalo: capacidade de selecionar uma data ou um intervalo de datas para filtrar em tipos de dados de data
  • Ordem de Classificação: a ordem na qual os valores são classificados para a lista suspensa do filtro. Você pode escolher entre "Crescente" ou "Decrescente".
  • Realçar valores relevantes (s/n): habilite para ver quais seleções dentro de um filtro retornarão os resultados dadas outras seleções de filtro. Por exemplo, considere um usuário que tenha os filtros "Estado" e "Cidade". Se um usuário optar por realçar valores relevantes, selecionar "Califórnia" no filtro de estado realçará o conjunto de opções disponíveis no filtro "Cidade" para mostrar apenas cidades na Califórnia, enquanto as opções não realçadas serão colocadas em uma opção de menu "Filtrado" na lista suspensa. Observe que isso requer a execução de uma consulta sempre que um filtro é atualizado.
  • Valor padrão: quando uma coluna de tipo "data" é selecionada e um valor de tempo compartimentado é escolhido (dias, meses ou anos), os usuários também podem optar por definir um intervalo de data padrão para o filtro. O filtro padrão é aplicado automaticamente sempre que a consulta é atualizada.

Limitações

  • É importante observar que os filtros de consulta são aplicados na totalidade do conjunto de dados. No entanto, o seletor suspenso para filtros de consulta é limitado a valores exclusivos de 64 mil. Se um usuário quiser filtrar em situações em que há mais de 64 mil valores de filtro exclusivos, é recomendável usar um parâmetro Text.
  • Os filtros só podem ser aplicados a colunas retornadas por uma consulta, não em todas as colunas de uma tabela referenciada.
  • Os filtros exibem a lista distinta de opções da coluna designada nos resultados retornados. Se os resultados forem limitados (por exemplo, uma consulta executada com o Limitar a 1.000), um filtro exibirá apenas valores exclusivos incluídos nesses 1.000 resultados.
  • Embora os filtros aplicados a uma consulta otimizem a execução no lado do cliente ou do servidor para aprimorar o desempenho, os filtros aplicados a um painel sempre serão executados no lado do servidor.