Salta ai contenuti

Query GraphQL

Le query GraphQL vengono utilizzate per recuperare dati tramite l’API del progetto.

Il motore GraphQL di Archie Core genera automaticamente query come parte dello schema GraphQL basato sulle tabelle del tuo progetto. Tutte le tabelle del progetto possono essere interrogate attraverso l’endpoint del progetto.

Ogni volta che una tabella viene aggiunta a un progetto, due operazioni di query GraphQL vengono generate automaticamente per la tabella. Esse sono:

  • tableNameById(…) - Accetta id e qualsiasi valore univoco come argomento per recuperare un singolo record dal database.
  • tableNames(…) - Accetta filter, sort, skip, after, before, first, groupBy e last per recuperare un elenco di record curati supportando paginazione, filtro relazionale, ordinamento e altro.

alt text

Archie Core risponde ai seguenti argomenti di query quando specificati per le liste.

  • filter: Filtra i record in base ai valori dei campi.
  • orderBy: [OBSOLETO - Usa sort]
  • sort: Configurazione dell’ordine di ordinamento. Può essere un ordinamento a campo singolo o multiplo.
  • first: Limita la query ai primi N record. Il valore predefinito e massimo è 5000.
  • last: Restituisce gli N ultimi record dal risultato.
  • groupBy: Raggruppa i record restituiti in base ai valori di un campo specifico. Questo è tipicamente utilizzato in combinazione con funzioni di aggregazione (come count o sum) per analizzare i dati basati su categorie.
  • after: Restituisce i record dopo l’ID specificato. Utilizzato per la paginazione basata su cursore.
  • before: Restituisce i record prima dell’ID specificato. Utilizzato per la paginazione basata su cursore.
  • skip: Salta N record dal risultato.