שאילתות GraphQL

שאילתות GraphQL משמשות לאחזור נתונים דרך ממשק ה-API של הפרויקט.

מנוע GraphQL של Archie Core יוצר שאילתות אוטומטית כחלק מסכמת GraphQL בהתבסס על טבלאות הפרויקט שלך. ניתן לשאול את כל טבלאות הפרויקט דרך נקודת הקצה של הפרויקט.

שאילתות שנוצרות אוטומטית

בכל פעם שמוסיפים טבלה לפרויקט, נוצרות אוטומטית שתי פעולות שאילתת GraphQL לטבלה. הן:

• tableNameById(…) - מקבלת id וכל ערך ייחודי כפרמטר לאחזור רשומה אחת ממסד הנתונים.
• tableNames(…) - מקבלת filter, sort, skip, after, before, first, groupBy ו-last לאחזור רשימת רשומות נבחרות עם תמיכה בעימוד, סינון יחסי, מיון ועוד.

פרמטרי רשימה

Archie Core מגיב לפרמטרי השאילתה הבאים בעת ציונם לרשימות.

• filter: סינון רשומות בהתבסס על ערכי שדה.
• orderBy: [מושהה - השתמש ב-sort]
• sort: הגדרת סדר המיון. יכול להיות מיון בשדה אחד או מרובה.
• first: הגבלת השאילתה ל-N רשומות הראשונות. הערך ברירת המחדל והמקסימלי הוא 5000.
• last: החזרת N הרשומות האחרונות מהתוצאה.
• groupBy: קיבוץ הרשומות המוחזרות לפי ערכי שדה מסוים. משמש בדרך כלל יחד עם פונקציות צבירה (כגון count או sum) לניתוח נתונים בהתבסס על קטגוריות.
• after: החזרת רשומות אחרי המזהה שצוין. משמש לעימוד מבוסס מצביע.
• before: החזרת רשומות לפני המזהה שצוין. משמש לעימוד מבוסס מצביע.
• skip: דילוג על N רשומות מהתוצאה.