مشاركة عبر

البرنامج التعليمي: تنفيذ استيعاب محلل CSV

  • مقالة

يوفر استيعاب محلل القيم المفصولة بفاصلة (CSV) القدرة على استيعاب ملفات CSV في Azure Data Manager لمثيل الطاقة.

في هذا البرنامج التعليمي، تتعلم كيفية:

  • استيعاب نموذج ملف CSV للبيانات في Azure Data Manager لمثيل الطاقة باستخدام Postman.
  • ابحث عن سجلات بيانات تعريف التخزين التي تم إنشاؤها أثناء استيعاب CSV باستخدام Postman.

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

قبل بدء هذا البرنامج التعليمي، أكمل المتطلبات الأساسية التالية.

الحصول على تفاصيل Azure Data Manager لمثيل الطاقة

  • تحتاج إلى Azure Data Manager لمثيل الطاقة. إذا لم يكن لديك واحد بالفعل، فبادر بإنشاء واحد باتباع الخطوات الواردة في التشغيل السريع: إنشاء Azure Data Manager لمثيل الطاقة.

  • لهذا البرنامج التعليمي، تحتاج إلى المعلمات التالية:

    المعلمة‬ القيمة المراد استخدامها مثال مكان العثور على هذه القيمة
    CLIENT_ID معرف التطبيق (العميل) 00001111-aaaa-2222-bbbb-3333cccc4444 يمكنك استخدام هذا التطبيق أو معرف العميل عند تسجيل التطبيق مع النظام الأساسي للهويات في Microsoft. راجع تسجيل تطبيق.
    CLIENT_SECRET أسرار العميل _fl****************** يسمى أحيانا كلمة مرور التطبيق، سر العميل هو قيمة سلسلة يمكن لتطبيقك استخدامها بدلا من شهادة للهوية نفسها. راجع إضافة سر عميل.
    TENANT_ID معرف الدليل (المستأجر) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx مرر مؤشر الماوس فوق اسم حسابك في مدخل Microsoft Azure للحصول على الدليل أو معرف المستأجر. بدلا من ذلك، ابحث عن معرف مستأجر خصائص>معرف>Microsoft Entra وحدده في مدخل Microsoft Azure.
    SCOPE معرف التطبيق (العميل) 00001111-aaaa-2222-bbbb-3333cccc4444 هذه القيمة هي نفس معرف التطبيق أو العميل المذكور سابقا.
    refresh_token تحديث قيمة الرمز المميز 0.ATcA01-XWHdJ0ES-qDevC6r........... اتبع كيفية إنشاء رمز المصادقة المميز لإنشاء رمز مميز للتحديث وحفظه. تحتاج إلى هذا الرمز المميز للتحديث لاحقا لإنشاء رمز مميز للمستخدم.
    DNS URI <instance>.energy.Azure.com ابحث عن هذه القيمة في صفحة النظرة العامة لمثيل Azure Data Manager for Energy.
    data-partition-id أقسام البيانات <instance>-<data-partition-name> ابحث عن هذه القيمة في صفحة النظرة العامة لمثيل Azure Data Manager for Energy.

اتبع دليل إدارة المستخدمين لإضافة الاستحقاقات المناسبة للمستخدم الذي يقوم بتشغيل هذا البرنامج التعليمي.

إعداد Postman وتنفيذ الطلبات

  1. قم بتنزيل تطبيق Postman لسطح المكتب وتثبيته.

  2. استيراد الملفات التالية إلى Postman:

    لاستيراد متغيرات مجموعة Postman والبيئة، اتبع الخطوات الواردة في استيراد البيانات إلى Postman.

  3. قم بتحديث CURRENT VALUE لبيئة Postman بالمعلومات التي حصلت عليها في تفاصيل Azure Data Manager لمثيل الطاقة.

  4. تحتوي مجموعة Postman لاستيعاب محلل CSV على 10 طلبات يجب تنفيذها بشكل تسلسلي.

    تأكد من اختيار بيئة سير عمل الاستيعاب قبل تشغيل مجموعة Postman.

    Screenshot of the Postman environment.

  5. قم بتشغيل كل طلب عن طريق تحديد الزر Send .

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

فيما يلي مثال لطلب Postman ناجح:

Screenshot of a successful Postman call.

فيما يلي مثال على طلب Postman فاشل:

Screenshot of a failed Postman call.

استيعاب البيانات بشكل جيد باستخدام Postman

لاستيعاب نموذج ملف CSV للبيانات في Azure Data Manager for Energy باستخدام مجموعة Postman، أكمل الخطوات التالية:

  1. الحصول على رمز مميز لوصول المستخدم: إنشاء رمز مميز للمستخدم، والذي سيتم استخدامه لمصادقة المزيد من استدعاءات واجهة برمجة التطبيقات.

  2. إنشاء مخطط: إنشاء مخطط يلتزم بالأعمدة الموجودة في ملف CSV.

  3. الحصول على تفاصيل المخطط: احصل على المخطط الذي تم إنشاؤه في الخطوة السابقة وتحقق من صحته.

  4. إنشاء علامة قانونية: إنشاء علامة قانونية ستتم إضافتها إلى بيانات CSV لأغراض التوافق مع البيانات.

  5. الحصول على عنوان URL موقع لتحميل ملف CSV: احصل على مسار URL الموقع الذي سيتم تحميل ملف CSV إليه.

  6. تحميل ملف CSV: قم بتنزيل عينة Wellbore.csv إلى جهازك المحلي، ثم حدد هذا الملف في Postman بالنقر فوق الزر تحديد ملف .

    Screenshot of uploading a CSV file.

  7. تحميل بيانات تعريف ملف CSV: قم بتحميل معلومات بيانات تعريف الملف، مثل موقع الملف والحقول الأخرى ذات الصلة.

  8. إنشاء سير عمل استيعاب محلل CSV: إنشاء الرسم البياني دورة دورة التوجيه (DAG) لسير عمل استيعاب محلل CSV.

  9. تشغيل سير عمل استيعاب محلل CSV: قم بتشغيل DAG لسير عمل استيعاب محلل CSV.

  10. ابحث عن حالة سير عمل استيعاب محلل CSV الذي تم استيعابه: احصل على حالة تشغيل DAG لموزع CSV.

البحث عن بيانات تم استيعابها جيدا باستخدام Postman

للبحث عن سجلات بيانات تعريف التخزين التي تم إنشاؤها أثناء استيعاب CSV باستخدام مجموعة Postman، أكمل الخطوة التالية:

  • البحث عن سجلات CSV التي تم استيعابها: ابحث عن سجلات CSV التي تم إنشاؤها مسبقا.

    Screenshot of searching ingested CSV records.

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

تقدم إلى البرنامج التعليمي الآتي:

البرنامج التعليمي: تنفيذ استيعاب الملفات المستندة إلى البيان