Consultas e agregações da tabela Tulip

Objetivo

Aprenda a consultar suas tabelas Tulip e a criar agregações que podem ser acessadas nos aplicativos Tulip

Neste artigo, você aprenderá...

• Os recursos das consultas de tabela
• Como criar consultas e agregações
• Como usar consultas e agregações em aplicativos

Visão geral das consultas de tabela e agregações de tabela

Com as consultas de tabela e as agregações de tabela, você pode consultar e filtrar dinamicamente as tabelas Tulip nos aplicativos.

Para este artigo, faremos referência à seguinte tabela de pedidos, que tem 10 linhas:

No canto superior direito, você pode ver os botões Queries (Consultas) e Aggregations (Agregações). Clique em Queries (Consultas ) para adicionar uma nova consulta.

O exemplo a seguir usa um filtro para retornar apenas os registros que não foram enviados:

As agregações são adicionadas em cima de uma consulta e são criadas no nível da tabela, como as consultas. Clique em Agregações para criar uma nova agregação.

O exemplo a seguir agregará o campo da tabela, Product Quantity:

Opções de consulta

Filtro

Filtre os registros comparando uma coluna específica, ou várias colunas, a um valor estático ou a uma entrada de aplicativo.

Exemplos de opções de comparação incluem:

• igual / não igual
• é 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
• is greater than or equal to / é maior ou igual a / é menor ou igual a
• é depois ou em / é antes ou em

O Static Value será definido estaticamente ao criar a consulta, mas o App Input será configurado no próprio aplicativo. A Entrada de aplicativo pode ser configurada para ser uma:

• Variável
• Valor estático
• Informações do aplicativo
• Registro da tabela Tulip

Agora você pode usar os campos Created At e Updated At em consultas de tabela.

Classificar

Personalize a exibição dos registros, configurando a opção Sort. Os exemplos incluem:

• A a Z / Z a A
• 0 a 9 / 9 a 0

Limite

Coloque um limite na quantidade de registros retornados pela consulta, configurando um limite.

Depois de configurar a consulta definindo as opções Filter (Filtro), Sort (Ordenação) e Limit (Limite), a consulta pode ser testada diretamente na tabela, clicando em Test (Teste). Isso simulará o que a consulta retornaria em um aplicativo.

Opções de agregação

As agregações são valores resumidos que são executados em cima de consultas e podem calcular um dos seguintes valores para uma coluna específica:

• Média
• Contagem
• Máximo
• Mínimo
• Modo
• Soma
• Valores únicos

Uso de consultas e agregações em aplicativos

Como adicionar consultas a aplicativos

Para adicionar uma consulta a um aplicativo, primeiro adicione a tabela ao aplicativo clicando na guia Registros e em +Adicionar tabela. Em seguida, clique em Query (Consulta).

No modal que aparece, dê à consulta um Nome de consulta e, se aplicável, configure a Entrada de aplicativo associada ao filtro. Neste exemplo, veja a consulta Products Not Shipped (Produtos não enviados):

Agora que a consulta está configurada no aplicativo, incorpore uma tabela interativa e selecione a fonte de dados para ser a consulta.

A tabela incorporada exibirá os resultados da consulta. Neste exemplo, há 3 registros retornados que atendem ao filtro,"Shipped" igual a "No":

Adição de agregações a aplicativos

Da mesma forma como uma consulta é adicionada a um aplicativo, adicione uma agregação clicando em +Add Aggregation (Adicionar agregação) e atribua um Aggregation Name (Nome da agregação).

Neste exemplo, a agregação Total Qty Products Ordered está sendo executada na consulta que retorna apenas registros que não foram enviados. Por esse motivo, o nome da agregação é Quantity of Products to be Shipped (Quantidade de produtos a serem enviados):

Para incorporar a agregação em um aplicativo, solte uma variável no aplicativo e escolha a fonte de dados - Agregação de tabela Tulip. Em seguida, selecione o Nome da agregação que foi configurado ao adicionar a agregação ao aplicativo.

Neste exemplo, a Aggregation Sum of Product Quantity foi executada sobre a Query que retorna registros que precisam ser enviados. Isso retorna um total de 17:

Uso de agregações na lógica de aplicativos

Com as agregações, você pode criar uma lógica de aplicativo em torno do valor de uma agregação. Veja um exemplo abaixo:

Observe que o Single Number Tulip Analytics não pode ser acessado atualmente em um aplicativo e não pode ser aproveitado diretamente com a lógica do aplicativo. Ao executar uma agregação em uma consulta, você poderá direcionar esse valor e, assim, criar uma lógica de aplicativo em torno dele.