Oktatóanyag: A well data records használata Wellbore DDMS API-k használatával

A Postman Wellbore Domain adatkezelés Services (DDMS) API-jaival jól használható adatokkal dolgozhat az Azure Data Manager for Energy példányában.

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

  • Állítsa be a Postmant a Wellbore DDMS-gyűjtemény használatára.
  • Állítsa be a Postmant a Wellbore DDMS-környezet használatára.
  • Kérések küldése a Postmanen keresztül.
  • Hozzon létre egy engedélyezési jogkivonatot.
  • A Wellbore DDMS API-kkal jól használható adatrekordokkal dolgozhat.

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:

Paraméter Érték Példa
client_id Alkalmazás (ügyfél) azonosítója 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
client_secret Ügyfél titkos kódja _fl******************
tenant_id Címtár (bérlő) azonosítója 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
base_url URL-cím https://<instance>.energy.azure.com
data-partition-id Adatpartíciók <data-partition-name>

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ájlokat a Postmanben:

    A fájlok importálása:

    1. Válassza az Importálás a Postmanben lehetőséget.

      Screenshot that shows the Import button in Postman.

    2. Illessze be az egyes fájlok URL-címét a keresőmezőbe.

      Screenshot that shows importing collection and environment files in Postman via URL.

  3. A Postman-környezetben frissítse az Aktuális értéket az Azure Data Manager for Energy-példány adataival:

    1. A Postman bal oldali menüjében válassza a Környezetek, majd a Wellbore DDMS Environment lehetőséget.

    2. Az Aktuális érték oszlopban adja meg az oktatóanyag Az Azure Data Manager for Energy-példány adatainak lekérése szakaszában szereplő táblázat adatait.

    Screenshot that shows where to enter current values in the Wellbore DDMS environment.

Postman-példakérés küldése

A Wellbore DDMS Postman-gyűjteménye olyan kéréseket tartalmaz, amelyek segítségével kezelheti az Azure Data Manager for Energy-példányban lévő kutak, kútfúrások, kútnaplók és kútnaplók adatait.

  1. A Postman bal oldali menüjében válassza a Gyűjtemények, majd a Wellbore DDMS lehetőséget. A Telepítés területen válassza az SPN-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 Wellbore DDMS Environment lehetőséget.

    Screenshot that shows selections for getting an SPN token and choosing an environment.

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

    Screenshot that shows the Send button for a request in Postman.

  4. A kérés ellenőrzi a tényleges API-válaszkódot a várt válaszkóddal szemben. Válassza az Eredmények tesztelése lapot annak megtekintéséhez, hogy a kérés sikeres vagy sikertelen volt-e.

    Íme egy példa egy sikeres Postman-hívásra:

    Screenshot that shows success for a Postman call.

    Íme egy példa egy sikertelen Postman-hívásra:

    Screenshot that shows failure for a Postman call.

Wellbore DDMS API-k használata a kútadatrekordok kezeléséhez

Az alábbi Wellbore DDMS API-kban ismertetett Postman-kérések sikeres végrehajtása azt jelzi, hogy az Azure Data Manager for Energy-példányban sikeres a kútrekordok betöltése és lekérése.

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

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

Módszer: POST

Screenshot that shows the API that creates a legal tag.

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

Kútrekord létrehozása

Hozzon létre egy jól rögzített rekordot az Azure Data Manager for Energy-példányban.

API: Well>Create Well

Módszer: POST

Screenshot that shows the API that creates a well record.

Kútrekord lekérése

Szerezze be az Azure Data Manager for Energy-példány jól rögzített adatait.

API: Jól>az azonosító alapján

Módszer: GET

Screenshot that shows the API that gets a well record by ID.

Jól elérhető verziók lekérése

Szerezze be az egyes betöltött jól betöltött rekordok verzióit az Azure Data Manager for Energy-példányban.

API: Well>Well-verziók

Módszer: GET

Screenshot that shows the API that gets all well versions.

Adott kútverzió lekérése

Az Azure Data Manager for Energy-példányban megismerheti egy adott kútrekord adott verziójának részleteit.

API: Jól>specifikus verzió

Módszer: GET

Screenshot that shows the API that gets a specific well version.

Kútrekord törlése

Töröljön egy adott kútrekordot az Azure Data Manager for Energy-példányból.

API: Well Record törlése>

Módszer: DELETE

Screenshot that shows the API that deletes a well record.

Következő lépés

Az alábbi oktatóanyagból megtudhatja, hogyan tölthet be szeizmikus adatokat a sdutil parancssori eszközzel a Szeizmikus tárolóba: