Skip to content

Visão Geral do Query Builder

O Query Builder no App Builder permite que você defina e gerencie visualmente consultas de dados sem escrever código. Ele fornece uma forma simples para filtrar, agrupar e classificar dados conectados ao seu aplicativo.

O que você pode fazer

Usando o Query Builder, você pode:

  • Conectar a uma fonte de dados e construir consultas visualmente.
  • Filtrar dados com base em valores de campos usando operadores como equals, contains, greater than, etc.
  • Combinar múltiplas condições com grupos lógicos (AND/OR).
  • Visualizar os resultados da consulta para garantir que a saída corresponda às suas expectativas.
  • Vincular a consulta a componentes de interface do usuário, como grades, listas ou gráficos.

Exibir teste de execução de consulta

Por que é importante

O Query Builder do App Builder elimina a necessidade de sintaxe de consulta manual. Em vez disso, usa uma interface estruturada com arrastar e soltar que reflete seu esquema de dados — ajudando desenvolvedores e designers a refinar conjuntos de dados para suas visualizações com rapidez e precisão.

Caso de uso típico

Um caso de uso comum é filtrar produtos com base em categoria e faixa de preço.

Por exemplo, você pode construir uma consulta que recupere todos os Produtos pertencentes a uma Categoria selecionada (escolhida em um componente Select que lista todas as categorias disponíveis) e filtrá-los por uma faixa de preço unitário definida por dois campos de entrada numéricos.

A representação SQL correspondente seria assim:

SELECT * FROM products 
WHERE categoryId IN (
  SELECT categoryId
  FROM categories
  WHERE categoryId = {{SelectedCategory}} 
) 
AND productId IN (
  SELECT productId
  FROM orderDetails
  WHERE unitPrice >= {{UPFrom}}
  AND unitPrice <= {{UPTo}} 
)

No App Builder, essa lógica pode ser criada visualmente — conectando as entradas SelectedCategory, UPFrom e UPTo como filtros dinâmicos. Quando os usuários interagem com esses componentes, o Query Builder atualiza a visualização de dados em tempo real, mostrando apenas os produtos que correspondem à seleção atual.

Recursos adicionais