البرنامج التعليمي: العمل مع سجلات بيانات Petrel باستخدام واجهات برمجة تطبيقات Petrel DDMS

استخدم واجهات برمجة تطبيقات Petrel Domain Data Management Services (DDMS) للعمل مع بيانات Petrel في مثيل Azure Data Manager for Energy.

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

  • إنشاء رمز مميز للتخويل.
  • استخدم واجهات برمجة تطبيقات Petrel DDMS للعمل مع سجلات بيانات Petrel ومشاريعها.

لمزيد من المعلومات حول DDMS، راجع مفاهيم DDMS.

Prerequisites

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

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

Parameter القيمة المراد استخدامها Example مكان العثور على هذه القيمة
DNS URI <instance>.energy.azure.com ابحث عن هذه القيمة في صفحة النظرة العامة لمثيل Azure Data Manager for Energy.
data-partition-id Data partition <data-partition-id> ابحث عن هذه القيمة في قسم قسم البيانات داخل مثيل Azure Data Manager for Energy.
access_token قيمة الرمز المميز للوصول 0.ATcA01-XWHdJ0ES-qDevC6r........... اتبع كيفية إنشاء رمز المصادقة لإنشاء رمز مميز للوصول وحفظه.

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

إعداد بيئتك

تأكد من تثبيت cURL النظام الخاص بك لإجراء استدعاءات واجهة برمجة التطبيقات.

استخدام واجهات برمجة تطبيقات Petrel DDMS للعمل مع مشاريع Petrel

يشير إكمال استدعاءات واجهة برمجة التطبيقات الموجودة في swagger بنجاح إلى التفاعل الناجح مع مشاريع Petrel المحفوظة. على الرغم من أن واجهة برمجة التطبيقات توفر طريقة لتحميل البيانات ، إلا أننا نوصي بتحميل مشاريعك عبر DELFI Petrel Project Explorer. تفترض جميع استدعاءات واجهة برمجة التطبيقات التالية أن لديك مشروعا تم تحميله إلى Petrel Project Explorer.

قم بإنشاء علامة قانونية يمكنك استخدامها للامتثال للبيانات.

قم بتشغيل الأمر التالي cURL لإنشاء علامة قانونية:

curl -X POST "https://<DNS>/api/legal/v1/legaltags" \
     -H "Authorization: Bearer <access_token>" \
     -H "Content-Type: application/json" \
     -H "data-partition-id: <data-partition-id>" \
     -d '{
           "name": "LegalTagName",
           "description": "Legal Tag added for Well",
           "properties": {
               "contractId": "123456",
               "countryOfOrigin": ["US", "CA"],
               "dataType": "Third Party Data",
               "exportClassification": "EAR99",
               "originator": "xyz",
               "personalData": "No Personal Data",
               "securityClassification": "Private",
               "expirationDate": "2025-12-25"
           }
       }'

Sample Response:

{
  "name": "LegalTagName",
  "status": "Created"
}

لمزيد من المعلومات، راجع إدارة العلامات القانونية.

إضافة مستخدمين إلى مجموعة استحقاقات

لكي يحصل المستخدمون على الأذونات المناسبة لإجراء استدعاءات واجهة برمجة تطبيقات Petrel DDMS، يجب أن يكونوا جزءا من users.datalake.admins@{data-partition-id}.dataservices.energy مجموعة الاستحقاق. تضيف هذه المكالمة مستخدما إلى المجموعة المناسبة.

المستخدم في هذه الحالة هو معرف العميل أو معرف OID في الرمز المميز المستخدم للمصادقة. على سبيل المثال، إذا قمت بإنشاء رمز مميز باستخدام معرف عميل ، 8cdxxxxxxxxxxxxفيجب عليك الإضافة 8cdxxxxxxxxxxxx إلى المجموعة users.datalake.admins . اتبع دليل إدارة المستخدمين لإضافة الاستحقاقات المناسبة للمستخدم.

احصل على مشروع

استخدم معرف المشروع لإرجاع سجل مشروع Petrel المقابل في مثيل Azure Data Manager for Energy.

API

حذف مشروع

استخدم معرف المشروع لحذف مشروع وبيانات سجل مشروع Petrel المقترن في مثيل Azure Data Manager for Energy.

API

الحصول على إصدار المشروع

استخدم معرف المشروع ومعرف الإصدار للحصول على سجل إصدار Petrel المقترن بالمشروع والإصدار في مثيل Azure Data Manager for Energy.

API

الحصول على عنوان URL لتنزيل المشروع

استخدم معرف المشروع للحصول على عنوان URL لتوقيع الوصول المشترك (SAS) حتى تتمكن من تنزيل بيانات المشروع المقابل من مثيل Azure Data Manager for Energy.

API

الحصول على عنوان URL لتحميل المشروع

استخدم معرف المشروع للحصول على عنواني URL SAS. يقوم عنوان URL واحد بتحميل البيانات إلى المشروع المقابل في مثيل Azure Data Manager for Energy. يقوم عنوان URL الآخر بتنزيل البيانات من المشروع المقابل في مثيل Azure Data Manager for Energy.

API

يجب أن يبدو عنوان URL لتحميل SAS مثل هذا المثال:

https://{storage-account}.z15.blob.storage.azure.net/projects/{data-partition-id}/{projectID}.staging/{versionID}?{SAS-token-info}

يمكنك تعديل عنوان URL هذا ليحتوي على اسم ملف البيانات التي تريد تحميلها:

https://{storage-account}.z15.blob.storage.azure.net/projects/{data-partition-id}/{projectID}.staging/{versionID}/{FILENAME}?{SAS-token-info}

يؤدي إجراء PUT استدعاء إلى عنوان URL هذا إلى تحميل محتويات body التخزين كائن ثنائي كبير الحجم ضمن القيمة المتوفرة FILENAME .

تحديث مشروع

استخدم معرف المشروع وعنوان URL لتحميل SAS لتحديث سجل مشروع Petrel في Azure Data Manager for Energy بالقيم الجديدة. يمكنك أيضا تحميل البيانات إلى مشروع إذا كنت تريد ذلك.

API

البحث في المشاريع

يمكنك البحث في مشاريع Petrel باستخدام العديد من الحقول. ترجع المكالمة جميع معرفات المشروع المطابقة. تدعم واجهة برمجة تطبيقات البحث ما يلي:

  • البحث عن النص الكامل في حقول السلسلة.
  • استعلامات النطاق استنادا إلى حقول التاريخ أو الرقمية أو السلسلة.
  • Geospatial search.

API

Related content

استخدم ارتباطات DELFI التالية لقراءة البرامج التعليمية الأخرى التي تتضمن مهام سير عمل Petrel Project Explorer و Petrel:

  • Last updated on