Zum Inhalt springen

GraphQL-Abfragen

GraphQL-Abfragen werden verwendet, um Daten über die Projekt-API abzurufen.

Die GraphQL-Engine von Archie Core generiert automatisch Abfragen als Teil des GraphQL-Schemas basierend auf Ihren Projekttabellen. Alle Projekttabellen können über den Projekt-Endpunkt abgefragt werden.

Wann immer eine Tabelle zu einem Projekt hinzugefügt wird, werden zwei GraphQL-Abfrageoperationen automatisch für die Tabelle generiert. Sie sind:

  • tableNameById(…) - Akzeptiert id und jeden eindeutigen Wert als Argument, um einen einzelnen Datensatz aus der Datenbank abzurufen.
  • tableNames(…) - Akzeptiert filter, sort, skip, after, before, first, groupBy und last, um eine Liste kuratierter Datensätze abzurufen, während Paginierung, relationale Filterung, Sortierung und mehr unterstützt werden.

alt text

Archie Core reagiert auf die folgenden Abfrageargumente, wenn sie für Listen angegeben werden.

  • filter: Filtert Datensätze basierend auf Feldwerten.
  • orderBy: [VERALTET - Verwenden Sie sort]
  • sort: Konfiguration der Sortierreihenfolge. Kann eine Sortierung nach einem oder mehreren Feldern sein.
  • first: Begrenzt die Abfrage auf die ersten N Datensätze. Standard- und Maximalwert ist 5000.
  • last: Gibt die N letzten Datensätze aus dem Ergebnis zurück.
  • groupBy: Gruppiert die zurückgegebenen Datensätze nach den Werten eines bestimmten Feldes. Dies wird typischerweise in Verbindung mit Aggregationsfunktionen (wie count oder sum) verwendet, um Daten basierend auf Kategorien zu analysieren.
  • after: Gibt Datensätze nach der angegebenen ID zurück. Wird für cursorbasierte Paginierung verwendet.
  • before: Gibt Datensätze vor der angegebenen ID zurück. Wird für cursorbasierte Paginierung verwendet.
  • skip: Überspringt N Datensätze aus dem Ergebnis.