MENU
    Tulip Table lekérdezések és aggregációk
    • 08 Jan 2025
    • 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ázat-leké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

    A Static 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

    Testre szabhatja 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

    :::(Figyelmeztetés) (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 meg van adva.

    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

    :::(Figyelmeztetés) (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 akár 100 000 rekordot is támogat egy csatlakozófüggvényen keresztül. 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 kattintva, majd a +Tábla hozzáadása parancsra 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 (Összesítés hozzáadása) gombra kattintva, és rendeljen hozzá egy Aggregáció 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?