Przejdź do głównej zawartości

Zapytania GraphQL

Zapytania GraphQL służą do pobierania danych za pośrednictwem interfejsu API projektu.

Silnik GraphQL Archie Core automatycznie generuje zapytania jako część schematu GraphQL na podstawie tabel projektu. Wszystkie tabele projektu można odpytywać za pośrednictwem punktu końcowego projektu.

Za każdym razem, gdy tabela jest dodawana do projektu, dwie operacje zapytania GraphQL są generowane automatycznie dla tabeli. Są to:

  • tableNameById(…) - Akceptuje id i dowolną unikalną wartość jako argument, aby pobrać pojedynczy rekord z bazy danych.
  • tableNames(…) - Akceptuje filter, sort, skip, after, before, first, groupBy i last, aby pobrać listę wyselekcjonowanych rekordów, obsługując stronicowanie, filtrowanie relacyjne, sortowanie i wiele więcej.

alt text

Archie Core reaguje na następujące argumenty zapytania, gdy są one określone dla list.

  • filter: Filtruje rekordy na podstawie wartości pól.
  • orderBy: [PRZESTARZAŁE - Użyj sort]
  • sort: Konfiguracja kolejności sortowania. Może to być sortowanie po jednym lub wielu polach.
  • first: Ogranicza zapytanie do pierwszych N rekordów. Domyślna i maksymalna wartość to 5000.
  • last: Zwraca N ostatnich rekordów z wyniku.
  • groupBy: Grupuje zwrócone rekordy według wartości określonego pola. Jest to zazwyczaj używane w połączeniu z funkcjami agregującymi (takimi jak count lub sum) w celu analizy danych na podstawie kategorii.
  • after: Zwraca rekordy po określonym identyfikatorze. Używane do stronicowania opartego na kursorze.
  • before: Zwraca rekordy przed określonym identyfikatorem. Używane do stronicowania opartego na kursorze.
  • skip: Pomija N rekordów z wyniku.