إنشاء واجهة برمجة تطبيقات ل GraphQL في Fabric

مكتمل

لإنشاء واجهة برمجة تطبيقات تعمل بكامل طاقتها للوصول إلى بياناتك في Fabric، ابدأ من أي مساحة عمل وحدد عنصر جديد. في اللوحة التي تفتح، ضمن تطوير البيانات، حدد واجهة برمجة التطبيقات ل GraphQL.

بدلا من ذلك، من الصفحة الرئيسية لمدخل Fabric، يمكنك تحديد هندسة البيانات من قائمة أحمال العمل، ثم اختيار واجهة برمجة التطبيقات ل GraphQL. أدخل اسما وحدد Create للحصول على واجهة برمجة تطبيقات تعمل بكامل طاقتها للوصول إلى بياناتك في Fabric.

لقطة شاشة لصفحة واجهة برمجة التطبيقات ل GraphQL في Microsoft Fabric.

بعد ذلك، اتصل بمصدر بيانات عن طريق تحديد تحديد مصدر البيانات. في مربع الحوار اختيار خيار الاتصال، اختر بين تسجيل الدخول الأحادي (SSO) أو بيانات الاعتماد المحفوظة. ثم حدد البيانات التي تريد توصيلها.

لقطة شاشة لصفحة تحديد مصدر البيانات ل GraphQL في Microsoft Fabric.

تعرض صفحة مصدر البيانات جميع العناصر الموجودة في مساحة العمل المتوفرة للاتصال. ثم تحتاج إلى تحديد الكائنات التي تريد كشفها لواجهة برمجة التطبيقات، ثم حدد تحميل.

تمكين العمليات أو تعطيلها

بمجرد تحميل البيانات، يقوم محرك GraphQL تلقائيا بإنشاء الاستعلامات والطفرات لكل عنصر تعرضه.

يمكنك تمكين أو تعطيل استعلامات وطفرات معينة داخل مخطط GraphQL، ما يوفر تحكما دقيقا في الوصول إلى واجهة برمجة التطبيقات واستخدامها. وهذا يعني أنه يمكنك إدارة وظائف واجهة برمجة التطبيقات دون تغيير التعليمات البرمجية أو إعادة التوزيع.

هذا الخيار مفيد لتعطيل الوظائف مؤقتا لأسباب تتعلق بالصيانة أو الأمان أو الأداء، أو للتحكم في عمليات واجهة برمجة التطبيقات استنادا إلى أدوار المستخدم أو المعايير الأخرى.

لقطة شاشة للخاصية لتعطيل استعلام ل GraphQL في Microsoft Fabric.

في هذا المثال، ProductModel الجدول من AdventureWorksLT هو الجدول الوحيد المكشوف. يقوم المحرك تلقائيا بإنشاء الاستعلامات والطفرات اللازمة لعمليات الإدراج والتحديث والحذف.

إشعار

عند تعطيل استعلام أو طفرة، ستؤدي أي محاولات لتنفيذه إلى حدوث خطأ.

إدارة العلاقات

يقدم GraphQL الدعم لعلاقات واحد إلى واحد (1:1) وعلاقة واحد إلى متعدد (1:N) وعلاقات متعدد إلى متعدد (M:N).

  • واحد لواحد (1:1): يرتبط كل مثيل من نوع بمثيل واحد من نوع آخر. على سبيل المثال، قد يكون لنوع المستخدم علاقة واحد لواحد مع نوع ملف تعريف ، حيث يكون لكل مستخدم ملف تعريف واحد بالضبط.

  • واحد إلى متعدد (1:N): يقترن مثيل واحد من نوع واحد بمثيلات متعددة من نوع آخر. على سبيل المثال، قد يكون لنوع المستخدم علاقة واحد لأكثر مع نوع نشر ، حيث يمكن لكل مستخدم الحصول على منشورات متعددة.

  • متعدد إلى متعدد (M:N): ترتبط مثيلات متعددة من نوع واحد بمثيلات متعددة من نوع آخر. على سبيل المثال، قد يكون لنوع الطالب علاقة متعدد إلى متعدد مع نوع الدورة التدريبية ، حيث يمكن لكل طالب التسجيل في دورات تدريبية متعددة، ويمكن أن يكون لكل دورة عدة طلاب.

تمكن هذه العلاقات المطورين من إنشاء نماذج بيانات غنية ومترابطة يمكن الاستعلام فيها بكفاءة.

لقطة شاشة لمربع حوار العلاقة الجديدة ل GraphQL في Microsoft Fabric.