Oktatóanyag: Petrel-adatrekordok használata Petrel DDMS API-k használatával

A Postman Petrel Domain adatkezelés Services (DDMS) API-jaival dolgozhat Petrel-adatokkal az Azure Data Manager for Energy példányában.

Ebben az oktatóanyagban az alábbiakkal fog megismerkedni:

A DDMS-ről további információt a DDMS-fogalmakban talál.

Előfeltételek

• Azure-előfizetés
• Az Azure Data Manager for Energy egy példánya, amelyet az Azure-előfizetésben hoztak létre

Az Azure Data Manager for Energy-példány részleteinek lekérése

Az első lépés a következő információk lekérése az Azure Data Manager for Energy-példányból az Azure Portalon:

Ezeket az információkat az oktatóanyag későbbi részében fogja használni.

A Postman beállítása

1. Töltse le és telepítse az asztali Postman alkalmazást.

2. Importálja a következő fájlt a Postmanben: Petrel DDMS Postman gyűjtemény.

3. Hozzon létre egy Postman-környezetet a korábban beszerzett értékek használatával. A környezetnek a következő példához hasonlóan kell kinéznie:

   

Api-kban használandó jogkivonat létrehozása

A Petrel DDMS Postman-gyűjteménye olyan kéréseket tartalmaz, amelyekkel kezelheti a Petrel-projekteket. Emellett egy kérést is tartalmaz az Aktuális Petrel-projektek és -rekordok lekérdezésére az Azure Data Manager for Energy-példányban.

1. A Postman bal oldali menüjében válassza a Gyűjtemények, majd a Petrel DDMS lehetőséget. A Beállítás területen válassza a Jogkivonat lekérése lehetőséget.

2. A jobb felső sarokban található környezet legördülő listájában válassza a Petrel DDMS Environment lehetőséget.

3. A kérés elküldéséhez válassza a Küldés lehetőséget.

Ez a kérés létrehoz egy hozzáférési jogkivonatot, és a jövőbeli kérések engedélyezési módszereként rendeli hozzá.

Jogkivonatot a Postman cURL parancsával vagy egy terminállal is létrehozhat egy tulajdonosi jogkivonat létrehozásához. Használja az Azure Data Manager for Energy-példány értékeit.

      curl --location --request POST 'https://login.microsoftonline.com/{{TENANT_ID}}/oauth2/v2.0/token' \
          --header 'Content-Type: application/x-www-form-urlencoded' \
          --data-urlencode 'grant_type=client_credentials' \
          --data-urlencode 'client_id={{CLIENT_ID}}' \
          --data-urlencode 'client_secret={{CLIENT_SECRET}}' \
          --data-urlencode 'scope={{SCOPE}}'  

A cURL által létrehozott jogkivonat használatához frissítenie access_token kell a Collection változókban a válasz utáni Bearer értékkel.

Petrel DDMS API-k használata Petrel-projektek használatához

Az alábbi Petrel DDMS API-kban leírt Postman-kérések sikeres végrehajtása a mentett Petrel-projektekkel való sikeres interakciót jelzi. Bár az API lehetővé teszi az adatok feltöltését, javasoljuk, hogy töltse fel projektjeit a DELFI Petrel Project Explorer használatával. Az alábbi API-hívások mindegyike feltételezi, hogy egy projektet töltött fel a Petrel Project Explorerbe.

Jogi címke létrehozása

Hozzon létre egy jogi címkét, amely automatikusan hozzáadódik a Petrel DDMS-környezethez az adatmegfelelőség érdekében.

API: Jogi címke létrehozása>a PDS-hez

Módszer: POST

További információ: Jogi címkék kezelése.

Felhasználók hozzáadása jogosultsági csoporthoz

Ahhoz, hogy a felhasználók megfelelő engedélyekkel rendelkezzenek a Petrel DDMS API-hívások indításához, a users.datalake.admins@{data-partition-id}.dataservices.energy jogosultsági csoporthoz kell tartozniuk. Ez a hívás hozzáad egy felhasználót a megfelelő csoporthoz.

Ebben az esetben a felhasználó a hitelesítéshez használt jogkivonat ügyfélazonosítója vagy OID-azonosítója. Ha például egy jogkivonatot az ügyfélazonosító 8cdxxxxxxxxxxxxhasználatával hoz létre, hozzá kell adnia 8cdxxxxxxxxxxxx a users.datalake.admins csoporthoz.

API: Felhasználó hozzáadása a DATALAKE-Rendszergazda-hoz beállítás>

Módszer: POST

Projekt lekérése

A projektazonosítóval visszaadhatja a megfelelő Petrel-projektrekordot az Azure Data Manager for Energy-példányban.

API: Project>Get Project

Módszer: GET

Projektek törlése

Projektazonosító használatával törölhet egy projektet és a kapcsolódó Petrel-projektrekord adatait az Azure Data Manager for Energy-példányban.

API: Projekt>törlése projekt

Módszer: DELETE

Projektverzió lekérése

A projektazonosító és a verzióazonosító segítségével lekérheti a projekthez társított Petrel-verziórekordot az Azure Data Manager for Energy-példányban.

API: Project>Get Project Version

Módszer: GET

Projekt letöltési URL-címének lekérése

A projektazonosítóval lekérheti a közös hozzáférésű jogosultságkód (SAS) URL-címét, hogy letölthesse a megfelelő projekt adatait az Azure Data Manager for Energy-példányból.

API: Project>Get Project Download

Módszer: GET

Projektfeltöltési URL-cím lekérése

Használjon projektazonosítót két SAS-URL-cím lekéréséhez. Egy URL-cím adatokat tölt fel a megfelelő projektbe az Azure Data Manager for Energy-példányban. A másik URL-cím adatokat tölt le a megfelelő projektből az Azure Data Manager for Energy-példányban.

API: Project>Get Signed Upload URL-cím

Módszer: POST

A SAS feltöltési URL-címének a következő példához hasonlóan kell kinéznie:

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

Ezt az URL-címet úgy módosíthatja, hogy tartalmazza a feltölteni kívánt adatok fájlnevét:

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

PUT Ennek az URL-címnek a meghívása feltölti body a blobtároló tartalmát a megadott FILENAME érték alatt.

Egy projekt frissítése

Egy projektazonosítóval és egy SAS-feltöltési URL-címmel frissíthet egy Petrel-projektrekordot az Azure Data Manager for Energy-ben az új értékekkel. Ha szeretné, adatokat is feltölthet egy projektbe.

API: Project>Update Project

Módszer: PUT

Keresés projekteken keresztül

A Petrel-projektekben számos mező használatával kereshet. A hívás visszaadja az összes egyező projektazonosítót. Az API a következőket támogatja:

• Teljes szöveges keresés sztringmezőkön.
• Tartomány lekérdezései dátum, numerikus vagy sztringmezők alapján.
• Térinformatikai keresés.

API: Projektkeresési>projektek

Módszer: POST

Kapcsolódó tartalom

Az alábbi DELFI-hivatkozások segítségével további, Petrel Project Explorer- és Petrel-munkafolyamatokat tartalmazó oktatóanyagokat olvashat:

• A Project Explorer használatának első lépései (slb.com)\
• Projekt megnyitása a Project Explorerben (slb.com)\
• ZGY-adatok feltöltése a Petrelből a DELFI adat-ökoszisztémába (slb.com)\
• ZGY-adatok importálása a DELFI adat-ökoszisztémából a Petrelbe (slb.com)\
• Petrel-projekt mentése a Project Explorerben (slb.com)