Aller au contenu

Requêtes GraphQL

Les requêtes GraphQL sont utilisées pour récupérer des données via l’API du projet.

Le moteur GraphQL d’Archie Core génère automatiquement des requêtes dans le cadre du schéma GraphQL basé sur vos tables de projet. Toutes les tables de projet peuvent être interrogées via le point de terminaison du projet.

Chaque fois qu’une table est ajoutée à un projet, deux opérations de requête GraphQL sont générées automatiquement pour la table. Elles sont :

  • tableNameById(…) - Accepte id et toute valeur unique comme argument pour récupérer un seul enregistrement de la base de données.
  • tableNames(…) - Accepte filter, sort, skip, after, before, first, groupBy et last pour récupérer une liste d’enregistrements sélectionnés tout en prenant en charge la pagination, le filtrage relationnel, le tri, etc.

alt text

Archie Core répond aux arguments de requête suivants lorsqu’ils sont spécifiés pour les listes.

  • filter: Filtre les enregistrements en fonction des valeurs des champs.
  • orderBy: [OBSOLÈTE - Utilisez sort]
  • sort: Configuration de l’ordre de tri. Peut être un tri sur un ou plusieurs champs.
  • first: Limite la requête aux N premiers enregistrements. La valeur par défaut et maximale est 5000.
  • last: Retourne les N derniers enregistrements du résultat.
  • groupBy: Regroupe les enregistrements retournés par les valeurs d’un champ spécifique. C’est généralement utilisé en conjonction avec des fonctions d’agrégation (comme count ou sum) pour analyser les données en fonction de catégories.
  • after: Retourne les enregistrements après l’ID spécifié. Utilisé pour la pagination basée sur le curseur.
  • before: Retourne les enregistrements avant l’ID spécifié. Utilisé pour la pagination basée sur le curseur.
  • skip: Saute N enregistrements du résultat.