Udostępnij za pośrednictwem

Samouczek: praca z rekordami danych przy użyciu interfejsów API wellbore DDMS

  • Artykuł

Użyj interfejsów API usługi Zarządzanie danymi Domain Zarządzanie danymi Services (DDMS) w narzędziu Postman, aby pracować z dobrze danymi w twoim wystąpieniu usługi Azure Data Manager for Energy.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

  • Skonfiguruj narzędzie Postman do korzystania z kolekcji Wellbore DDMS.
  • Skonfiguruj narzędzie Postman do korzystania ze środowiska Wellbore DDMS.
  • Wysyłanie żądań za pośrednictwem narzędzia Postman.
  • Generowanie tokenu autoryzacji.
  • Użyj interfejsów API wellbore DDMS, aby pracować z dobrze rekordami danych.

Aby uzyskać więcej informacji na temat DDMS, zobacz Pojęcia dotyczące DDMS.

Wymagania wstępne

Uzyskiwanie szczegółów wystąpienia usługi Azure Data Manager dla wystąpienia energii

Pierwszym krokiem jest uzyskanie następujących informacji z wystąpienia usługi Azure Data Manager for Energy w witrynie Azure Portal:

Parametr Wartość Przykład
client_id Identyfikator aplikacji (klient) 00001111-aaaa-2222-bbbb-3333cccc4444
client_secret Klucze tajne klienta _fl******************
tenant_id Identyfikator katalogu (dzierżawcy) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
base_url URL https://<instance>.energy.azure.com
data-partition-id Partycje danych <data-partition-name>

Te informacje będą używane w dalszej części tego samouczka.

Konfigurowanie narzędzia Postman

  1. Pobierz i zainstaluj aplikację klasyczną Postman .

  2. Zaimportuj następujące pliki w narzędziu Postman:

    Aby zaimportować pliki:

    1. Wybierz pozycję Importuj w narzędziu Postman.

      Screenshot that shows the Import button in Postman.

    2. Wklej adres URL każdego pliku w polu wyszukiwania.

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

  3. W środowisku Postman zaktualizuj bieżącą wartość przy użyciu informacji z usługi Azure Data Manager, aby uzyskać szczegółowe informacje o wystąpieniu energii:

    1. W narzędziu Postman w menu po lewej stronie wybierz pozycję Środowiska, a następnie wybierz pozycję Wellbore DDMS Environment(Środowisko DDMS Wellbore).

    2. W kolumnie Bieżąca wartość wprowadź informacje z tabeli w sekcji Pobieranie szczegółów wystąpienia usługi Azure Data Manager for Energy w tym samouczku.

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

Wysyłanie przykładowego żądania postman

Kolekcja Postman dla systemu Wellbore DDMS zawiera żądania, których można użyć do interakcji z danymi dotyczącymi studni, studni, dobrze dzienników i dobrze trajektorii w wystąpieniu usługi Azure Data Manager for Energy.

  1. W narzędziu Postman w menu po lewej stronie wybierz pozycję Kolekcje, a następnie wybierz pozycję Wellbore DDMS. W obszarze Konfiguracja wybierz pozycję Pobierz token SPN.

  2. Na liście rozwijanej środowisko w prawym górnym rogu wybierz pozycję Wellbore DDMS Environment.

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

  3. Aby wysłać żądanie, wybierz pozycję Wyślij.

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

  4. Żądanie weryfikuje rzeczywisty kod odpowiedzi interfejsu API względem oczekiwanego kodu odpowiedzi. Wybierz kartę Wyniki testu, aby sprawdzić, czy żądanie zakończyło się powodzeniem, czy niepowodzeniem.

    Oto przykład pomyślnego wywołania narzędzia Postman:

    Screenshot that shows success for a Postman call.

    Oto przykład nieudanego wywołania narzędzia Postman:

    Screenshot that shows failure for a Postman call.

Używanie interfejsów API wellbore DDMS do pracy z rekordami danych

Pomyślne ukończenie żądań Postman opisanych w następujących interfejsach API rozwiązania Wellbore DDMS wskazuje pomyślne pozyskiwanie i pobieranie rekordów dobrze w wystąpieniu usługi Azure Data Manager for Energy.

Utwórz tag prawny, który jest automatycznie dodawany do środowiska wellbore DDMS w celu zapewnienia zgodności danych.

Interfejs API: Konfigurowanie>tworzenia tagu prawnego dla programu WDMS

Metoda: POST

Screenshot that shows the API that creates a legal tag.

Aby uzyskać więcej informacji, zobacz Zarządzanie tagami prawnymi.

Tworzenie rekordu dobrze

Utwórz dobry rekord w wystąpieniu usługi Azure Data Manager for Energy.

Interfejs API: dobrze>utwórz

Metoda: POST

Screenshot that shows the API that creates a well record.

Uzyskiwanie dobrego rekordu

Uzyskaj odpowiednie dane dla wystąpienia usługi Azure Data Manager for Energy.

Api: Well Well>by ID

Metoda: GET

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

Uzyskaj odpowiednie wersje

Pobierz wersje poszczególnych pozyskanych dobrze rekordów w wystąpieniu usługi Azure Data Manager for Energy.

Interfejs API: dobrze dobrze>dostępne wersje

Metoda: GET

Screenshot that shows the API that gets all well versions.

Uzyskiwanie konkretnej dobrze wybranej wersji

Uzyskaj szczegółowe informacje o określonej wersji dla określonego rekordu w wystąpieniu usługi Azure Data Manager for Energy.

Interfejs API: dobrze>określona wersja

Metoda: GET

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

Usuwanie rekordu źródła

Usuń konkretny rekord z wystąpienia usługi Azure Data Manager for Energy.

Interfejs API: Czyszczenie dobrze rekordu>

Metoda: DELETE

Screenshot that shows the API that deletes a well record.

Następny krok

Przeczytaj następujący samouczek, aby dowiedzieć się, jak za pomocą narzędzia wiersza polecenia sdutil załadować dane sejsmiczne do magazynu Seismic:

Samouczek: ładowanie danych do magazynu seismic za pomocą narzędzia sdutil