إضافة رسائل إلى قائمة انتظار تخزين Azure باستخدام الوظائف

  • مقالة

في Azure Functions، توفر روابط الإدخال والإخراج طريقة تعريفية لتوفير البيانات من الخدمات الخارجية للتعليمات البرمجية الخاصة بك. في هذه البداية السريعة، يمكنك استخدام ربط إخراج لإنشاء رسالة في قائمة انتظار عند تشغيل دالة بواسطة طلب HTTP. يمكنك استخدام حاوية تخزين Azure لعرض رسائل قائمة الانتظار التي تقوم الدالة بإنشائها.

المتطلبات الأساسية

لإكمال التشغيل السريع:

إضافة ربط المخرجات

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

  1. في مدخل Azure، افتح صفحة تطبيق الدالة لتطبيق الدالة الذي أنشأته في إنشاء أول دالة من مدخل Azure. من مربع البحث العلوي، ابحث عن Function app وحدده. ثم، حدد تطبيق الوظائف.

  2. حدد تطبيق الوظيفة، ثم حدد الوظيفة التي أنشأتها في تلك البداية السريعة السابقة.

  3. حدد الدمج، و+ إضافة الإخراج.

    Create an output binding for your function.

  4. حدد نوع الربط تخزين قائمة انتظار Azure، ثم أضف الإعدادات كما هو محدد في الجدول الذي يتبع لقطة الشاشة هذه:

    Add a Queue storage output binding to a function in the Azure portal.

    الإعدادات القيمة المقترحة ‏‏الوصف
    اسم معلمة الرسالة outputQueueItem اسم معلمة ربط الإخراج.
    اسم قائمة الانتظار outqueue اسم قائمة الانتظار للاتصال في حساب التخزين الخاص بك.
    تعيين اتصال حساب التخزين AzureWebJobsStorage يمكنك استخدام اتصال حساب التخزين المستخدم بالفعل من قبل تطبيق الدالة الخاص بك، أو إنشاء اتصال جديد.

  5. حدد OK لإضافة الربط.

الآن بعد أن كان لديك ربط إخراج معرف، تحتاج إلى تحديث التعليمات البرمجية لاستخدام الربط لإضافة رسائل إلى قائمة انتظار.

إضافة التعليمات البرمجية التي تستخدم ربط المخرجات

في هذا المقطع، يمكنك إضافة التعليمات البرمجية التي تكتب رسالة إلى قائمة انتظار الإخراج. تتضمن الرسالة القيمة التي تم تمريرها إلى مشغل HTTP في سلسلة الاستعلام. على سبيل المثال، إذا تضمنت سلسلة الاستعلام name=Azure، ستكون رسالة قائمة الانتظار هي اسم التي تم تمريرها إلى الدالة: Azure.

  1. في الدالة الخاصة بك، حدد Code + Test لعرض رمز الدالة في المحرر.

  2. تحديث رمز الدالة استنادًا إلى لغة الدالة:

    إضافة معلمة outputQueueItem إلى توقيع الأسلوب كما هو موضح في المثال التالي.

    public static async Task<IActionResult> Run(HttpRequest req,
    ICollector<string> outputQueueItem, ILogger log)
{
    ...
}

    في نص الدالة قبل عبارة return، قم بإضافة التعليمات البرمجية التي تستخدم المعلمة لإنشاء رسالة قائمة انتظار.

    outputQueueItem.Add("Name passed to the function: " + name);

  3. حدد حفظ لحفظ التغييرات.

اختبار الوظيفة

  1. بعد حفظ تغييرات التعليمات البرمجية، حدد Test.

  2. تأكد من تطابق الاختبار الخاص بك مع الصورة أدناه وحدد تشغيل.

    Test the queue storage binding in the Azure portal.

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

    كبديل لتحديد تشغيل هنا، يمكنك استدعاء الدالة عن طريق إدخال عنوان URL في مستعرض البحث وتحديد القيمة name في سلسلة الاستعلام. يتم عرض أسلوب المستعرض في التشغيل السريع السابق.

  3. تحقق من السجلات للتأكد من نجاح الدالة.

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

البحث عن حساب التخزين المتصل بـ AzureWebJobsStorage

  1. انتقل إلى تطبيق الدالة وحدد التكوين.

  2. ضمن Application settings، حدد AzureWebJobsStorage.

    Screenshot shows the Configuration page with AzureWebJobsStorage selected.

  3. حدد موقع اسم الحساب وقم بتدوينه.

    Locate the storage account connected to AzureWebJobsStorage.

افحص قائمة انتظار الإخراج

  1. في مجموعة الموارد لتطبيق الدالة الخاص بك، حدد حساب التخزين الذي تستخدمه لهذه البداية السريعة.

  2. ضمن خدمة قائمة الانتظار، حدد Queues وحدد قائمة الانتظار باسم outqueue.

    تحتوي قائمة الانتظار على الرسالة التي تربط إخراج قائمة الانتظار التي تم إنشاؤها عند تشغيل الدالة التي تم تشغيلها بواسطة HTTP. إذا قمت باستدعاء الوظيفة بالقيمةname الافتراضية لAzure، فإن رسالة قائمة الانتظار هي الاسم الذي تم تمريره إلى الوظيفة: Azure.

  3. قم بتشغيل الدالة مرة أخرى، وسترى رسالة جديدة تظهر في قائمة الانتظار.

تنظيف الموارد

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

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

أنشأت موارد لإتمام قوالب التشغيل السريع هذه. ستتم محاسبتك على هذه الموارد، اعتمادًا على حالة حسابك و أسعار الخدمة. إذا لم تعد بحاجة إلى الموارد على الإطلاق، فإليك كيفية حذفها:

  1. في بوابة Azure، اذهب إلى صفحة مجموعة الموارد.

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

    Screenshot that shows select the resource group to delete from the function app page.

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

  2. في صفحة مجموعة الموارد، راجع قائمة الموارد المدرجة وتحقق من أنها هي التي تريد حذفها.

  3. حدد حذف مجموعة الموارد واتبع الإرشادات.

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

الخطوات التالية

في هذه البداية السريعة، قمت بإضافة ربط إخراج إلى دالة موجودة. لمزيد من المعلومات حول الربط إلى تخزين قائمة الانتظار، راجع روابط قائمة انتظار Azure Functions Storage.