مشاركة عبر

الوصول إلى موارد IBM DB2 وإدارتها باستخدام Azure Logic Apps

  • مقالة

التطبيق على:Azure Logic Apps (Consumption)

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

توضح هذه المقالة كيف يمكنك إنشاء تطبيق منطقي ينفذ عمليات قاعدة بيانات مختلفة. إذا كنت حديث العهد بالتطبيقات المنطقية، فراجع ما هي تطبيقات Azure Logic؟

الأنظمة الأساسية والإصدارات المدعومة

يتضمن موصل DB2 عميل Microsoft يتصل بخوادم DB2 البعيدة عبر شبكة TCP/IP. يمكنك استخدام هذا الموصل للوصول إلى قواعد البيانات السحابية مثل IBM DB2 لنظام التشغيل Windows الذي يعمل في ظاهرية Azure. يمكنك أيضا الوصول إلى قواعد بيانات DB2 المحلية بعد تثبيت بوابة البيانات المحلية وإعدادها.

يدعم موصل IBM DB2 هذه الأنظمة الأساسية والإصدارات من IBM DB2 جنبا إلى جنب مع المنتجات المتوافقة مع IBM DB2 التي تدعم إصدارات بنية قاعدة البيانات الارتباطية الموزعة (DRDA) SQL Access Manager (SQLAM) 10 و11:

النظام الأساسي ‏‏الإصدار
IBM DB2 ل z/OS 12, 11.1, 10.1
IBM DB2 ل i 7.3, 7.2, 7.1
IBM DB2 ل LUW 11, 10.5

عمليات قاعدة البيانات المدعومة

يدعم موصل IBM DB2 عمليات قاعدة البيانات هذه، والتي تعين الإجراءات المقابلة في الموصل:

عملية قاعدة البيانات إجراء الموصل
سرد جداول قاعدة البيانات الحصول على الجداول
قراءة صف واحد باستخدام SELECT الحصول على صف
قراءة كافة الصفوف باستخدام SELECT الحصول على صفوف
إضافة صف واحد باستخدام INSERT ‏‏إدراج صف
تحرير صف واحد باستخدام UPDATE تحديث الصف
إزالة صف واحد باستخدام DELETE حذف الصف

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

  • حساب واشتراك Azure. إذا لم يكن لديك اشتراك، فقم بالتسجيل للحصول على حساب Azure مجاني.

  • قاعدة بيانات IBM DB2، إما مستندة إلى السحابة أو محلية

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

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

إضافة إجراء DB2 - الحصول على الجداول

  1. في مدخل Microsoft Azure، افتح تطبيق المنطق الخاص بك في Logic App Designer، إذا لم يكن مفتوحا بالفعل.

  2. بعد إضافة المشغل، اختر خطوة جديدة.

  3. في مربع البحث، أدخل "db2" كعامل تصفية. على سبيل المثال، ضمن قائمة الإجراءات، حدد هذا الإجراء: الحصول على جداول (معاينة)

    تحديد إجراء

    تتم مطالبتك الآن بتوفير تفاصيل الاتصال لقاعدة بيانات DB2.

  4. اتبع الخطوات لإنشاء اتصالات لقواعد بيانات السحابة أو قواعد البيانات المحلية.

الاتصال ب DB2 السحابي

لإعداد الاتصال، قم بتوفير تفاصيل الاتصال هذه عند مطالبتك، واختر إنشاء، ثم احفظ تطبيق المنطق الخاص بك:

الخاصية المطلوب ‏‏الوصف
الاتصال عبر البوابة المحلية لا ينطبق فقط على الاتصالات المحلية.
اسم الاتصال ‏‏نعم‬ اسم الاتصال الخاص بك، على سبيل المثال، "MyLogicApp-DB2-connection"
الخادم ‏‏نعم‬ رقم منفذ علامة النقطتين للعنوان أو الاسم المستعار لخادم DB2، على سبيل المثال، "myDB2server.cloudapp.net:50000"

ملاحظة: هذه القيمة هي سلسلة تمثل عنوان TCP/IP أو اسما مستعارا، إما بتنسيق IPv4 أو IPv6، متبوعا بنقطتين ورقم منفذ TCP/IP.
قاعدة بيانات ‏‏نعم‬ اسم قاعدة البيانات الخاصة بك

ملاحظة: هذه القيمة هي سلسلة تمثل اسم قاعدة بيانات ارتباطية DRDA (RDBNAM):

- يقبل DB2 ل z/OS سلسلة 16 بايت حيث تعرف قاعدة البيانات بموقع "IBM DB2 ل z/OS".
- يقبل DB2 ل i سلسلة 18 بايت حيث تعرف قاعدة البيانات باسم قاعدة بيانات ارتباطية "IBM DB2 for i".
- يقبل DB2 ل LUW سلسلة 8 بايت.
اسم المستخدم ‏‏نعم‬ اسم المستخدم لقاعدة البيانات

ملاحظة: هذه القيمة هي سلسلة يستند طولها إلى قاعدة بيانات معينة:

- يقبل DB2 ل z/OS سلسلة 8 بايت.
- DB2 ل i يقبل سلسلة 10 بايت.
- يقبل DB2 ل Linux أو UNIX سلسلة 8 بايت.
- يقبل DB2 لنظام التشغيل Windows سلسلة 30 بايت.
كلمة المرور ‏‏نعم‬ كلمة المرور الخاصة بك لقاعدة البيانات

على سبيل المثال:

تفاصيل الاتصال لقواعد البيانات المستندة إلى السحابة

الاتصال ب DB2 المحلي

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

الخاصية المطلوب ‏‏الوصف
الاتصال عبر البوابة المحلية ‏‏نعم‬ ينطبق عندما تريد اتصالا محليا ويعرض خصائص الاتصال المحلي.
اسم الاتصال ‏‏نعم‬ اسم الاتصال الخاص بك، على سبيل المثال، "MyLogicApp-DB2-connection"
الخادم ‏‏نعم‬ رقم منفذ علامة النقطتين للعنوان أو الاسم المستعار لخادم DB2، على سبيل المثال، "myDB2server:50000"

ملاحظة: هذه القيمة هي سلسلة تمثل عنوان TCP/IP أو اسما مستعارا، إما بتنسيق IPv4 أو IPv6، متبوعا بنقطتين ورقم منفذ TCP/IP.
قاعدة بيانات ‏‏نعم‬ اسم قاعدة البيانات الخاصة بك

ملاحظة: هذه القيمة هي سلسلة تمثل اسم قاعدة بيانات ارتباطية DRDA (RDBNAM):

- يقبل DB2 ل z/OS سلسلة 16 بايت حيث تعرف قاعدة البيانات بموقع "IBM DB2 ل z/OS".
- يقبل DB2 ل i سلسلة 18 بايت حيث تعرف قاعدة البيانات باسم قاعدة بيانات ارتباطية "IBM DB2 for i".
- يقبل DB2 ل LUW سلسلة 8 بايت.
المصادقة ‏‏نعم‬ نوع المصادقة لاتصالك، على سبيل المثال، "أساسي"

ملاحظة: حدد هذه القيمة من القائمة، والتي تتضمن أساسي أو Windows (Kerberos).
اسم المستخدم ‏‏نعم‬ اسم المستخدم لقاعدة البيانات

ملاحظة: هذه القيمة هي سلسلة يستند طولها إلى قاعدة بيانات معينة:

- يقبل DB2 ل z/OS سلسلة 8 بايت.
- DB2 ل i يقبل سلسلة 10 بايت.
- يقبل DB2 ل Linux أو UNIX سلسلة 8 بايت.
- يقبل DB2 لنظام التشغيل Windows سلسلة 30 بايت.
كلمة المرور ‏‏نعم‬ كلمة المرور الخاصة بك لقاعدة البيانات
عباره ‏‏نعم‬ اسم بوابة البيانات المحلية المثبتة

ملاحظة: حدد هذه القيمة من القائمة، والتي تتضمن جميع بوابات البيانات المثبتة ضمن اشتراك Azure ومجموعة الموارد.

على سبيل المثال:

تفاصيل الاتصال لقواعد البيانات المحلية

عرض جداول الإخراج

لتشغيل تطبيق المنطق يدويا، على شريط أدوات المصمم، اختر تشغيل. بعد انتهاء تشغيل تطبيق المنطق الخاص بك، يمكنك عرض الإخراج من التشغيل.

  1. من قائمة تطبيقك المنطقي، اختر Overview.

  2. ضمن ملخص، في قسم محفوظات التشغيل، حدد أحدث تشغيل، وهو العنصر الأول في القائمة.

    عرض محفوظات التشغيل

  3. ضمن تشغيل تطبيق المنطق، يمكنك الآن مراجعة الحالة والمدخلات والمخرجات لكل خطوة في تطبيق المنطق الخاص بك. قم بتوسيع إجراء Get tables .

    توسيع الإجراء

  4. لعرض المدخلات، اختر Show raw inputs.

  5. لعرض المخرجات، اختر Show raw outputs.

    تتضمن المخرجات قائمة بالجداول.

    عرض جداول الإخراج

الحصول على صف

لإحضار سجل واحد في جدول قاعدة بيانات DB2، استخدم إجراء الحصول على صف في تطبيق المنطق الخاص بك. يقوم هذا الإجراء بتشغيل عبارة DB2 SELECT WHERE ، على سبيل المثال، SELECT FROM AREA WHERE AREAID = '99999'.

  1. إذا لم يسبق لك استخدام إجراءات DB2 من قبل في تطبيق المنطق، فراجع الخطوات الواردة في قسم إضافة إجراء DB2 - الحصول على الجداول ، ولكن أضف إجراء الحصول على صف بدلا من ذلك، ثم عد إلى هنا للمتابعة.

    بعد إضافة إجراء الحصول على صف ، إليك كيفية ظهور تطبيق المنطق المثال الخاص بك:

    الحصول على إجراء الصف

  2. حدد قيما لكافة الخصائص المطلوبة (*). بعد تحديد جدول، يعرض الإجراء الخصائص ذات الصلة الخاصة بالسجلات في هذا الجدول.

    الخاصية المطلوب ‏‏الوصف
    اسم الجدول ‏‏نعم‬ الجدول الذي يحتوي على السجل الذي تريده، مثل "AREA" في هذا المثال
    معرف المنطقة ‏‏نعم‬ معرف السجل الذي تريده، مثل "99999" في هذا المثال

    لقطة شاشة تعرض إجراء

  3. عند الانتهاء، على شريط أدوات المصمم، اختر حفظ.

عرض صف الإخراج

لتشغيل تطبيق المنطق يدويا، على شريط أدوات المصمم، اختر تشغيل. بعد انتهاء تشغيل تطبيق المنطق الخاص بك، يمكنك عرض الإخراج من التشغيل.

  1. من قائمة تطبيقك المنطقي، اختر Overview.

  2. ضمن ملخص، في قسم محفوظات التشغيل، حدد أحدث تشغيل، وهو العنصر الأول في القائمة.

  3. ضمن تشغيل تطبيق المنطق، يمكنك الآن مراجعة الحالة والمدخلات والمخرجات لكل خطوة في تطبيق المنطق الخاص بك. قم بتوسيع إجراء الحصول على صف .

  4. لعرض المدخلات، اختر Show raw inputs.

  5. لعرض المخرجات، اختر Show raw outputs.

    تتضمن المخرجات الصف المحدد.

    عرض صف الإخراج

الحصول على صفوف

لإحضار جميع السجلات في جدول قاعدة بيانات DB2، استخدم الإجراء Get rows في تطبيق المنطق الخاص بك. يقوم هذا الإجراء بتشغيل عبارة DB2 SELECT ، على سبيل المثال، SELECT * FROM AREA.

  1. إذا لم يسبق لك استخدام إجراءات DB2 من قبل في تطبيق المنطق، فراجع الخطوات الواردة في قسم إضافة إجراء DB2 - الحصول على الجداول ، ولكن أضف إجراء الحصول على الصفوف بدلا من ذلك، ثم عد إلى هنا للمتابعة.

    بعد إضافة الإجراء Get rows ، إليك كيفية ظهور تطبيق المنطق المثال الخاص بك:

    إجراء الحصول على صفوف

  2. افتح قائمة اسم الجدول، ثم حدد الجدول الذي تريده، وهو "المنطقة" في هذا المثال:

    لقطة شاشة تعرض إجراء

  3. لتحديد عامل تصفية أو استعلام للنتائج، اختر إظهار الخيارات المتقدمة.

  4. عند الانتهاء، على شريط أدوات المصمم، اختر حفظ.

عرض صفوف الإخراج

لتشغيل تطبيق المنطق يدويا، على شريط أدوات المصمم، اختر تشغيل. بعد انتهاء تشغيل تطبيق المنطق الخاص بك، يمكنك عرض الإخراج من التشغيل.

  1. من قائمة تطبيقك المنطقي، اختر Overview.

  2. ضمن ملخص، في قسم محفوظات التشغيل، حدد أحدث تشغيل، وهو العنصر الأول في القائمة.

  3. ضمن تشغيل تطبيق المنطق، يمكنك الآن مراجعة الحالة والمدخلات والمخرجات لكل خطوة في تطبيق المنطق الخاص بك. قم بتوسيع الإجراء Get rows .

  4. لعرض المدخلات، اختر Show raw inputs.

  5. لعرض المخرجات، اختر Show raw outputs.

    تتضمن المخرجات كافة السجلات في الجدول المحدد.

    عرض صفوف الإخراج

‏‏إدراج صف

لإضافة سجل واحد إلى جدول قاعدة بيانات DB2، استخدم إجراء إدراج صف في تطبيق المنطق. يقوم هذا الإجراء بتشغيل عبارة DB2 INSERT ، على سبيل المثال، INSERT INTO AREA (AREAID, AREADESC, REGIONID) VALUES ('99999', 'Area 99999', 102).

  1. إذا لم يسبق لك استخدام إجراءات DB2 من قبل في تطبيق المنطق، فراجع الخطوات الواردة في المقطع إضافة إجراء DB2 - الحصول على الجداول ، ولكن أضف إجراء إدراج صف بدلا من ذلك، ثم عد إلى هنا للمتابعة.

    بعد إضافة إجراء إدراج صف ، إليك كيفية ظهور تطبيق المنطق المثال الخاص بك:

    إدراج إجراء صف

  2. حدد قيما لكافة الخصائص المطلوبة (*). بعد تحديد جدول، يعرض الإجراء الخصائص ذات الصلة الخاصة بالسجلات في هذا الجدول.

    في هذا المثال، فيما يلي الخصائص:

    الخاصية المطلوب ‏‏الوصف
    اسم الجدول ‏‏نعم‬ الجدول الذي تريد إضافة السجل إليه، مثل "AREA"
    معرف المنطقة ‏‏نعم‬ معرف المنطقة المراد إضافته، مثل "99999"
    وصف المنطقة ‏‏نعم‬ وصف المنطقة المراد إضافتها، مثل "المنطقة 99999"
    معرف المنطقة ‏‏نعم‬ معرف المنطقة المراد إضافته، مثل "102"

    على سبيل المثال:

    لقطة شاشة تعرض Logic Apps Designer مع الإجراء

  3. عند الانتهاء، على شريط أدوات المصمم، اختر حفظ.

عرض إخراجات صف الإدراج

لتشغيل تطبيق المنطق يدويا، على شريط أدوات المصمم، اختر تشغيل. بعد انتهاء تشغيل تطبيق المنطق الخاص بك، يمكنك عرض الإخراج من التشغيل.

  1. من قائمة تطبيقك المنطقي، اختر Overview.

  2. ضمن ملخص، في قسم محفوظات التشغيل، حدد أحدث تشغيل، وهو العنصر الأول في القائمة.

  3. ضمن تشغيل تطبيق المنطق، يمكنك الآن مراجعة الحالة والمدخلات والمخرجات لكل خطوة في تطبيق المنطق الخاص بك. قم بتوسيع إجراء إدراج صف .

  4. لعرض المدخلات، اختر Show raw inputs.

  5. لعرض المخرجات، اختر Show raw outputs.

    تتضمن المخرجات السجل الذي أضفته إلى الجدول المحدد.

    عرض الإخراج مع الصف المدرج

تحديث الصف

لتحديث سجل واحد في جدول قاعدة بيانات DB2، استخدم إجراء تحديث الصف في تطبيق المنطق الخاص بك. يقوم هذا الإجراء بتشغيل عبارة DB2 UPDATE ، على سبيل المثال، UPDATE AREA SET AREAID = '99999', AREADESC = 'Updated 99999', REGIONID = 102).

  1. إذا لم يسبق لك استخدام إجراءات DB2 من قبل في تطبيق المنطق، فراجع الخطوات الواردة في قسم إضافة إجراء DB2 - الحصول على الجداول ، ولكن أضف إجراء تحديث الصف بدلا من ذلك، ثم عد إلى هنا للمتابعة.

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

    تحديث إجراء الصف

  2. حدد قيما لكافة الخصائص المطلوبة (*). بعد تحديد جدول، يعرض الإجراء الخصائص ذات الصلة الخاصة بالسجلات في هذا الجدول.

    في هذا المثال، فيما يلي الخصائص:

    الخاصية المطلوب ‏‏الوصف
    اسم الجدول ‏‏نعم‬ الجدول الذي يجب تحديث السجل فيه، مثل "AREA"
    معرف الصف ‏‏نعم‬ معرف السجل المراد تحديثه، مثل "99999"
    معرف المنطقة ‏‏نعم‬ معرف المنطقة الجديد، مثل "99999"
    وصف المنطقة ‏‏نعم‬ وصف المنطقة الجديد، مثل "محدث 99999"
    معرف المنطقة ‏‏نعم‬ معرف المنطقة الجديد، مثل "102"

    على سبيل المثال:

    لقطة شاشة تعرض Logic Apps Designer مع إجراء

  3. عند الانتهاء، على شريط أدوات المصمم، اختر حفظ.

عرض مخرجات صف التحديث

لتشغيل تطبيق المنطق يدويا، على شريط أدوات المصمم، اختر تشغيل. بعد انتهاء تشغيل تطبيق المنطق الخاص بك، يمكنك عرض الإخراج من التشغيل.

  1. من قائمة تطبيقك المنطقي، اختر Overview.

  2. ضمن ملخص، في قسم محفوظات التشغيل، حدد أحدث تشغيل، وهو العنصر الأول في القائمة.

  3. ضمن تشغيل تطبيق المنطق، يمكنك الآن مراجعة الحالة والمدخلات والمخرجات لكل خطوة في تطبيق المنطق الخاص بك. قم بتوسيع إجراء تحديث الصف .

  4. لعرض المدخلات، اختر Show raw inputs.

  5. لعرض المخرجات، اختر Show raw outputs.

    تتضمن المخرجات السجل الذي قمت بتحديثه في الجدول المحدد.

    عرض الإخراج مع الصف المحدث

حذف الصف

لحذف سجل واحد من جدول قاعدة بيانات DB2، استخدم إجراء حذف الصف في تطبيق المنطق. يقوم هذا الإجراء بتشغيل عبارة DB2 DELETE ، على سبيل المثال، DELETE FROM AREA WHERE AREAID = '99999'.

  1. إذا لم يسبق لك استخدام إجراءات DB2 من قبل في تطبيق المنطق، فراجع الخطوات الواردة في قسم إضافة إجراء DB2 - الحصول على الجداول ، ولكن أضف إجراء حذف الصف بدلا من ذلك، ثم عد إلى هنا للمتابعة.

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

    حذف إجراء الصف

  2. حدد قيما لكافة الخصائص المطلوبة (*). بعد تحديد جدول، يعرض الإجراء الخصائص ذات الصلة الخاصة بالسجلات في هذا الجدول.

    في هذا المثال، فيما يلي الخصائص:

    الخاصية المطلوب ‏‏الوصف
    اسم الجدول ‏‏نعم‬ الجدول الذي تريد حذف السجل فيه، مثل "AREA"
    معرف الصف ‏‏نعم‬ معرف السجل المراد حذفه، مثل "99999"

    على سبيل المثال:

    لقطة شاشة تعرض Logic Apps Designer مع إجراء

  3. عند الانتهاء، على شريط أدوات المصمم، اختر حفظ.

عرض حذف مخرجات الصف

لتشغيل تطبيق المنطق يدويا، على شريط أدوات المصمم، اختر تشغيل. بعد انتهاء تشغيل تطبيق المنطق الخاص بك، يمكنك عرض الإخراج من التشغيل.

  1. من قائمة تطبيقك المنطقي، اختر Overview.

  2. ضمن ملخص، في قسم محفوظات التشغيل، حدد أحدث تشغيل، وهو العنصر الأول في القائمة.

  3. ضمن تشغيل تطبيق المنطق، يمكنك الآن مراجعة الحالة والمدخلات والمخرجات لكل خطوة في تطبيق المنطق الخاص بك. قم بتوسيع إجراء حذف الصف .

  4. لعرض المدخلات، اختر Show raw inputs.

  5. لعرض المخرجات، اختر Show raw outputs.

    لم تعد المخرجات تتضمن السجل الذي حذفته من الجدول المحدد.

    عرض الإخراج بدون صف محذوف

مرجع الموصل

لمزيد من التفاصيل التقنية حول هذا الموصل، مثل المشغلات والإجراءات والحدود كما هو موضح في ملف Swagger للموصل، راجع الصفحة المرجعية للموصل.

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