أفضل الممارسات لإدارة تجميعات U-SQL في البنية الأساسية لبرنامج ربط العمليات التجارية CI/CD

في هذه المقالة، ستتعلم كيفية إدارة التعليمات البرمجية المصدر لتجميع U-SQL مع مشروع قاعدة بيانات U-SQL المقدم حديثا. يمكنك أيضا معرفة كيفية إعداد البنية الأساسية لبرنامج ربط العمليات التجارية للتكامل والنشر المستمر (CI/CD) لتسجيل التجميع باستخدام Azure DevOps.

هام

تم إيقاف Azure Data Lake Analytics في 29 فبراير 2024. تعرف على المزيد من خلال هذا الإعلان.

بالنسبة لتحليلات البيانات، يمكن لمؤسستك استخدام Azure Synapse Analytics أو Microsoft Fabric.

استخدام مشروع قاعدة بيانات U-SQL لإدارة التعليمات البرمجية المصدر للتجميع

مشروع قاعدة بيانات U-SQL هو نوع مشروع في Visual Studio يساعد المطورين على تطوير قواعد بيانات U-SQL وإدارتها وتوزيعها بسرعة وسهولة. يمكنك إدارة جميع كائنات قاعدة بيانات U-SQL (باستثناء بيانات الاعتماد) باستخدام مشروع قاعدة بيانات U-SQL.

لإدارة التعليمات البرمجية لمصدر تجميع C# وتسجيل التجميع DDL U-SQL النصية، استخدم:

  • مشروع قاعدة بيانات U-SQL لإدارة برامج U-SQL النصية لتسجيل التجميع.
  • مكتبة الفئات (لتطبيق U-SQL) لإدارة التعليمات البرمجية المصدر C# والتبعيات للمشغلين والوظائف والمجمعات المعرفة من قبل المستخدم (UDOs وUDFs وUDAGs).
  • مشروع قاعدة بيانات U-SQL للإشارة إلى مشروع مكتبة الفئة.

يمكن لمشروع قاعدة بيانات U-SQL الرجوع إلى مشروع مكتبة فئات (لتطبيق U-SQL). يمكنك إنشاء تجميعات مسجلة في قاعدة بيانات U-SQL باستخدام التعليمات البرمجية المصدر C# المشار إليها من مشروع مكتبة الفئات (لتطبيق U-SQL).

اتبع هذه الخطوات لإنشاء مشاريع وإضافة مراجع.

  1. إنشاء مشروع مكتبة فئات (لتطبيق U-SQL) عن طريق تحديد ملف>مشروع جديد>. المشروع تحت عقدة Azure Data Lake > U-SQL .

    Data Lake Tools for Visual Studio--Create C# class library project

  2. أضف التعليمات البرمجية C# المعرفة من قبل المستخدم في مشروع مكتبة الفئات (لتطبيق U-SQL).

  3. إنشاء مشروع U-SQL عن طريق تحديد ملف>مشروع جديد>. المشروع تحت عقدة Azure Data Lake>U-SQL .

    Data Lake Tools for Visual Studio-- إنشاء مشروع قاعدة بيانات U-SQL

  4. أضف مرجعا إلى مشروع مكتبة فئة C# لمشروع قاعدة بيانات U-SQL.

    Data Lake Tools ل Visual Studio - إضافة مرجع

    Data Lake Tools ل Visual Studio - إضافة مرجع مشروع قاعدة بيانات U-SQL

  5. إنشاء برنامج نصي تجميع في مشروع قاعدة بيانات U-SQL بالنقر بزر الماوس الأيمن فوق المشروع وتحديد إضافة عنصر جديد.

    Data Lake Tools for Visual Studio--Add assembly script

  6. افتح البرنامج النصي للتجميع في طريقة عرض تصميم التجميع. حدد التجميع المشار إليه من القائمة المنسدلة Create assembly from reference .

    Data Lake Tools for Visual Studio--create assembly from reference

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

@_DeployTempDirectory في نافذة المحرر في الأسفل هو متغير محدد مسبقا يشير الأداة إلى مجلد إخراج البناء. ضمن مجلد إخراج البنية، يحتوي كل تجميع على مجلد فرعي يسمى باسم التجميع. جميع DLLs والملفات الإضافية موجودة في هذا المجلد الفرعي.

إنشاء مشروع قاعدة بيانات U-SQL

إخراج البناء لمشروع قاعدة بيانات U-SQL هو حزمة توزيع قاعدة بيانات U-SQL. تمت تسميتها باللاحقة .usqldbpack. .usqldbpack الحزمة هي ملف .zip يتضمن جميع عبارات DDL في برنامج نصي U-SQL واحد في مجلد DDL. جميع ملفات .dll المضمنة والملفات الإضافية للتجميعات موجودة في المجلد Temp.

توزيع قاعدة بيانات U-SQL

.usqldbpack يمكن نشر الحزمة إما إلى حساب محلي أو حساب Azure Data Lake Analytics. استخدم Visual Studio أو نشر SDK.

نشر قاعدة بيانات U-SQL في Visual Studio

يمكنك نشر قاعدة بيانات U-SQL باستخدام مشروع قاعدة بيانات U-SQL أو حزمة .usqldbpack في Visual Studio.

التوزيع باستخدام مشروع قاعدة بيانات U-SQL

  1. انقر بزر الماوس الأيمن فوق مشروع قاعدة بيانات U-SQL، ثم حدد Deploy.

  2. في معالج Deploy U-SQL Database ، حدد حساب ADLA الذي تريد نشر قاعدة البيانات إليه. يتم دعم كل من الحسابات المحلية وحسابات ADLA.

  3. يتم تعبئة مصدر قاعدة البيانات تلقائيا. يشير إلى حزمة .usqldbpack في مجلد إخراج بناء المشروع.

  4. أدخل اسما في اسم قاعدة البيانات لإنشاء قاعدة بيانات. إذا كانت هناك قاعدة بيانات بهذا الاسم نفسه موجودة بالفعل في حساب Azure Data Lake Analytics الهدف، يتم إنشاء جميع الكائنات المعرفة في مشروع قاعدة البيانات دون إعادة إنشاء قاعدة البيانات.

  5. لنشر قاعدة بيانات U-SQL، حدد إرسال. يتم تحميل جميع الموارد، مثل التجميعات والملفات الإضافية. يتم إرسال مهمة U-SQL التي تتضمن جميع عبارات DDL.

    Data Lake Tools for Visual Studio--Deploy U-SQL database project

    Data Lake Tools for Visual Studio--Deploy U-SQL database project wizard

نشر قاعدة بيانات U-SQL في Azure DevOps

PackageDeploymentTool.exe يوفر واجهات البرمجة وخط الأوامر التي تساعد على نشر قواعد بيانات U-SQL. يتم تضمين SDK في حزمة U-SQL SDK NuGet، الموجودة في build/runtime/PackageDeploymentTool.exe.

في Azure DevOps، يمكنك استخدام مهمة سطر الأوامر وSDK هذه لإعداد البنية الأساسية لبرنامج ربط العمليات التجارية التلقائية لتحديث قاعدة بيانات U-SQL. تعرف على المزيد حول SDK وكيفية إعداد البنية الأساسية لبرنامج ربط العمليات التجارية CI/CD لتوزيع قاعدة بيانات U-SQL.

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