Share via

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

  • مقالة

يوفر استيعاب البيان القدرة على استيعاب البيانات في Azure Data Manager لمثيل الطاقة.

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

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

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

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

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

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

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

    المعلمة‬ القيمة المراد استخدامها مثال مكان العثور على هذه القيمة
    CLIENT_ID معرف التطبيق (العميل) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx يمكنك استخدام هذا التطبيق أو معرف العميل عند تسجيل التطبيق مع النظام الأساسي للهويات في Microsoft. راجع تسجيل تطبيق.
    CLIENT_SECRET أسرار العميل _fl****************** يسمى أحيانا كلمة مرور التطبيق، سر العميل هو قيمة سلسلة يمكن لتطبيقك استخدامها بدلا من شهادة للهوية نفسها. راجع إضافة سر عميل.
    TENANT_ID معرف الدليل (المستأجر) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx مرر مؤشر الماوس فوق اسم حسابك في مدخل Microsoft Azure للحصول على الدليل أو معرف المستأجر. بدلا من ذلك، ابحث عن معرف مستأجر خصائص>معرف>Microsoft Entra وحدده في مدخل Microsoft Azure.
    SCOPE معرف التطبيق (العميل) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx هذه القيمة هي نفس معرف التطبيق أو العميل المذكور سابقا.
    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 لاستيعاب البيان على طلبات متعددة يجب تنفيذها بشكل تسلسلي.

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

    Screenshot of the Postman environment.

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

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

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

Screenshot of a successful Postman call.

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

Screenshot of a failed Postman call.

استيعاب بيانات العينة باستخدام Postman

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

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

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

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

  4. تحميل ملف: قم بتنزيل نموذج Wellbore.csv إلى جهازك المحلي. قد يكون أي نوع ملف، بما في ذلك CSV أو LAS أو JSON. حدد هذا الملف في Postman بالنقر فوق الزر Select File .

    Screenshot of uploading a manifest file.

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

  6. الحصول على بيانات تعريف الملف: استدعاء للتحقق من صحة ما إذا تم إنشاء بيانات التعريف بنجاح.

  7. استيعاب بيانات المكون الرئيسي والمرجع ومكون منتج العمل (WPC): استيعاب بيانات تعريف البيان الرئيسي والمرجع ومكون منتج العمل (WPC).

  8. الحصول على حالة سير عمل استيعاب البيان: يبدأ سير العمل وهو في حالة التشغيل . استمر في الاستعلام حتى تتغير الحالة إلى منتهية (عادة من 20 إلى 30 ثانية).

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

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

  1. البحث في منتجات العمل: اتصل بخدمة البحث لاسترداد سجلات بيانات تعريف منتج العمل.
  2. Search Work Product Components: اتصل بخدمة البحث لاسترداد سجلات بيانات تعريف WPC.
  3. البحث عن مجموعة البيانات: اتصل بخدمة البحث لاسترداد سجلات بيانات تعريف مجموعة البيانات.
  4. البحث عن البيانات الرئيسية: اتصل بخدمة البحث لاسترداد سجلات بيانات التعريف الرئيسية.
  5. البحث عن بيانات مرجعية: اتصل بخدمة البحث لاسترداد سجلات بيانات التعريف المرجعية.

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

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

البرنامج التعليمي: استخدام sdutil لتحميل البيانات في Seismic Store

لمزيد من المعلومات حول استيعاب البيان، راجع دليل البدء السريع لتحميل بيانات مشغل OSDU.