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:
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:
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”:
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”:
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”:**
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, 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 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”:
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:
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:
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?}}