Query e aggregazioni della tabella Tulipano

Scopo

Imparare a interrogare le tabelle di Tulip e a costruire aggregazioni accessibili all'interno delle applicazioni Tulip.

In questo articolo imparerete...

• Le funzionalità delle query sulle tabelle
• Come costruire query e aggregazioni
• Come utilizzare le query e le aggregazioni nelle applicazioni

Introduzione alle query e alle aggregazioni di tabelle

Le query e le aggregazioni di tabelle consentono di interagire con le tabelle di Tulip in modo dinamico, filtrando e riassumendo i dati per l'uso nelle applicazioni.

In questo articolo faremo riferimento alla seguente tabella di ordini, che ha 10 righe:

In alto a destra sono presenti i pulsanti Query e Aggregazioni. Fare clic su Query per aggiungere una nuova query.

L'esempio seguente utilizza un filtro per restituire solo i record che non sono stati spediti:

Le aggregazioni si aggiungono a una query e sono costruite a livello di tabella come le query. Fare clic su Aggregazioni per creare una nuova aggregazione.

L'esempio che segue evoca il campo della tabella Quantità di prodotti:

Opzioni di query

Filtro

Filtrare i record confrontando una colonna specifica, o più colonne, con un valore statico o un input dell'applicazione.

Esempi di opzioni di confronto sono:

• uguale / non uguale
• è nullo / non è nullo
• contiene / non contiene
• inizia con / non inizia con
• finisce con / non finisce con
• è in
• è maggiore o uguale a / è minore o uguale a
• è dopo o a / è prima o a

Il valore statico viene impostato staticamente durante la creazione della query, mentre l'input dell'applicazione viene configurato nell'applicazione stessa. L'input dell 'applicazione può essere configurato come una:

• Variabile
• Valore statico
• Informazioni sull'applicazione
• Record della tabella Tulip

È ora possibile utilizzare i campi Created At e Updated At nelle query della tabella.

Ordinamento

È possibile personalizzare la visualizzazione dei record configurando l'opzione Ordinamento. Gli esempi includono:

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

Limite

Il numero massimo di record restituiti da una query.

• Predefinito: 1.000
• Massimo: 1,000

:::(Avviso) (Comportamento al limite)

Se nella tabella ci sono più record che corrispondono ai filtri della query (o complessivamente se non si configura alcun filtro) rispetto al limite, solo il numero specificato dal limite viene incluso nel risultato della query.

Se la query include un ordinamento, verranno inclusi i primi record in base all'ordinamento.
:::

Test

Dopo aver configurato la query impostando le opzioni Filtro, Ordinamento e Limite, la query può essere testata direttamente sulla tabella facendo clic su Test. In questo modo si simulerà ciò che la query restituirà in un'applicazione.

Aggregazioni

Le aggregazioni sono valori di riepilogo che vengono eseguiti in aggiunta alle query e possono calcolare uno dei seguenti valori per una particolare colonna:

• Media
• Numero
• Massimo
• Min
• Modalità
• Somma
• Valori unici

:::(Attenzione) (Limiti) Le aggregazioni vengono eseguite sui record restituiti dalla query di tabella per cui sono configurate. Pertanto, il limite impostato per la query di tabella padre di un'aggregazione si applica anche all'aggregazione.

Ciò significa che le aggregazioni possono considerare un massimo di 1.000 record. Potrebbero quindi mostrare risultati inaspettati se la tabella ha più record per i filtri dati rispetto al limite e l'utente non è a conoscenza del limite della query.

Se è necessario aggregare più di 1.000 record da utilizzare in un'applicazione, è possibile utilizzare l'endpoint runAggregation dell'API Tulip, che supporta fino a 100.000 record, tramite una funzione connettore. Se si ha solo bisogno di visualizzare un'aggregazione di più record, è possibile costruire un'analisi a valore singolo con Tulip Analytics, che consente di aggregare tutti i record in una tabella.
:::

Utilizzo di query e aggregazioni nelle app

Aggiunta di query alle applicazioni

Per aggiungere una query a un'applicazione, aggiungere prima la tabella all'applicazione facendo clic sulla scheda Record e su +Aggiungi tabella. Quindi, fare clic su Query.

Nella finestra di dialogo che appare, assegnare alla query un nome e, se applicabile, configurare l'input dell'app associato al filtro. In questo esempio, si veda la query Prodotti non spediti:

Ora che la query è configurata nell'applicazione, incorporare una tabella interattiva e selezionare la fonte di dati come query.

La tabella incorporata mostrerà i risultati della query. In questo esempio, sono stati restituiti 3 record che soddisfano il filtro**'Spedito' uguale a 'No'**:

Aggiunta di aggregazioni alle applicazioni

Analogamente a come si aggiunge una query a un'applicazione, è possibile aggiungere un'aggregazione facendo clic su +Aggregazione e assegnando un nome all'aggregazione.

In questo esempio, l'aggregazione Qtà totale prodotti ordinati viene eseguita sulla query che restituisce solo i record che non sono stati spediti. Per questo motivo, il nome dell'aggregazione è Quantità di prodotti da spedire:

Per incorporare l'aggregazione in un'applicazione, inserire una variabile nell'applicazione e scegliere Datasource - Tulip Table Aggregation. Quindi, selezionare il nome dell'aggregazione configurato al momento dell'aggiunta dell'aggregazione all'app.

In questo esempio, l'aggregazione Somma di quantità di prodotti è stata eseguita in aggiunta alla query che restituisce i record che devono essere spediti. Il risultato è un totale di 17:

Uso delle aggregazioni nella logica dell'applicazione

Con le aggregazioni, è possibile costruire la logica dell'applicazione intorno al valore di un'aggregazione. Si veda un esempio qui sotto:

Si noti che i dati di Tulip Analytics a numero singolo non sono attualmente accessibili dall'interno di un'applicazione e non possono essere sfruttati direttamente con la logica dell'applicazione. Eseguendo un'aggregazione da una query, si potrà puntare a questo valore e quindi costruire una logica per l'applicazione.