Tulip Table lekérdezések és aggregációk
  • 13 May 2024
  • 4 Elolvasandó percek
  • Közreműködők

Tulip Table lekérdezések és aggregációk


Cikk összefoglaló

Cél

Ismerje meg, hogyan kérdezheti le a Tulip táblákat és hogyan készíthet aggregációkat, amelyek a Tulip alkalmazásokon belül elérhetők.

Ebben a cikkben megtanulja...

  • A táblázatlekérdezések képességei
  • Hogyan készítsünk lekérdezéseket és aggregációkat
  • Hogyan használhatók a lekérdezések és aggregációk az alkalmazásokban?

Bevezetés a táblázatlekérdezések és a táblázataggregációk használatába

A Table Queries és Aggregations lehetővé teszi, hogy dinamikus módon lépjen kapcsolatba a Tulip táblákkal, szűrje és összegezze az adatokat az alkalmazásokban való felhasználás céljából.

Ebben a cikkben a következő, 10 sorból álló Rendelések táblázatra fogunk hivatkozni:

A jobb felső sarokban láthatja a lekérdezések és az összesítések gombokat. Kattintson a Lekérdezések gombra egy új lekérdezés hozzáadásához.

A következő példa egy szűrőt használ, hogy csak a még nem szállított rekordokat adja vissza:

Az aggregációkat egy lekérdezés tetején adjuk hozzá, és a lekérdezésekhez hasonlóan táblaszinten épülnek fel. Kattintson az Összesítés gombra egy új összesítés létrehozásához.

A következő példa a termékmennyiség táblázatmezőt fogja összesíteni:

Lekérdezési lehetőségek

Szűrés

A rekordok szűrése egy adott oszlop vagy több oszlop statikus értékkel vagy alkalmazásbemenettel való összehasonlításával.

Példák az összehasonlítási lehetőségekre:

  • egyenlő / nem egyenlő
  • null / nem null
  • tartalmazza / nem tartalmazza
  • kezdődik / nem kezdődik
  • ends with / does not end with
  • benne van
  • nagyobb vagy egyenlő mint / kisebb vagy egyenlő mint / kisebb vagy egyenlő mint
  • utána van vagy van / előtt van vagy van

AStatic Value statikusan lesz beállítva a lekérdezés létrehozásakor, de az App Input magában az alkalmazásban lesz beállítva. Az App Input konfigurálható úgy, hogy a:

  • Változó
  • Statikus érték
  • App Info
  • Tulip Table Record

A Created At és Updated At mezők mostantól használhatók a táblázatkérésekben.

Rendezés

Testreszabhatja a rekordok megjelenítését a Rendezés beállításával. Példák a következőkre:

  • A-tól Z-ig / Z-től A-ig
  • 0-tól 9-ig / 9-től 0-ig

Korlátozás

A lekérdezés által visszaküldött rekordok maximális száma.

  • Alapértelmezett: 1,000
  • Maximum: 1,000
Viselkedés a határértéknél

Ha a lekérdezés szűrőinek megfelelő több rekord van a táblában (vagy összességében, ha nem állít be szűrőket), mint a határérték, akkor csak annyi rekord kerül be a lekérdezés eredményébe, amennyi a határértékben van megadva.

Ha a lekérdezés tartalmaz egy rendezést, akkor a rendezés szerinti első rekordok kerülnek be a lekérdezésbe. :::

Tesztelés

Miután a lekérdezést a szűrő, a rendezés és a korlát beállításával konfiguráltuk, a lekérdezés közvetlenül a Táblán tesztelhető a Tesztelés gombra kattintva. Ez szimulálja, hogy a lekérdezés mit adna vissza egy alkalmazásban.

Összesítés

Az aggregációk olyan összegző értékek, amelyek a lekérdezések tetején futnak, és az alábbi értékek egyikét számolhatják ki egy adott oszlopra:

  • Átlagos
  • Szám
  • Max
  • Min
  • Mode
  • Sum
  • Egyedi értékek

:::(Warning) (Korlátok) Az összesítéseket a beállított Table Query által visszaküldött rekordokon végzik el. Ezért az aggregáció szülő táblázati lekérdezéséhez beállított határértékek az aggregációra is vonatkoznak.

Ez azt jelenti, hogy az aggregációk legfeljebb 1000 rekordot képesek figyelembe venni. Ezért váratlan eredményeket mutathatnak, ha a táblázatban az adott szűrőkhöz több rekord van, mint a határérték, és a felhasználó nincs tudatában a lekérdezési határértéknek.

Ha egy alkalmazásban való felhasználáshoz 1000-nél több rekordot kell aggregálni, akkor a Tulip API runAggregation végpontját használhatja, amely egy csatlakozófüggvényen keresztül legfeljebb 100 000 rekordot támogat. Ha csak több rekord összesítését kell megjelenítenie, akkor a Tulip Analytics segítségével létrehozhat egy Single Value elemzést, amely lehetővé teszi a táblázat összes rekordjának összesítését. :::

A lekérdezések és aggregációk használata az alkalmazásokban

Lekérdezések hozzáadása alkalmazásokhoz

Egy lekérdezés hozzáadásához egy alkalmazáshoz először adja hozzá a táblázatot az alkalmazáshoz a Rekordok lapra és a +Tábla hozzáadása gombra kattintva. Ezután kattintson a Lekérdezés gombra.

A megjelenő modálban adjon a lekérdezésnek egy lekérdezésnevet, és adott esetben konfigurálja a szűrőhöz kapcsolódó alkalmazásbemenetet. Ebben a példában a Products Not Shipped (Nem szállított termékek) lekérdezés:

Most, hogy a lekérdezés be van konfigurálva az alkalmazásban, ágyazzon be egy Interaktív táblázatot, és válassza ki a lekérdezésként szolgáló adatforrást.

A beágyazott táblázat megjeleníti a lekérdezés eredményeit. Ebben a példában 3 olyan rekordot kapunk vissza, amelyek megfelelnek a szűrőnek, a**'Shipped' egyenlő 'No**':

Összesítés hozzáadása alkalmazásokhoz

Hasonlóan ahhoz, ahogyan egy lekérdezés hozzáadódik egy alkalmazáshoz, adjon hozzá egy aggregációt a +Add Aggregation gombra kattintva, és rendeljen hozzá egy aggregációs nevet.

Ebben a példában az Összes megrendelt termékmennyiség összes ítése a lekérdezésen fut, amely csak a még nem szállított rekordokat adja vissza. Emiatt az Aggregáció neve a Szállításra váró termékek mennyisége:

Az aggregáció alkalmazásba való beágyazásához dobjon be egy Változót az alkalmazásba, és válassza az Adatforrás - Tulip Table Aggregation (Tulip Table Aggregáció) lehetőséget. Ezután válassza ki az Aggregáció nevét, amelyet az aggregáció alkalmazáshoz való hozzáadásakor konfigurált.

Ebben a példában a Termékmennyiség összege aggregáció a kiszállításra váró rekordokat visszaadó lekérdezés tetején futott le. Ez összesen 17 darabot ad vissza:

Aggregációk használata az alkalmazáslogikában

Az aggregációkkal lehetőség van arra, hogy az aggregáció értéke köré alkalmazáslogikát építsen. Lásd az alábbi példát:

Felhívjuk figyelmét, hogy az Egyszámos Tulip Analytics jelenleg nem érhető el alkalmazáson belülről, és nem lehet közvetlenül felhasználni alkalmazáslogikával. Ha egy lekérdezésből futtat egy aggregációt, akkor meg tudja célozni ezt az értéket, és így alkalmazáslogikát építhet köré.


Hasznos volt ez a cikk?