Kurz: Práce s datovými záznamy pomocí rozhraní API Wellbore DDMS

  • Článek

Pomocí rozhraní API služby Wellbore Domain Správa dat Services (DDMS) v Postmanu můžete pracovat s dobře dostupnými daty ve vaší instanci Azure Data Manageru pro energii.

V tomto kurzu se naučíte:

  • Nastavte Postman tak, aby používal kolekci Wellbore DDMS.
  • Nastavte Postman tak, aby používal prostředí Wellbore DDMS.
  • Odešlete žádosti přes Postman.
  • Vygenerujte autorizační token.
  • Pomocí rozhraní API Wellbore DDMS můžete pracovat s dobře datovými záznamy.

Další informace o DDMS najdete v tématu Koncepty DDMS.

Požadavky

  • Předplatné Azure
  • Instance Azure Data Manageru pro energii vytvořená ve vašem předplatném Azure

Získání podrobností o instanci energie v Azure Data Manageru

Prvním krokem je získání následujících informací z instance Azure Data Manageru pro energii na webu Azure Portal:

Parametr Hodnota Příklad
client_id ID aplikace (klienta) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
client_secret Tajné kódy klienta _fl******************
tenant_id ID adresáře (klienta) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
base_url Adresa URL https://<instance>.energy.azure.com
data-partition-id Datové oddíly <data-partition-name>

Tyto informace použijete později v tomto kurzu.

Nastavení nástroje Postman

  1. Stáhněte a nainstalujte desktopovou aplikaci Postman .

  2. Naimportujte následující soubory v Nástroji Postman:

    Import souborů:

    1. Vyberte Importovat v nástroji Postman.

      Screenshot that shows the Import button in Postman.

    2. Vložte adresu URL každého souboru do vyhledávacího pole.

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

  3. V prostředí Postman aktualizujte aktuální hodnotu informacemi z Azure Data Manageru pro podrobnosti o instanci energie:

    1. V nástroji Postman v nabídce vlevo vyberte Prostředí a pak vyberte Wellbore DDMS Environment.

    2. Ve sloupci Aktuální hodnota zadejte informace z tabulky v části Získání Azure Data Manageru pro podrobnosti o instanci energie v tomto kurzu.

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

Odeslání příkladu požadavku Postman

Kolekce Postman pro Wellbore DDMS obsahuje požadavky, které můžete použít k interakci s daty o wells, wellbores, wellbores, well logs a dobře trajektorii ve vašem Azure Data Manageru pro energii.

  1. V nástroji Postman v nabídce vlevo vyberte Kolekce a pak vyberte Wellbore DDMS. V části Nastavení vyberte Získat token SPN.

  2. V rozevíracím seznamu prostředí v pravém horním rohu vyberte Wellbore DDMS Environment.

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

  3. Pokud chcete žádost odeslat, vyberte Odeslat.

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

  4. Požadavek ověří skutečný kód odpovědi rozhraní API proti očekávanému kódu odpovědi. Vyberte kartu Výsledky testu a podívejte se, jestli žádost proběhla úspěšně nebo selhala.

    Tady je příklad úspěšného volání Postman:

    Screenshot that shows success for a Postman call.

    Tady je příklad neúspěšného volání Postman:

    Screenshot that shows failure for a Postman call.

Použití rozhraní API Wellbore DDMS pro práci s dobře uloženými datovými záznamy

Úspěšné dokončení požadavků Postman popsaných v následujících rozhraních API Wellbore DDMS indikuje úspěšné ingestování a načítání záznamů v instanci Azure Data Manageru pro energii.

Vytvořte právní značku, která se automaticky přidá do vašeho prostředí Wellbore DDMS pro dodržování předpisů dat.

ROZHRANÍ API: Nastavení>vytvoření právní značky pro WDMS

Metoda: POST

Screenshot that shows the API that creates a legal tag.

Další informace najdete v tématu Správa značek z právních důvodů.

Vytvoření záznamu dobře

Vytvořte záznam dobře v instanci Azure Data Manageru pro energii.

ROZHRANÍ API: Well>Create Well

Metoda: POST

Screenshot that shows the API that creates a well record.

Získání záznamu

Získejte dobře zaznamenávaná data pro vaši instanci Azure Data Manageru pro energii.

ROZHRANÍ API: Dobře>podle ID

Metoda: GET

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

Získat dobře dostupné verze

Získejte verze jednotlivých přijatých záznamů v Azure Data Manageru pro energetické instance.

Rozhraní API: Dobře>dostupné verze

Metoda: GET

Screenshot that shows the API that gets all well versions.

Získání konkrétní verze dobře

Získejte podrobnosti o konkrétní verzi konkrétního záznamu v instanci Azure Data Manageru pro energii.

Rozhraní API: Dobře>specifická verze

Metoda: GET

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

Odstranění záznamu kontejneru

Odstraňte konkrétní záznam o kontejneru z vaší instance Azure Data Manageru pro energii.

ROZHRANÍ API: Vyčištění>záznamu well

Metoda: DELETE

Screenshot that shows the API that deletes a well record.

Další krok

V následujícím kurzu se dozvíte, jak pomocí nástroje příkazového řádku sdutil načíst seismická data do Seismic Storu:

Kurz: Použití nástroje sdutil k načtení dat do Seismic Storu