استعلامات GraphQL

تُستخدم استعلامات GraphQL لجلب البيانات عبر واجهة برمجة تطبيقات المشروع.

يقوم محرك 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 سجلات من النتيجة.