استكشاف أنواع روابط الإدخال والإخراج

مكتمل

الوصول إلى البيانات ومعالجتها هي المهام الرئيسية في العديد من حلول البرمجيات. خذ بعين الاعتبار بعض هذه التصورات:

• يطلب منك تنفيذ طريقة لنقل البيانات الواردة من Azure Blob Storage إلى Azure Cosmos DB.
• تريد نشر الرسائل الواردة في قائمة الانتظار للمعالجة بواسطة مكون آخر في المؤسسة.
• تحتاج خدمتك إلى الحصول على درجات الألعاب من قائمة الانتظار وتحديث لوحة النتائج عبر الإنترنت.

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

ما هو ربط البيانات؟

في وظائف «Azure»، توفر الروابط طريقة تعريفية لربط البيانات بالكود الخاص بك. إنها تجعل من السهل التكامل مع تدفقات البيانات بشكل متناسق في وظيفة ما. يمكنك الحصول على روابط متعددة توفر الوصول إلى عناصر بيانات مختلفة. هذا التكامل قوي لأنه يمكنك الاتصال بمصادر البيانات الخاصة بك دون الحاجة إلى تعليمة برمجية منطق اتصال محدد (مثل اتصالات قاعدة البيانات أو واجهات واجهة برمجة تطبيقات الويب).

أنواع الروابط

هناك نوعان من الروابط التي يمكنك استخدامها مع الوظائف:

• ربط الإدخال - يرتبط بالبيانات المصدر. يمكن لوظيفتنا قراءة البيانات من مصادر الإدخال هذه.

• ربط الإخراج - يرتبط بالبيانات الوجهة. يمكن لوظيفتنا كتابة البيانات بواجهات الإخراج هذه.

توجد أيضًا مُشغلات، وهي أنواع خاصة من روابط الإدخال التي تتسبب في تشغيل الوظيفة. على سبيل المثال، يمكن تكوين إعلام شبكة حدث «Azure» كمشغل. عند حدوث حدث، يتم تشغيل الدالة.

أنواع الروابط المدعومة

يحدد نوع الربط مكان قراءة البيانات أو إرسالها. هناك ربط للاستجابة لطلبات الويب، ومجموعة كبيرة من الروابط للتفاعل مباشرة مع خدمات Azure المختلفة وخدمات الجهات الخارجية.

يمكن استخدام نوع الربط كإدخال أو إخراج أو كليهما. على سبيل المثال، يمكن كتابة الوظيفة لربط إخراج Blob Storage، ولكن يمكن لتحديث Blob Storage أن يشغّل وظيفة أخرى.

تتضمن أنواع الربط الشائعة ما يلي:

• مخزن البيانات الثنائية الكبيرة
• قوائم انتظار ناقل خدمة Azure
• Azure Cosmos DB
• مراكز أحداث Azure
• الملفات الخارجية
• الجداول الخارجية
• نقاط نهاية بروتوكول نقل نص تشعبي

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

خصائص الروابط

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

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

• النوع - يحدد نوع الربط. على سبيل المثال، نوع البيانات أو الخدمة التي تريد التفاعل معها.

• الاتجاه - يشير إلى تدفق بيانات الاتجاه. على سبيل المثال، هل هو ربط إدخال أو إخراج؟

بالإضافة إلى ذلك، تحتاج معظم أنواع الروابط إلى الخاصية الرابعة:

• الاتصال - يوفر اسم مفتاح إعداد التطبيق الذي يحتوي على سلسلة الاتصال. تستخدم الروابط سلاسل الاتصال الصالحة المخزنة في إعدادات التطبيق للاحتفاظ بالأسرار بعيدًا عن رمز الوظيفة. تجعل سلاسل الاتصال التعليمات البرمجية أكثر قابلية للتكوين والأمان.

إنشاء رابط

يتم تعريف الروابط في «JSON». يتم تكوين الربط في ملف تكوين الدالة، والذي يسمى function.json ويعيش في نفس المجلد مثل التعليمات البرمجية للدالة.

دعونا نفحص عينة ربط الإدخال:

    ...
    {
      "name": "headshotBlob",
      "type": "blob",
      "path": "thumbnail-images/{filename}",
      "connection": "HeadshotStorageConnection",
      "direction": "in"
    },
    ...

لإنشاء هذا الربط، نحن:

1. إنشاء ربط في ملف function.json .

2. توفير قيمة name المتغير. في هذا المثال، يحتوي المتغير على بيانات كائن ثنائي كبير الحجم.

3. توفير التخزين type. في المثال السابق، نستخدم Blob Storage.

4. pathقم بتوفير ، الذي يحدد الحاوية واسم العنصر الذي يدخل فيها. الخاصية pathمطلوبة عند استخدام مشغل كائن ثنائي كبير الحجم، ويجب إدخالها في النمط المعروض هنا، باستخدام أقواس معقوفة حول جزء filename في المسار. ينشئ بناء الجملة هذا تعبير ربط يسمح لك بالإشارة إلى اسم الكائن الثنائي كبير الحجم في روابط أخرى، وفي التعليمات البرمجية للدالة. في هذا المثال، سيتم ملء معلمة على الدالة المسماة filename باسم ملف الكائن الثنائي كبير الحجم الذي قام بتشغيل الدالة.

5. connection قم بتوفير اسم إعداد السلسلة المحدد في ملف إعدادات التطبيق. يتم استخدام الاسم كمفتاح للعثور على سلسلة الاتصال للاتصال بحساب التخزين الخاص بك.

6. حدد ك direction in. يقرأ البيانات من الكائن الثنائي كبير الحجم.

يتم استخدام الروابط للربط بالبيانات في وظيفتك. في هذا المثال، استخدمنا ربط إدخال لتوصيل صور المستخدم للمعالجة بواسطة وظيفتنا كصور مصغرة.