Zapytania tabelowe i agregacje

Dowiedz się, jak wysyłać zapytania do tabel Tulip i tworzyć agregacje dostępne w aplikacjach Tulip

W tym artykule dowiesz się...

Możliwości zapytań do tabel i agregacji
Jak tworzyć zapytania i agregacje
Jak korzystać z zapytań i agregacji w aplikacjach

Przegląd

Zapytania tabelowe i agregacje umożliwiają dynamiczną interakcję z tabelami poprzez filtrowanie i podsumowywanie danych do wykorzystania w aplikacjach.

W tym artykule będziemy odnosić się do poniższej tabeli zamówień, która zawiera 10 wierszy:

W prawym górnym rogu widoczne są przyciski „Zapytania ” i „Agregacje”. Kliknij przycisk „Zapytania”, aby dodać nowe zapytanie.

W poniższym przykładzie użyto filtra, aby zwrócić tylko te rekordy, które nie zostały jeszcze wysłane:

Agregacje dodaje się do zapytania i tworzy się je na poziomie tabeli, podobnie jak zapytania. Kliknij opcję „Agregacje”, aby utworzyć nową agregację.

W poniższym przykładzie zostanie obliczona suma pola tabeli „Ilość produktu”:

Zapytania

Zapytanie pozwala filtrować i sortować dane w tabelach. W zapytaniach można używać wartości statycznych lub dynamicznych opartych na danych wprowadzanych w aplikacji.

Filtry

Filtruj rekordy, porównując określoną kolumnę lub wiele kolumn z wartością statyczną albo danymi wprowadzonymi w aplikacji.

Przykłady opcji porównania obejmują:

jest równe / nie jest równe
jest null / nie jest null
zawiera / nie zawiera
zaczyna się od / nie zaczyna się od
kończy się na / nie kończy się na
znajduje się w
jest większe lub równe / jest mniejsze lub równe
jest po lub w / jest przed lub w

Wartość statyczna zostanie ustalona statycznie podczas tworzenia zapytania, natomiast dane wejściowe aplikacji zostaną skonfigurowane w samej aplikacji. Dane wejściowe aplikacji można skonfigurować jako:

Zmienna
wartość statyczna
Informacje o aplikacji
rekord w tabeli Tulip

W zapytaniach tabelowych można teraz korzystać z pól „Utworzono” i „Zaktualizowano ”.

Sortowanie

Dostosuj wyświetlanie rekordów, konfigurując opcję „Sortuj ”. Przykłady:

Od A do Z / Od Z do A
Od 0 do 9 / Od 9 do 0

Ograniczenia

Maksymalna liczba rekordów zwracanych przez zapytanie.

Domyślnie: 1 000
Maksymalnie: 1 000

:::(Ostrzeżenie) (Zachowanie przy osiągnięciu limitu)

Jeśli w tabeli znajduje się więcej rekordów records spełniających kryteria filtrów zapytania (lub ogólnie, jeśli nie skonfigurowano żadnych filtrów) niż wynosi limit, w wyniku zapytania uwzględniona zostanie tylko liczba rekordów określona przez limit.

Jeśli zapytanie zawiera sortowanie, uwzględnione zostaną pierwsze records zgodnie z tym sortowaniem.
:::

Test

Po skonfigurowaniu zapytania poprzez ustawienie opcji Filtruj, Sortuj i Limit, zapytanie można przetestować bezpośrednio w tabeli, klikając przycisk Testuj. Spowoduje to symulację wyników, jakie zapytanie zwróciłoby w aplikacji.

Korzystanie z zapytań w aplikacjach

Aby dodać zapytanie do aplikacji, najpierw dodaj tabelę do aplikacji, klikając kartę „Rekordy”, a następnie „+Dodaj tabelę”. Następnie kliknij „Zapytanie ”.

W wyświetlonym oknie modalnym nadaj zapytaniu nazwę oraz, jeśli to konieczne, skonfiguruj dane wejściowe aplikacji powiązane z filtrem. W tym przykładzie zapytanie nosi nazwę „Produkty niewysłane”:

Teraz, gdy zapytanie jest już skonfigurowane w aplikacji, osadź interaktywną tabelę i wybierz to zapytanie jako źródło danych.

Osadzona tabela wyświetli wyniki zapytania. W tym przykładzie zwrócono 3 rekordy spełniające kryteria filtru, gdzie**„Wysłane” jest równe „Nie”:**

Agregacje

Agregacje to wartości podsumowujące obliczane na podstawie zapytań, które mogą obliczać jedną z następujących wartości dla danej kolumny:

Średnia* Zwraca średnią liczb lub liczb całkowitych

Liczba* Zwraca liczbę rekordów; nie jest wymagane żadne pole

Max* Zwraca wartość maksymalną liczb lub liczb całkowitych

Min* Zwraca minimalną wartość liczb lub liczb całkowitych

Moda* Zwraca najczęściej występującą wartość* Uwaga: jeśli dwie wartości mają identyczną częstotliwość, zawsze zwracana jest niższa z nich.

Sum* Zwraca sumę liczb lub liczb całkowitych

Wartości unikalne* Zwraca tablicę poszczególnych unikalnych wartości z danego zapytania, niezależnie od typu danych

Ograniczenia

Agregacje mogą uwzględniać maksymalnie 1 000 rekordów.

Agregacje są wykonywane na rekordach zwróconych przez skonfigurowane zapytanie. Limit ustawiony dla zapytania nadrzędnego agregacji ma również zastosowanie do samej agregacji (1 000 rekordów).

Agregacja może dać nieoczekiwane wyniki, jeśli tabela zawiera więcej rekordów spełniających podane filtry niż wynosi limit, a użytkownik nie jest świadomy ograniczenia zapytania.

Jeśli chcesz zagregować ponad 1 000 rekordów do wykorzystania w aplikacji, użyj punktu końcowego runAggregation interfejsu API Tulip, który obsługuje do 100 000 rekordów, za pośrednictwem funkcji łącznika.

Jeśli chcesz jedynie wizualizować agregację obejmującą ponad 1 000 rekordów, utwórz analizę typu „Single Value” (Pojedyncza wartość) za pomocą narzędzia Analytics, które umożliwia agregację wszystkich rekordów w tabeli.

Korzystanie z agregacji w aplikacjach

Podobnie jak w przypadku dodawania zapytania do aplikacji, dodaj agregację, klikając +Dodaj agregację, a następnie nadaj jej nazwę.

W tym przykładzie agregacja „Total Qty Products Ordered ” jest uruchamiana na zapytaniu, które zwraca wyłącznie rekordy, które nie zostały jeszcze wysłane. Z tego powodu nazwa agregacji brzmi „Quantity of Products to be Shipped”:

Aby osadzić agregację w aplikacji, przeciągnij zmienną do aplikacji i wybierz źródło danych — „Agregacja tabeli Tulip”. Następnie wybierz nazwę agregacji, która została skonfigurowana podczas dodawania agregacji do aplikacji.

W tym przykładzie agregacja „Suma ilości produktów ” została uruchomiona na zapytaniu zwracającym rekordy, które wymagają wysyłki. Zwraca to łączną wartość 17:

Wykorzystanie agregacji w logice aplikacji

Dzięki agregacjom masz możliwość budowania logiki aplikacji w oparciu o wartość agregacji. Zobacz przykład poniżej:

Należy pamiętać, że agregacje Tulip Analytics typu „pojedyncza liczba” nie są obecnie dostępne z poziomu aplikacji i nie można ich bezpośrednio wykorzystać w logice aplikacji. Uruchamiając agregację na podstawie zapytania, będziesz mógł wykorzystać tę wartość, a tym samym zbudować wokół niej logikę aplikacji.