التشغيل السريع: الاستجابة لتغييرات قاعدة البيانات في Azure Cosmos DB باستخدام Azure Functions

في هذا التشغيل السريع، يمكنك استخدام Visual Studio Code لإنشاء تطبيق يستجيب لتغييرات قاعدة البيانات في قاعدة بيانات No SQL في Azure Cosmos DB. بعد اختبار التعليمات البرمجية محليا، يمكنك نشرها إلى تطبيق وظائف بلا خادم جديد تقوم بإنشائه قيد التشغيل في خطة Flex Consumption في Azure Functions.

يستخدم مصدر المشروع ملحق Azure Developer CLI (azd) مع Visual Studio Code لتبسيط تهيئة التعليمات البرمجية للمشروع والتحقق منها محليا، بالإضافة إلى نشر التعليمات البرمجية الخاصة بك على Azure. يتبع هذا النشر أفضل الممارسات الحالية لتوزيع وظائف Azure الآمنة والقابلة للتطوير.

هام

بينما يستجيب للتغييرات في قاعدة بيانات Azure Cosmos لا توجد قاعدة بيانات SQL مدعومة لجميع اللغات، فإن سيناريو البدء السريع هذا يحتوي حاليا فقط على أمثلة ل C# وPython وTypeScript. لإكمال هذه البداية السريعة، اختر إحدى هذه اللغات المدعومة في أعلى المقال.

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

• حساب Azure مع اشتراك نشط. أنشئ حساباً مجاناً.

• Visual Studio Code في واحدة من النظم الأساسية المدعومة.

• ملحق Azure Functions للمحرر Visual Studio Code. يتطلب هذا الملحق أدوات Azure Functions الأساسية. عندما لا تكون هذه الأداة متوفرة محليا، يحاول الملحق تثبيتها باستخدام مثبت يستند إلى الحزمة. يمكنك أيضا تثبيت حزمة الأدوات الأساسية أو تحديثها عن طريق التشغيل Azure Functions: Install or Update Azure Functions Core Tools من لوحة الأوامر. إذا لم يكن لديك npm أو Homebrew مثبتا على الكمبيوتر المحلي، فيجب عليك بدلا من ذلك تثبيت Core Tools أو تحديثها يدويا.

• حزمة تطوير .NET 8.0

• ملحق #C لـ Visual Studio Code.

• Node.js 18.x أو أعلى. يمكنك استخدام أمر node --version للتحقق من الإصدار الخاص بك.

• إصدارات Python التي تدعمها دوال Azure. لمزيد من المعلومات، راجع كيفية تثبيت Python.

• ملحق Python لـ Visual Studio Code.

• ملحق Azure Developer CLI ل Visual Studio Code.

تهيئة المشروع

يمكنك استخدام الأمر azd init من لوحة الأوامر لإنشاء مشروع تعليمات برمجية Azure Functions محلي من قالب.

1. في Visual Studio Code، افتح مجلدا أو مساحة عمل تريد إنشاء مشروعك فيها.

2. اضغط على F1 لفتح لوحة الأوامر، وابحث عن الأمر Azure Developer CLI (azd): Initialize App (init)وقم بتشغيله، ثم اختر تحديد قالب.

   قد يكون هناك تأخير طفيف أثناء azd تهيئة المجلد أو مساحة العمل الحالية.

3. عند المطالبة، اختر تحديد قالب، ثم ابحث عن .Azure Functions with Cosmos DB Bindings (.NET)

4. عند المطالبة، أدخل اسم بيئة فريدا، مثل cosmosdbchanges-dotnet.

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

3. عند المطالبة، اختر تحديد قالب، ثم ابحث عن .Azure Functions TypeScript CosmosDB trigger

4. عند المطالبة، أدخل اسم بيئة فريدا، مثل cosmosdbchanges-ts.

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

3. عند المطالبة، اختر تحديد قالب، ثم ابحث عن .Azure Functions Python with CosmosDB triggers and bindings...

4. عند المطالبة، أدخل اسم بيئة فريدا، مثل cosmosdbchanges-py.

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

5. قم بتشغيل هذا الأمر، بناء على نظام التشغيل المحلي الخاص بك، لمنح البرامج النصية للتكوين الأذونات المطلوبة:

   Linux/macOS

   قم بتشغيل هذا الأمر بامتيازات كافية:

   chmod +x ./infra/scripts/*.sh
   

   بالنسبة لنظام التشغيل

   قم بتشغيل هذا الأمر من موجه أوامر Windows:

   pwsh -Command "Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser"
   

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

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

إنشاء موارد Azure

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

1. في Visual Studio Code، اضغط على F1 لفتح لوحة الأوامر، وابحث عن الأمر Azure Developer CLI (azd): Sign In with Azure Developer CLIوقم بتشغيله، ثم قم بتسجيل الدخول باستخدام حساب Azure الخاص بك.

2. اضغط على F1 لفتح لوحة الأوامر، وابحث عن الأمر Azure Developer CLI (azd): Provision Azure resources (provision) وقم بتشغيله لإنشاء موارد Azure المطلوبة:

3. عند مطالبتك في نافذة المحطة الطرفية، قم بتوفير معلمات النشر المطلوبة التالية:

   المطالبة	‏‏الوصف‬
   حدد اشتراك Azure لاستخدامه	اختر الاشتراك الذي تريد إنشاء مواردك فيه.
   معلمة نشر الموقع	منطقة Azure التي يتم فيها إنشاء مجموعة الموارد التي تحتوي على موارد Azure الجديدة. يتم عرض المناطق التي تدعم حاليا خطة استهلاك Flex فقط.
   معلمة النشر vnetEnabled	بينما يدعم القالب إنشاء موارد داخل شبكة ظاهرية، لتبسيط النشر والاختبار، اختر False.

   azd provision يستخدم الأمر استجابتك لهذه المطالبات باستخدام ملفات تكوين Bicep لإنشاء موارد Azure المطلوبة وتكوينها، باتباع أحدث الممارسات:

   • خطة استهلاك Flex وتطبيق الوظائف
   • حساب Azure Cosmos DB
   • Azure Storage (مطلوب) وApplication Insights (مستحسن)
   • نهج الوصول والأدوار لحسابك
   • اتصالات الخدمة إلى الخدمة باستخدام الهويات المدارة (بدلا من سلسلة الاتصال المخزنة)

   تقوم خطافات ما بعد التوفير أيضا بإنشاء ملفlocal.settings.json المطلوب عند التشغيل محليا. يحتوي هذا الملف أيضا على الإعدادات المطلوبة للاتصال بقاعدة بيانات Azure Cosmos DB في Azure.

   تلميح

   في حالة فشل أي خطوات أثناء التوفير، يمكنك إعادة تشغيل azd provision الأمر مرة أخرى بعد حل أي مشكلات.

   بعد اكتمال الأمر بنجاح، يمكنك تشغيل التعليمات البرمجية للمشروع محليا وتشغيله على قاعدة بيانات Azure Cosmos DB في Azure.

تشغيل الدالة محليًا

يتكامل Visual Studio Code مع أدوات Azure Functions Core للسماح لك بتشغيل هذا المشروع على كمبيوتر التطوير المحلي قبل النشر إلى تطبيق الوظائف الجديد في Azure.

1. اضغط على F1 وفي لوحة الأوامر ، ابحث عن الأمر Azurite: Startوقم بتشغيله.

2. لبدء تشغيل الوظيفة محليا، اضغط على F5 أو أيقونة Run and Debug في شريط النشاط على الجانب الأيمن. تعرض لوحة Terminal الإخراج من Core Tools. يبدأ تطبيقك في لوحة الوحدة الطرفية ، ويمكنك رؤية اسم الوظيفة التي تعمل محليا.

   إذا كنت تواجه مشكلة في التشغيل على Windows، فتأكد من عدم تعيين المحطة الطرفية الافتراضية ل Visual Studio Code إلى WSL Bash.

3. مع استمرار تشغيل الأدوات الأساسية في Terminal ، اضغط على F1 وفي لوحة الأوامر ، ابحث عن الأمر NoSQL: Create Item... وقم بتشغيله وحدد كل من document-db قاعدة البيانات والحاوية documents .

4. استبدل محتويات ملف Item.jsonالجديد ببيانات JSON هذه وحدد حفظ:

   {
       "id": "doc1", 
       "title": "Sample document", 
       "content": "This is a sample document for testing my Azure Cosmos DB trigger in Azure Functions."
   } 
   

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

5. عند الانتهاء، اضغط على Ctrl+C في نافذة المحطة الطرفية لإيقاف func.exe عملية المضيف.

راجع الكود (اختياري)

يتم تشغيل الوظيفة استنادا إلى موجز التغيير في قاعدة بيانات Azure Cosmos DB NoSQL. تقوم متغيرات البيئة هذه بتكوين كيفية مراقبة المشغل لموجز التغيير:

• COSMOS_CONNECTION__accountEndpointنقطة نهاية حساب Cosmos DB:
• COSMOS_DATABASE_NAMEاسم قاعدة البيانات المراد مراقبتها:
• COSMOS_CONTAINER_NAMEاسم الحاوية المراد مراقبتها:

يتم إنشاء متغيرات البيئة هذه لك في كل من Azure (إعدادات تطبيق الوظائف) ومحليا (local.settings.json) أثناء العملية azd provision .

يمكنك مراجعة التعليمات البرمجية التي تحدد مشغل Azure Cosmos DB في ملف المشروع CosmosTrigger.cs.

يمكنك مراجعة التعليمات البرمجية التي تحدد مشغل Azure Cosmos DB في ملف المشروع cosmos_trigger.ts.

يمكنك مراجعة التعليمات البرمجية التي تحدد مشغل Azure Cosmos DB في ملف المشروع function_app.py.

بعد مراجعة التعليمات البرمجية للوظيفة والتحقق منها محليا، حان الوقت لنشر المشروع على Azure.

نشر في Azure

يمكنك تشغيل azd deploy الأمر من Visual Studio Code لنشر التعليمات البرمجية للمشروع إلى الموارد المتوفرة بالفعل في Azure.

• اضغط على F1 لفتح لوحة الأوامر ، وابحث عن الأمر Azure Developer CLI (azd): Deploy to Azure (deploy)وقم بتشغيله.

  azd deploy يقوم الأمر بحزم التعليمات البرمجية الخاصة بك ونشرها في حاوية النشر. ثم يتم بدء تشغيل التطبيق وتشغيله في الحزمة المنشورة.

  بعد اكتمال الأمر بنجاح، يتم تشغيل تطبيقك في Azure.

استدعاء الدالة في Azure

1. في Visual Studio Code، اضغط على F1 وفي لوحة الأوامر ابحث عن الأمر Azure: Open in portalوقم بتشغيله ، وحدد Function app، واختر تطبيقك الجديد. سجل الدخول باستخدام حساب Azure الخاص بك، إذا لزم الأمر.

   يفتح هذا الأمر تطبيق الوظائف الجديد في مدخل Microsoft Azure.

2. في علامة التبويب نظرة عامة في الصفحة الرئيسية، حدد اسم تطبيق الوظائف ثم علامة التبويب السجلات .

3. استخدم الأمر NoSQL: Create Item في Visual Studio Code لإضافة مستند مرة أخرى إلى الحاوية كما كان من قبل.

4. تحقق مرة أخرى من تشغيل الوظيفة بواسطة تحديث في الحاوية المراقبة.

إعادة نشر التعليمات البرمجية الخاصة بك

يمكنك تشغيل azd deploy الأمر عدة مرات حسب حاجتك لنشر تحديثات التعليمات البرمجية لتطبيق الوظائف الخاص بك.

إشعار

تتم دائما الكتابة فوق ملفات التعليمات البرمجية المنشورة بواسطة أحدث حزمة نشر.

يتم تخزين استجاباتك الأولية للمطالبات azd وأي متغيرات بيئة تم إنشاؤها بواسطة azd محليا في البيئة المسماة. azd env get-values استخدم الأمر لمراجعة كافة المتغيرات في بيئتك التي تم استخدامها عند إنشاء موارد Azure.

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

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

azd down --no-prompt

إشعار

يرشد --no-promptazd الخيار إلى حذف مجموعة الموارد الخاصة بك دون تأكيد منك.

لا يؤثر هذا الأمر على مشروع التعليمات البرمجية المحلية.

المحتوى ذو الصلة

• سيناريوهات Azure Functions
• خطة استهلاك Flex
• واجهة سطر الأوامر (CLI) لمطور Azure (azd)
• مرجع AZD
• مرجع Azure Functions Core Tools
• التعليمات البرمجية واختبار وظائف Azure محلياً