--- title: "Consultas e agregações em tabelas" slug: "tulip-table-queries-and-aggregations" tags: ["Table Editor", "Tables"] updated: 2026-10-22T10:15:36Z published: 2026-10-22T10:15:36Z canonical: "support.tulip.co/tulip-table-queries-and-aggregations" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Consultas e agregações em tabelas *Saiba como consultar suas tabelas do Tulip e criar agregações acessíveis nos aplicativos do Tulip* **Neste artigo, você aprenderá...** - **Os recursos de consultas e agregações em tabelas** - **Como criar consultas e agregações** - **Como usar consultas e agregações nos Apps** ## Visão geral As consultas e agregações de tabelas permitem que você interaja com as tabelas de maneira dinâmica, filtrando e resumindo seus dados para uso nos aplicativos. Para este artigo, faremos referência à seguinte tabela de **pedidos**, que possui 10 linhas: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_317280187.png) No canto superior direito, você pode ver os botões **“Consultas** ” e **“Agregações”.** Clique em **“Consultas** ” para adicionar uma nova consulta. O exemplo a seguir usa um **filtro** para retornar apenas os registros que ainda **não** foram enviados: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_317280394.png) As agregações são adicionadas acima de uma consulta e são criadas no nível da tabela, assim como as consultas. Clique em **“Agregações”** para criar uma nova agregação. O exemplo a seguir **somará** o campo da tabela **“Quantidade do produto**”: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_317280509.png) ## Consultas Uma consulta permite filtrar e classificar dados em tabelas. As consultas podem usar valores estáticos ou dinâmicos com base nas entradas do aplicativo. ### Filtros Filtre registros comparando uma coluna específica, ou várias colunas, com um **valor estático** ou uma **entrada do aplicativo**. Exemplos de opções de comparação incluem: - é igual a / não é igual a - é nulo / não é nulo - contém / não contém - começa com / não começa com - termina com / não termina com - está em - é maior ou igual a / é menor ou igual a - está depois ou no / está antes ou no **O Valor estático** será definido estaticamente durante a construção da consulta, mas **a Entrada do aplicativo** será configurada no próprio aplicativo. A **Entrada do aplicativo** pode ser configurada como: - Variável - Valor estático - Informações do aplicativo - Registro da tabela do Tulip Agora você pode usar os campos **“Criado em”** e **“Atualizado em”** em consultas de tabela. ### Classificação Personalize a exibição dos registros configurando a opção **“Ordenar** ”. Exemplos incluem: - A a Z / Z a A - 0 a 9 / 9 a 0 ### Limites O número máximo de registros retornados por uma consulta. - Padrão: 1.000 - Máximo: 1.000 :::(Aviso) (Comportamento ao atingir o limite) Se houver mais records em sua tabela que correspondam aos filtros da consulta (ou, de modo geral, caso você não configure nenhum filtro) do que o limite, apenas o número especificado pelo limite será incluído no resultado da consulta. Se a consulta incluir uma ordenação, serão incluídos os primeiros records de acordo com essa ordenação. ::: ### Teste Após configurar a consulta definindo as opções Filtro, Ordenação e Limite, a consulta pode ser testada diretamente na Tabela clicando em **Testar**. Isso simulará o que a consulta retornaria em um aplicativo. ### Usar consultas em aplicativos Para adicionar uma consulta a um aplicativo, primeiro adicione a tabela ao aplicativo clicando na guia Registros e, em seguida, **em +Adicionar tabela.** Em seguida, clique em **Consulta**. Na janela modal que aparecer, atribua um **Nome** à consulta e, se for o caso, configure a Entrada do aplicativo associada ao filtro. Neste exemplo, veja a consulta **“Produtos não enviados”:** ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_321447212.png) Agora que a consulta está configurada no aplicativo, incorpore uma **Tabela Interativa** e selecione a **fonte de dados** como sendo a consulta. A tabela incorporada exibirá os resultados da consulta. Neste exemplo, há três registros retornados que atendem ao filtro, em que**“Enviado” é igual a “Não”:** ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_321454203.png) ## Agregações Agregações são valores de resumo aplicados às consultas e podem calcular um dos seguintes valores para uma coluna específica: **Média*** Retorna a média de números ou inteiros **Contagem*** Retorna a contagem de registros; não é necessário especificar um campo **Máx.*** Retorna o valor máximo de números ou inteiros **Mín.*** Retorna o mínimo de números ou inteiros **Moda*** Retorna o valor mais comum* *Observação: se dois valores tiverem a mesma frequência, o valor menor será sempre retornado.* **Soma*** Retorna a soma de números ou inteiros **Valores únicos*** Retorna uma matriz com os valores únicos individuais da consulta fornecida, de qualquer tipo de dados ### Limites As agregações podem considerar no máximo 1.000 registros. As agregações são realizadas nos registros retornados pela consulta configurada. O limite definido para a consulta pai de uma agregação também se aplica à agregação (1.000 registros). Uma agregação pode apresentar resultados inesperados se a tabela tiver mais registros para os filtros especificados do que o limite e o usuário não estiver ciente do limite da consulta. Se você **precisar agregar mais de 1.000 registros** para uso em um aplicativo, use o endpoint `runAggregation` da API do Tulip, [que suporta até 100.000 registros](/r230/docs/factory-274-release-march-2024), por meio de uma função de conector. Se você precisar apenas **visualizar uma agregação de mais de 1.000 registros**, crie uma [análise de valor único](https://support.tulip.co/docs/template-types#single-number) com o Analytics, que permite agregar todos os registros de uma tabela. ### Use agregações em aplicativos Da mesma forma que uma consulta é adicionada a um aplicativo, adicione uma agregação clicando em **+Adicionar agregação** e atribua um **nome à agregação**. Neste exemplo, a agregação **“Quantidade total de produtos pedidos** ” está sendo executada na consulta que retorna apenas registros que ainda não foram enviados. Por esse motivo, o nome da agregação é **“Quantidade de produtos a serem enviados”:** ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_321454895.png) Para incorporar a agregação em um aplicativo, arraste uma **variável** para dentro do aplicativo e escolha a **fonte de dados** **“Tulip Table Aggregation**”. Em seguida, selecione o **nome da agregação** que foi configurado ao adicioná-la ao aplicativo. Neste exemplo, a agregação **“Soma da Quantidade de Produtos”** foi executada sobre a consulta que retorna registros que precisam ser enviados. Isso retorna um total de 17: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_321456395.png) ### Use agregações na lógica do aplicativo Com as agregações, você tem a capacidade de construir a lógica do aplicativo em torno do valor de uma agregação. Veja um exemplo abaixo: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Tulip%20Table%20Queries%20and%20Aggregations_321442635.png) Observe que as análises **“Single Number”** do Tulip Analytics não estão acessíveis no momento a partir de um aplicativo e não podem ser utilizadas diretamente na lógica do aplicativo. Ao executar uma agregação a partir de uma consulta, você **poderá** utilizar esse valor e, assim, construir a lógica do aplicativo em torno dele. {{snippet.Você encontrou o que estava procurando?}}